
Configuração da ferramenta e verificação de controle
Substitua a lista de exemplo padrão de duas Páginas por uma URL pública conhecida e pretendida de Página em startUrls para a sua execução piloto.
A build da ferramenta é 0.1.24. Ela aceita startUrls com uma a mil URLs públicas conhecidas de Página ou de perfil, e não páginas de busca nem descoberta por palavra-chave de cidade. Uma linha é uma entrada tentada.
As métricas de saída incluem requestedChannels, acceptedProfileInputs, rejectedInputs, datasetRows, usefulRows, billableRows, nonUsefulRows e statusCounts. Os campos da linha incluem input, channelId, pageId, channelUrl, handle, displayName, alternateName, profileType, description, category, website, detectedLinks, detectedEmails, phone, email, address, profileTabs, status, statusReason, observedAt e isBillable. Campos ausentes são null. channelId e pageId legado ou delegado são valores de identidade distintos e podem diferir.
Uma verificação de controle na NASA retornou IDs correspondidos, status ok, uma descrição e dois links detectados de seções do Facebook. Site, telefone, e-mail e endereço estavam indisponíveis. Isso prova que campos opcionais podem estar indisponíveis, somente nesse controle.
Ações de criação e verificação do diretório
- Defina a finalidade do diretório e os campos obrigatórios antes de coletar. Use uma lista de origem conhecida dos negócios pretendidos, com IDs locais de linha e a procedência de cada URL. A busca por cidade está fora desta ferramenta. A descoberta manual é um pré-requisito explícito, não um recurso prometido.
- Teste uma Página pública pretendida. Confira channelId, pageId, channelUrl, displayName, profileType, status e statusReason em relação à origem. Uma identidade retornada, sozinha, pode ser útil mesmo quando os campos opcionais de Sobre estão ocultos. Não faça a correspondência somente pelo nome quando dois negócios compartilham um nome.
- Preserve as linhas de origem e o horário. Armazene os IDs de perfil como strings e mantenha o ID de Página legado ou delegado em separado. Remova duplicatas das observações de identidade verificada sem descartar a lista de entrada para origem.
- Para cada campo obrigatório, registre source_available, unavailable ou needs_manual_check. Mantenha website distinto de detectedLinks. Um link do Facebook de Sobre ou de fotos é uma seção do perfil, não um site externo do negócio. detectedEmails e detectedLinks são indícios não verificados, não um conjunto completo de contatos do negócio.
- Se o diretório exigir área de atendimento da cidade ou um site externo, inspecione manualmente uma origem pública correspondente do negócio e registre evidência, origem e horário em campos enriquecidos separados. Não substitua um endereço null do Actor por uma cidade adivinhada a partir de um handle. A ferramenta não faz essa verificação do site vinculado.
- Defina a prontidão da linha do diretório para a finalidade declarada. Por exemplo, um índice de identidade precisa de identidade correspondida; um diretório de contatos também precisa de uma via pública de contato inspecionada; uma lista de negócios da cidade precisa, além disso, de relevância local fundamentada. Mantenha cada regra explícita. Dados opcionais ausentes não provam que o negócio não tenha esse atributo.
- Separe os registros em ready, needs_review e unavailable_target. Conte identidades correspondidas, campos disponíveis e registros prontos separadamente. Uma solicitação de origem que falhou não é um registro comercial vazio e bem-sucedido. Guarde os motivos de status da origem para que uma nova tentativa posterior possa ser delimitada.
- Exporte o diretório útil com o motivo de prontidão e os links de evidência. Atualize as observações quando necessário, em vez de afirmar que a ferramenta fornece o histórico passado. Este guia não envia mensagens de abordagem nem certifica negócios.
Exemplo e tabela de ficção original
O texto a seguir é ficção original. Um diretório fictício de negócios de limpeza tem quatro Páginas pretendidas.
| Chave do registro | Identidade correspondida | Status nativo | Site bruto | Endereço bruto | Links detectados | Endereço manual / evidência local | Origem manual e verificação (ficção) | Prontidão do registro segundo o leitor e motivo |
|---|---|---|---|---|---|---|---|---|
| B1 | ID correspondido | ok | https://example.com/b1-site (ficção) | 123 Main St (ficção) | facebook.com/b1/about (ficção) | 123 Main St fictício, Target City, confirmado separadamente a partir da sua origem manual datada | https://example.com/b1-source (2026-03-01, verificação local) | Pronto (ID correspondido, site e endereço nativos presentes, evidência local manual confirmada) |
| B2 | ID correspondido | ok | null | null | facebook.com/b2/photos (ficção) | desconhecido | Nenhuma | Precisa de revisão (ID correspondido, site/endereço nativos null, sem evidência manual) |
| B3 | Sem identidade | login_required | null | null | null | desconhecido | Nenhuma | Alvo indisponível (login necessário, nenhuma identidade recuperada) |
| B4 | ID correspondido | ok | null | null | facebook.com/b4/about, facebook.com/b4/photos (ficção) | 8 Side Rd fictício, Other City, confirmado separadamente a partir da sua origem manual datada | https://example.com/b4-source (2026-03-02, fora da cidade) | Não pronto / fora do escopo (ID correspondido, site/endereço nativos null, links são seções do perfil, verificação manual prova que está fora da cidade) |
Três identidades correspondidas não produzem três registros prontos. Há um registro pronto, dois registros que precisam de revisão ou estão fora do escopo, e um alvo indisponível. As regras exatas excluem B4 da lista da cidade com base na evidência local manual, não em suposições a partir do nome da Página. A disponibilidade de campos para as três linhas correspondidas é uma de três para o site e uma de três para o endereço retornado nesta ficção. O alvo indisponível B3 é informado separadamente. Não use essas frações como taxas reais de sucesso da ferramenta.
Fontes e leituras adicionais
Por Chronometrica · Atualizado
Voltar ao topo ↑
