Como verificar se uma publicação no X menciona seu produto

Etapas numeradas da análise

1. Defina seu registro de identidade do produto antes de examinar os candidatos. Liste o nome exato do produto, os nomes alternativos conhecidos, o site público oficial, o identificador oficial do perfil e os termos específicos do produto. Mantenha essas regras, criadas pelo leitor, separadas dos campos de verificação do Actor.
2. Comece com as URLs conhecidas de publicações candidatas fornecidas e a entrada atual da Task. Substitua a lista startUrls salva por 1 URL conhecida de uma publicação candidata que você pretende usar no teste piloto.
3. Verifique o ID ou a URL nativa da fonte, o texto e o estado ou horário. Avalie se o texto é suficiente. Imagens, o conteúdo de publicações citadas e páginas vinculadas podem conter contexto que a linha não apresenta. Se faltar contexto necessário, examine a fonte pública original separadamente ou marque o item como pendente de análise. Uma cadeia de texto não vazia não comprova que o contexto está completo.
4. Registre a correspondência literal separadamente da decisão sobre a entidade à qual o texto se refere. Indique a palavra ou o nome alternativo correspondente e o trecho que serve como evidência. Um nome alternativo que também seja uma palavra comum, como River, pode corresponder a uma discussão sobre cursos d’água. Não conclua que o autor se refere ao produto com base em letras maiúsculas, uma correspondência de palavra-chave, um selo azul ou um grande número de seguidores.
5. Use uma regra de contexto por escrito. Uma URL exata e verificada do produto, um identificador oficial do perfil ou um nome de produto distintivo no próprio trecho pode sustentar a identificação da entidade pretendida segundo essa regra. Uma referência que use apenas um nome ou um pronome pode continuar ambígua. Leia com atenção a frase ao redor.
6. Classifique como referência fundamentada ao produto, uso de palavra comum ou pendente de análise, com um motivo concreto. Uma referência fundamentada significa que o trecho analisado se refere ao produto indicado. Isso não significa que a afirmação seja verdadeira, positiva, feita por um cliente ou aprovada pela marca. A análise de sentimento e a verificação da veracidade das afirmações são análises separadas.
7. Mantenha as evidências da fonte, a versão da regra, o responsável pela análise, o horário e o contexto não esclarecido na pequena fila. Linhas de exportação repetidas para a mesma publicação não se tornam menções separadas. Cópias da fonte que apresentem conflitos permanecem sem conclusão. Uma falha na fonte não comprova a ausência de menção. Não substitua silenciosamente um texto ausente por uma versão anterior, apresentando-a como atual.
8. Encaminhe ao próximo processo apenas as decisões de relevância já analisadas. Se depois você criar uma ferramenta de alertas, mantenha separados os comprovantes de coleta, análise de relevância e entrega. Nenhuma integração de notificações foi testada aqui. Este guia termina com uma fila de análise de relevância sustentada pelas fontes e um caso concreto sem conclusão, sem prometer que os alertas abrangem todas as publicações.

OUTPUT e estrutura dos campos

O Actor X Post Metrics 1.0.4 aceita `startUrls` com URLs conhecidas de publicações públicas. Os campos nativos exatos retornados para cada publicação são `inputUrl`, `postUrl`, `postId`, `postType`, `publishedAt`, `text`, `profileUrl`, `profileId`, `profileUsername`, `profileName`, `status`, `statusReason` e `observedAt`.

Observe que `text` pode ser nulo, e o array `postMetricStatus` descreve a disponibilidade e a precisão das métricas, não a completude do texto nem a relevância semântica. O resumo da execução apresenta contagens agregadas (`inputCount`, `datasetRows`, `usefulRows`, `billableRows`, `failedRows`, `statusCounts` e `stopReason`). Uma execução de controle com 1 publicação demonstra a estrutura de saída do resumo da execução:

Texto simples

inputCount: 1
datasetRows: 1
usefulRows: 1
billableRows: 1
failedRows: 0
statusCounts: {"ok": 1}
stopReason: "inputs_exhausted"

Nesta execução de controle, a publicação consultada retornou texto não vazio com 200 caracteres. Isso confirma o suporte à coleta de texto em 1 publicação pública conhecida, mas não garante a presença de texto em todas as publicações, imagens, conteúdos de publicações citadas, páginas vinculadas ou na redação original de versões históricas. Quando o texto está indisponível, o estado da correspondência de palavra-chave é desconhecido, e não falso.

Fila do exemplo resolvido

Todo o texto didático e todos os exemplos abaixo são ficção original.

Registro de identidade do produto criado pelo leitor

• Nome do produto: RiverQueue
• Nomes alternativos: River (regra de palavra-chave que não diferencia maiúsculas de minúsculas: "river", em minúsculas, corresponde ao nome alternativo "River" sem alterar o texto bruto da fonte)
• Identificador oficial do perfil: @RiverQueue
• Domínio oficial: riverqueue.example
• Premissa verificada / Fonte: Registro de identidade da marca verificado pelo leitor (Regra v1.0, verificada em 2026-10-13 pelo Revisor)

Fila de análise de relevância dos candidatos

4 publicações candidatas distintas resultam em 1 referência fundamentada, 1 uso de palavra comum e 2 casos pendentes de análise. Não chame isso de taxa de acerto para todo o X, taxa de falsos positivos ou participação nas menções, pois nenhuma amostra com classificação de referência conhecida foi testada. O link público fictício do produto é uma premissa de identidade verificada manualmente, não o resultado de uma consulta feita pelo Actor.