Cartões de Páginas comerciais conhecidas se conectam a um diretório conferido, ao lado de cartões de contato ausentes.
Mantenha os campos de contato ausentes visíveis.

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.

Exemplo e tabela de ficção original
Chave do registroIdentidade correspondidaStatus nativoSite brutoEndereço brutoLinks detectadosEndereço manual / evidência localOrigem manual e verificação (ficção)Prontidão do registro segundo o leitor e motivo
B1ID correspondidookhttps://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 datadahttps://example.com/b1-source (2026-03-01, verificação local)Pronto (ID correspondido, site e endereço nativos presentes, evidência local manual confirmada)
B2ID correspondidooknullnullfacebook.com/b2/photos (ficção)desconhecidoNenhumaPrecisa de revisão (ID correspondido, site/endereço nativos null, sem evidência manual)
B3Sem identidadelogin_requirednullnullnulldesconhecidoNenhumaAlvo indisponível (login necessário, nenhuma identidade recuperada)
B4ID correspondidooknullnullfacebook.com/b4/about, facebook.com/b4/photos (ficção)8 Side Rd fictício, Other City, confirmado separadamente a partir da sua origem manual datadahttps://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 ↑