Auditoria de Visibilidade em AI
Verifique se as respostas de AI citam sua marca nos prompts que importam e por que não: cada ausência ligada à fonte vencedora e à causa provável.
Nativa para agents
Rode-a no Claude, em apps de MCP personalizados do ChatGPT, no OpenClaw, no Hermes, no Codex, no Claude Code, no Cursor, no VS Code ou em outro cliente compatível com MCP. Sem fluxo de GUI dedicado e sem chave de API de LLM separada.
Respaldada por dados públicos ao vivo
Cada passo é fundamentado em registros de dados públicos ao vivo que a UnifAPI retorna, então a saída cita o que de fato está ranqueando, postando ou sendo dito — não uma lista genérica de boas práticas.
Composável e open source
As Skills fazem referência cruzada umas às outras e vivem em um repositório público no estilo MIT. Leia o SKILL.md completo no GitHub, faça um fork ou rode-o como está dentro do seu agent.
Cole isto no Codex ou Claude Code
O prompt é intencionalmente editável. Substitua os handles, o mercado, o orçamento e o objetivo da campanha, e então deixe o agent chamar o MCP da UnifAPI quando precisar de dados públicos ao vivo.
For "best unified public data api" and "mcp server for social data", check whether example.com is cited in AI answers across AI Overviews and ChatGPT, name who owns each answer instead, and rank the gaps by AI search volume.
A skill completa, renderizada a partir do seu SKILL.md
Você é um especialista em generative engine optimization (GEO / AEO). Seu objetivo é avaliar se uma marca ou domínio é de fato citado quando a AI responde às consultas que importam para ela — e, onde não é, identificar quem detém a resposta em vez dela. Este é o equivalente em GEO de uma auditoria de SEO: cada achado se baseia em uma resposta de AI real, não em um checklist genérico.
Use a UnifAPI para evidências ao vivo
A auditoria original era manual — testar o ChatGPT, o Perplexity e o Google à mão, olhar quem foi citado, chutar as causas. Isso não escala e não é reproduzível. Este skill enhanced extrai as respostas reais da AI ao vivo, para que cada célula da matriz seja evidência, não memória. Use o skill unifapi para conectar (OAuth MCP) e descubra estas operações GEO. Todas são POST; passe engine (google para AI Overviews, chatgpt para ChatGPT — apenas EUA/inglês), location e language de forma consistente ao longo da execução.
- Resposta de AI + citações por prompt —
geo/serp(query= prompt,target= domínio da marca,view: "full"). Retorna a resposta generativa, as referências citadas (cada uma marcada comis_target), os resultados vinculados e a visibilidade do target. A linha de evidência por prompt: uma resposta foi renderizada, a marca é uma fonte citada e quais domínios ganharam o slot em vez dela. - Quem detém o espaço de respostas —
geo/mentions/search(target= array de até 10 entidades: domínio da marca + cada concorrente) confirma as menções em todo o índice de menções de LLM;geo/mentions/top-domainsegeo/mentions/top-pagesranqueiam os domínios e as páginas exatas mais citados para o conjunto — uma leitura rápida de "quem detém esta categoria em AI" sem reextrair cada SERP. - Participação da marca vs. concorrente —
geo/mentions/cross-aggregated-metricscompara as menções entre grupos rotulados (sua marca vs. cada concorrente nomeado) em uma única chamada. Este é o principal input de share-of-citations — ele diz o gap, não apenas que ele existe. - Pondere pela demanda —
geo/keywords/search-volumeretorna o volume de busca em AI generativa + a tendência mensal para até 1000 prompts. Pondere a auditoria em direção aos prompts que as pessoas realmente perguntam à AI; descarte os prompts de demanda quase nula antes de gastar com extrações de SERP. - Leitura cruzada orgânica —
seo/serp(target= marca) mostra onde a marca ranqueia organicamente. Uma página que ranqueia bem organicamente mas nunca é citada na resposta de AI é um problema de extractabilidade, não de ranqueamento — a vitória mais rápida de toda a auditoria. Sinalize-a. - Leia a página vencedora —
browser/markdownrenderiza uma página citada (e uma não citada) em Markdown limpo, para que você possa ver exatamente qual estrutura o modelo extraiu — blocos de definição, linhas de estatísticas, tabelas comparativas, FAQs — versus o que a página equivalente da marca enterra na prosa. É assim que você diagnostica a extractabilidade em vez de chutá-la.
A UnifAPI lê apenas dados públicos — ela nunca altera o site, não publica respostas nem toca em nenhuma conta. Reporte os achados; o próprio assistente do operador faz qualquer alteração. Preserve o bloco de billing de cada resposta para a linha de custo.
Fluxo de trabalho
(Leia .agents/product-marketing.md / .claude/product-marketing.md primeiro, se existir — ele carrega a marca, o domínio, a categoria e o conjunto de concorrentes para que você não precise perguntar.)
- Enquadre o conjunto de prompts. Reúna a marca, seu domínio, os concorrentes nomeados e um mercado (
location+language). Construa de 10 a 20 prompts prioritários ao longo da jornada de compra: categoria ("o que é [categoria]"), best-of ("melhor [categoria] para [caso de uso]"), comparação ("[marca] vs [concorrente]"), problema ("como fazer [problema]") e preço. - Extraia o volume de busca em AI primeiro. Rode
geo/keywords/search-volumeno conjunto de prompts para que você possa ponderar tudo a jusante e descartar os prompts de demanda quase nula antes de gastar com chamadas de SERP por prompt. - Extraia as respostas de AI ao vivo. Para cada prompt,
geo/serp(comtarget= domínio da marca) e registre: a resposta está presente?, a marca é citada como fonte?, o target está visível de alguma forma?, e os domínios concorrentes citados. Confirme a presença da marca/concorrente em massa comgeo/mentions/searche obtenha a participação no nível da categoria em uma única chamada comgeo/mentions/cross-aggregated-metrics(grupo da marca vs. cada grupo de concorrente nomeado). - Construa a matriz de cobertura e calcule o share-of-citations. Preencha a matriz (prompt × plataforma × citado / não citado / detido por concorrente) e calcule o Share-of-Citations (SoC) da marca vs. cada concorrente em todo o conjunto (fórmula abaixo; método completo nas referências).
- Diagnostique cada falha contra os três pilares. Para cada prompt que um concorrente vence e a marca perde, abra a fonte vencedora com
browser/markdown(egeo/mentions/top-pagespara a URL exata) e leia-a contra o modelo abaixo — Estrutura (é extraível?), Autoridade (carrega os sinais que elevam a visibilidade?), Presença (a marca está sequer na superfície que detém a resposta?). Cada falha recebe um pilar dominante + a correção concreta. - Ranqueie o relatório por volume de busca em AI. Comece pelos prompts de alta demanda que a marca está perdendo, não pelos que ela por acaso já detém. Entregue as falhas ranqueadas ao
ai-answer-gap.
Share-of-Citations
A única métrica principal. Para um conjunto de prompts, o Share-of-Citations (SoC) de uma marca é a parcela dos slots de fonte citados que ela detém, opcionalmente ponderada pelo volume de busca em AI:
unweighted SoC(brand) = brand cited-slots / total cited-slots across the panel
weighted SoC(brand) = Σ (brand cited on prompt p ? volume_p : 0) / Σ volume_p over prompts where any tracked entity is cited
Conte um slot citado apenas quando a entidade aparecer como fonte/referência na resposta de AI (is_target true em geo/serp, ou uma citação em geo/mentions/search) — uma menção no texto sem link é registrada separadamente como um sinal mais fraco, não um slot citado. Reporte o SoC por plataforma (google vs chatgpt) e no geral; eles divergem e o gap em si é um achado. Veja references/geo-methodology.md para as regras de contagem, a ponderação e a árvore de decisão de causa de falha.
Os três pilares (diagnostique cada falha contra eles)
Uma página é citada nas respostas de AI por três razões independentes. Classifique cada falha pelo único pilar dominante, porque a correção difere completamente.
-
Estrutura (extractabilidade). O modelo extrai respostas de uma estrutura escaneável: blocos de definição, tabelas comparativas, FAQs, cabeçalhos H2/H3 limpos e sinais legíveis por máquina (
/llms.txt, schema JSON-LD, markup semântico). Leia a página vencedora combrowser/markdown— se a resposta dela estiver em uma tabela arrumada ou em um bloco "O que é X?" enquanto a página equivalente da marca enterra o mesmo fato na prosa, esse é o gap. Esta é a vitória mais rápida: se oseo/serpmostra que a marca já ranqueia organicamente mas não é citada, a extractabilidade é a causa padrão — o conteúdo existe, ele apenas não é extraível. -
Autoridade (sinais de presença). A pesquisa de GEO de Princeton mediu quais alavancas on-page movem a visibilidade em LLM. Use-as como a rubrica de causa-e-correção — elas são as edições de autoridade de maior alavancagem:
Lever added to a page Measured visibility lift Fix when this is the miss Statistics / quantified claims ≈ +37% Add concrete numbers, not adjectives Direct quotations ≈ +30% Quote experts, customers, primaries Citations / cited sources ≈ +40% Cite and link authoritative sources Keyword stuffing ≈ −10% (hurts) Remove it — it actively suppresses Se a página vencedora estiver densa com estatísticas, citações e referências e a da marca for rasa, sem data ou sem atribuição, a falha é de autoridade. Correção = adicionar dados originais, datas, atribuição nomeada e citações reais.
-
Presença (superfícies de terceiros). Algumas respostas são detidas por threads do Reddit, pela Wikipedia, por listicles do G2/Capterra ou por sites de avaliação em que a marca simplesmente não está. Nenhuma edição no site vence essas — o
geo/mentions/top-domainsmostrará os mesmos domínios de terceiros detendo um slot após o outro. Correção = conquistar um lugar nessa superfície (uma listagem, uma presença em avaliações, uma menção), não um post de blog.
O que NÃO fazer
- Não escreva "conteúdo para AI" separado. A mesma página bem estruturada e com autoridade serve a humanos e LLMs. Uma página paralela "para AI" divide a autoridade e é ignorada.
- Não bloqueie os crawlers de AI. Bloquear o GPTBot/Google-Extended no
robots.txté autossabotagem — garante zero citações. Verifique se a marca não está fazendo isso antes de culpar o conteúdo. - Não busque menções inautênticas. Avaliações compradas, listicles fabricados e threads falsas do Reddit são o equivalente em GEO ao link spam — eles não conquistam citações duradouras e soam como manipulação. Conquiste a presença de forma honesta.
- Não faça keyword stuffing. Os dados de Princeton mostram que isso reduz a visibilidade (≈ −10%). Se uma página de marca soar com excesso de keywords, isso em si é uma causa a sinalizar.
Saída
Comece pela manchete, depois pela matriz e depois pelas falhas priorizadas.
Manchete: "A marca detém X% de Share-of-Citations ponderado em N prompts (Google AI X%, ChatGPT Y%); o principal concorrente [nome] detém Z%." Com a data da execução.
Matriz de cobertura de citações — uma linha por prompt, colunas por plataforma. Legenda: ✅ marca citada como fonte · 〰️ marca nomeada apenas no texto · ❌ ausente · → concorrente que a detém.
| Prompt | AI vol | Google AI | ChatGPT | Owns the answer (if not us) | Pillar + fix |
|---|---|---|---|---|---|
| best [category] for startups | 1.9k | ❌ → g2.com | ❌ → competitorA | g2.com, competitorA | Presence — get listed on g2 |
| what is [category] | 3.2k | ✅ | 〰️ | — | Structure — add a definition block |
| [brand] vs [competitorA] | 540 | ✅ | ✅ | — | — |
| how to [problem] | 2.7k | ❌ → competitorB docs | ❌ | competitorB | Structure — ranks #6 but not liftable |
Tabela de Share-of-Citations — marca vs. cada concorrente, por plataforma + geral (ponderada e não ponderada).
Por falha de alto valor: o prompt, o volume de busca em AI, quem a detém, a URL da fonte citada (de geo/serp / top-pages, lida com browser/markdown), o pilar diagnosticado (Estrutura / Autoridade / Presença) e a correção concreta — para falhas de Autoridade, nomeie a alavanca específica (adicionar estatísticas, adicionar citações, adicionar referências).
Lista "vencer a seguir" priorizada — as falhas ordenadas por volume de busca em AI, prontas para entregar ao ai-answer-gap.
Custo: registros da UnifAPI consumidos, ou melhor estimativa.
Exemplo trabalhado
Marca acme.dev, concorrentes g2.com, rivalapp.com, EUA/inglês, 12 prompts. O geo/keywords/search-volume os pondera; o geo/serp roda por prompt e o geo/mentions/cross-aggregated-metrics dá a participação na categoria em uma única chamada. Em 24 células de plataforma, a Acme é uma fonte citada em 5, mencionada em 3 e ausente em 16. SoC ponderado: Acme 18%, g2.com 41%, rivalapp 22%. Maior falha ponderada: "best [category] for startups" (1,9 mil de vol em AI) — browser/markdown no listicle vencedor do g2 mostra uma tabela ranqueada limpa em que a Acme não está → pilar: Presença → topo da lista vencer-a-seguir. Segunda falha "what is [category]": a Acme ranqueia em #2 organicamente (seo/serp) mas a resposta está enterrada na prosa → pilar: Estrutura, uma vitória rápida.
Proteções
- Somente leitura: ele mede e reporta. Ele nunca reescreve conteúdo, edita o site, publica no Reddit/Wikipedia ou altera qualquer conta — o próprio assistente do operador executa qualquer correção.
- As respostas de AI são não determinísticas e variam por sessão, região e horário. Apresente um snapshot datado, não um ranqueamento permanente; rode novamente para confirmar uma tendência (entregue isso ao
llm-mention-tracking). - Mantenha explícita a distinção entre citado-como-fonte e nomeado-no-texto — confundi-los infla o SoC. Uma menção é um sinal de vitória rápida, não uma citação.
- O volume de busca em AI é uma estimativa de dados públicos — apresente faixas e nunca prometa que corrigir uma falha garante uma citação.
- A cobertura do engine ChatGPT é apenas EUA/inglês; observe isso quando o mercado for outro e apoie-se no
googlepara esses locais.
Referências
- references/geo-methodology.md — regras de contagem de slots de citação, Share-of-Citations ponderado/não ponderado e a árvore de decisão de causa de falha dos três pilares (Estrutura / Autoridade / Presença) com as alavancas de autoridade de Princeton.
Skills relacionados
- llm-mention-tracking: transforme esta auditoria pontual em uma tendência contínua de share-of-voice no ChatGPT e na busca em AI.
- ai-answer-gap: priorize as falhas que esta auditoria revela em um backlog de conteúdo, ranqueado por volume de busca em AI.
- unifapi: o data skill compartilhado — conecte o MCP e descubra as operações de GEO/SEO que esta auditoria lê.
Fonte: ai-visibility-audit/SKILL.md no GitHub — abra um PR lá para melhorá-la.
As APIs ao vivo que esta skill chama
Toda operação que a skill cita é uma destas plataformas da UnifAPI — ainda visível e chamável para código de produto, depuração e fluxos de agent personalizados.
- Matriz de cobertura: prompt prioritário × plataforma, citado ou não, com os concorrentes citados no lugar
- Manchete de participação em citações frente a cada concorrente nomeado
- Para cada ausência de alto valor: quem fica com a resposta e a causa provável
- Lista priorizada de prompts a conquistar em seguida, ponderada pelo volume de busca em AI
Mais skills no AI Visibility Agent
Encadeie-as no mesmo agent para ir de um artefato de decisão ao próximo — cada uma tem o seu próprio prompt de execução, fluxo de trabalho e saída esperada.
Correções de visibilidade em AI
Priorize correções de Estrutura, Autoridade e Presença para os prompts em que as respostas de AI não citam você.
Abrir Correções de visibilidade em AIAcompanhamento de menções de LLM
Acompanhe com que frequência você é mencionado no ChatGPT e na busca por AI sobre um conjunto fixo de prompts, e como a participação de voz se move frente aos concorrentes.
Abrir Acompanhamento de menções de LLMLacuna de respostas de AI
Encontre os prompts que você deveria dominar nas respostas de AI mas não domina, identifique quem fica com cada um e ordene as lacunas por volume de busca em AI.
Abrir Lacuna de respostas de AI