ai-seo
por coreyhaines31ai-seo ajuda você a otimizar o conteúdo da sua marca para que ele possa ser descoberto, extraído e citado por assistentes de IA e mecanismos de busca por IA como Google AI Overviews, ChatGPT, Perplexity, Claude, Gemini e Copilot.
Visão geral
O que a skill ai-seo faz
ai-seo é uma skill especializada em SEO e estratégia de conteúdo focada em busca por IA, não apenas em rankings clássicos do Google. Ela ajuda você a tornar suas páginas detectáveis, extraíveis e citáveis por sistemas de IA como Google AI Overviews, ChatGPT, Perplexity, Claude, Gemini e Copilot.
Em vez de otimizar apenas para blue links, ai-seo orienta você a:
- Auditar sua visibilidade atual em respostas geradas por IA
- Melhorar a forma como seu conteúdo é estruturado para que LLMs possam citá-lo claramente
- Fortalecer sinais de autoridade que tornam seu site uma citação preferencial
- Alinhar seu conteúdo com a forma como diferentes plataformas de IA escolhem e ranqueiam fontes
A skill se baseia em:
- Um fluxo estruturado de AI Visibility Audit
- Um framework de três pilares: Structure, Authority, Presence
- Padrões de conteúdo práticos para answer engines (AEO) e generative engines (GEO)
- Orientações sobre fatores de ranqueamento específicos de cada plataforma de IA
Para quem a ai-seo é indicada
ai-seo é uma boa opção se você é:
- Líder de marketing ou SEO e quer ver sua marca citada em respostas de IA
- Estrategista de conteúdo planejando um roadmap de visibilidade em busca por IA
- Founder ou PMM que vive vendo concorrentes citados no ChatGPT ou Perplexity
- Agência ou consultor oferecendo serviços de AI SEO / AEO / GEO
Ela não é principalmente para:
- Auditorias de SEO técnico aprofundadas (erros de crawl, velocidade do site, linking interno) → use
seo-audit - Detalhamento de implementação de Schema.org ou structured data → use
schema-markup - Pesquisa de palavras-chave genérica sem foco em resultados orientados por IA
Problemas que a skill ai-seo resolve
Use ai-seo quando você precisar responder perguntas como:
- “Como fazemos nosso SaaS aparecer nas recomendações do ChatGPT e Perplexity?”
- “Por que os AI Overviews nunca citam nosso conteúdo?”
- “Quais padrões de conteúdo ajudam a ganhar answer boxes e resumos de IA?”
- “Devemos permitir ou bloquear crawlers de IA no
robots.txt?” - “Como diferentes plataformas de IA decidem quais sites citar?”
A skill ajuda você, de forma sistemática, a:
- Verificar se e onde sua marca já aparece em respostas de IA
- Identificar lacunas na estrutura do seu conteúdo que impedem LLMs de citarem você
- Aplicar padrões testados de blocos de conteúdo AEO e GEO em páginas-chave
- Priorizar próximos passos concretos com base em sinais de ranqueamento com suporte em pesquisa
Como usar
Instalação e configuração
Para adicionar ai-seo ao seu ambiente de agent, instale a partir do repositório coreyhaines31/marketingskills:
npx skills add https://github.com/coreyhaines31/marketingskills --skill ai-seo
Depois de instalar:
- Abra a pasta
skills/ai-seo/. - Comece por
SKILL.mdpara entender o comportamento central, escopo e lógica de decisão. - Revise as pastas
references/eevals/para ver padrões e exemplos.
Arquivos principais:
SKILL.md– definição principal da skill ai-seo e do fluxo de trabalhoreferences/content-patterns.md– padrões reutilizáveis de conteúdo AEO e GEOreferences/platform-ranking-factors.md– como as principais plataformas de IA selecionam fontesevals/evals.json– prompts de exemplo e comportamentos esperados para validação
Fluxo central: do audit ao plano de ação
A skill ai-seo foi desenhada em torno de uma estratégia passo a passo, não de dicas pontuais. O fluxo em alto nível inclui:
1. Coletar contexto de visibilidade em IA
Antes de rodar análises profundas, a skill busca entender o contexto mais amplo de produto e marca.
Se o seu repositório tiver um arquivo de contexto de product marketing, ai-seo espera que ele seja lido primeiro:
.agents/product-marketing-context.md(padrão atual).claude/product-marketing-context.md(setups mais antigos)
Se esse arquivo estiver faltando ou incompleto, o fluxo vai pedir informações essenciais como:
- Seu produto e categoria (por exemplo, “B2B project management SaaS”)
- Principais use cases e públicos-alvo
- Marcas concorrentes que você vê sendo citadas em respostas de IA
- Suas queries ou tópicos mais importantes
Isso evita perguntas repetitivas e mantém as decisões de AI SEO alinhadas ao seu posicionamento.
2. Rodar um AI Visibility Audit
Em seguida, ai-seo guia você por uma checagem de visibilidade em IA nas principais plataformas, normalmente cobrindo:
- Google AI Overviews
- ChatGPT
- Perplexity
- Claude
- Gemini
- Copilot
O audit foca em:
- Se sua marca aparece ou não para as queries-alvo
- Com que frequência você é citado em comparação com concorrentes
- Que tipos de páginas (guias, docs, pricing, comparativos) tendem a ser citadas
Este estágio é onde você identifica lacunas de visibilidade zero e prioriza quais queries ou páginas atacar primeiro.
3. Aplicar os três pilares: Structure, Authority, Presence
ai-seo usa um framework de três pilares que aparece ao longo dos prompts e referências:
-
Structure – Tornar o conteúdo extraível
- Use headings claros, definições objetivas e blocos de resposta autocontidos
- Quebre explicações complexas em padrões de passo a passo ou FAQ
- Inclua bons comparativos estruturados e tabelas de prós/contras
-
Authority – Tornar o conteúdo citável
- Reforce sinais de E-E-A-T com autoria especializada e fontes confiáveis
- Traga estatísticas, citações externas e afirmações claras
- Evite texto excessivamente “vendas” nas páginas educacionais que sistemas de IA usam como fonte
-
Presence – Estar onde a IA procura
- Garanta que seu conteúdo esteja indexado nos backends de busca que cada plataforma de IA utiliza
- Confirme que bots de IA estão permitidos no
robots.txtse você quiser receber citações - Publique formatos e tópicos que cada assistente de IA prefere citar
A skill usa esses pilares para transformar os achados do audit em uma lista priorizada de correções.
4. Usar padrões de conteúdo AEO e GEO
O arquivo references/content-patterns.md traz padrões prontos, desenhados para answer engines e generative engines.
A partir desse guia, você obtém:
-
Padrões de Answer Engine Optimization (AEO)
- Blocos de definição para queries “What is X?”
- Blocos passo a passo para queries “How to”
- Blocos de tabelas comparativas para conteúdo “[Tool] vs [Tool]”
- Blocos de prós e contras, FAQ e listas para respostas fáceis de escanear
-
Padrões de Generative Engine Optimization (GEO)
- Blocos de citação de estatísticas
- Blocos de citações de especialistas e afirmações com autoridade
- Blocos de resposta autocontidos que a IA pode inserir diretamente nas respostas
- Estruturas “sanduíche” focadas em evidências, que misturam afirmações e provas
ai-seo pode ajudar você a decidir quais padrões aplicar em cada página e como adaptá-los ao tom de voz da sua marca.
5. Alinhar com fatores de ranqueamento específicos de cada plataforma
Plataformas de IA diferentes usam índices e lógicas de ranqueamento diferentes. O guia references/platform-ranking-factors.md (que ai-seo usa para raciocinar) explica:
- Fundamentos comuns: inclusão no índice, crawlability, extractability
- Como o Google AI Overviews adiciona uma camada de seleção por IA sobre os sinais tradicionais de SEO
- Por que citações, estatísticas e structured data se correlacionam com melhor visibilidade
- Como estudos sobre autoridade de domínio e relevância temática se relacionam com citações em IA
A skill usa esse conhecimento para ajustar recomendações, por exemplo:
- Enfatizando E-E-A-T e structured data para Google AI Overviews
- Priorizando trechos bem referenciados e autocontidos para LLMs como ChatGPT e Perplexity
6. Produzir um plano de ação priorizado
Com base no audit e nos padrões, ai-seo normalmente encerra propondo um plano conciso e ranqueado, como:
- Reescritas de páginas de alto impacto usando padrões AEO/GEO
- Novas peças de conteúdo criadas para cobrir lacunas de visibilidade em queries específicas
- Decisões técnicas e de política sobre acesso de bots de IA e indexação
Você pode então distribuir essas tarefas para redatores, profissionais de SEO ou product marketers.
Exemplos de prompts para usar com a skill ai-seo
Depois de instalar, direcione queries para ai-seo sempre que surgir linguagem focada em SEO para IA, por exemplo:
- “Nunca aparecemos no Google AI Overviews. O que devemos corrigir primeiro?”
- “Como otimizo nossos posts de blog para o ChatGPT nos citar como fonte?”
- “Crie um checklist de AI visibility audit para o nosso fintech SaaS.”
- “Me ajude a redesenhar esta página de comparação para aumentar as chances de o Perplexity citá-la.”
Em cada caso, ai-seo vai:
- Buscar o contexto de product marketing
- Passar pelo framework dos três pilares
- Consultar o guia de visibility audit e os content patterns
- Retornar um conjunto de ações estruturado e priorizado
Quando a ai-seo não é a melhor opção
Considere outra skill se sua principal necessidade for:
- Checks de SEO técnico (crawl budget, sitemaps, 404s) → use
seo-audit - Planejamento e validação de schema markup → use
schema-markup - Calendários de conteúdo puramente para redes sociais sem objetivo de busca por IA → use skills focadas em social ou conteúdo
ai-seo funciona melhor quando visibilidade em busca guiada por IA, answer engine optimization e citações em IA são os objetivos principais.
FAQ
Em que a ai-seo é diferente de ferramentas tradicionais de SEO?
ai-seo foca especificamente em busca por IA e answer engines. Em vez de tentar apenas melhorar rankings em SERPs clássicos, ela ajuda você a:
- Auditar com que frequência aparece em respostas geradas por IA
- Estruturar o conteúdo para que LLMs possam citá-lo com facilidade
- Se alinhar a fatores de ranqueamento específicos de IA, detalhados nos guias de referência do repositório
Para SEO técnico completo ou saúde geral do site, você deve usar ai-seo em conjunto com skills e ferramentas de SEO mais tradicionais.
Como instalo a skill ai-seo?
Instale ai-seo a partir do repositório coreyhaines31/marketingskills usando:
npx skills add https://github.com/coreyhaines31/marketingskills --skill ai-seo
Depois abra a pasta skills/ai-seo/ e revise SKILL.md, seguido dos diretórios references/ e evals/.
Quais arquivos devo ler primeiro depois de instalar?
Para uma visão rápida, mas consistente:
SKILL.md– explica o que a ai-seo faz e como ela deve se comportar.references/content-patterns.md– mostra os padrões de blocos de conteúdo AEO e GEO que você pode aplicar imediatamente.references/platform-ranking-factors.md– explica como diferentes plataformas de IA escolhem fontes.evals/evals.json– contém prompts de exemplo e outputs esperados para você ver como a skill deve responder.
A ai-seo consegue me orientar sobre bloquear crawlers de IA no robots.txt?
Sim. Os evals e referências incluem cenários sobre acesso de bots de IA. A skill leva em conta:
- Suas preocupações (por exemplo, reutilização de conteúdo vs. visibilidade de marca)
- Trade-offs entre bloquear bots e perder oportunidades de citação
- A importância de crawlability para ser citado em respostas de IA
Você pode fazer perguntas para ai-seo como:
- “Devemos bloquear GPTBot e PerplexityBot?”
- “O que acontece com nossa visibilidade em IA se desativarmos crawlers de IA?”
A ai-seo cobre structured data e schema markup?
ai-seo sabe que structured data pode ajudar na visibilidade em AI Overviews e answer engines, mas não é especializada em implementação de schema. Para estratégia detalhada de schema e ajuda em markup, use a skill dedicada schema-markup junto com a ai-seo.
A ai-seo serve para negócios que não são SaaS?
Sim. Embora muitos exemplos citem SaaS e B2B, os frameworks por trás se aplicam a:
- E‑commerce
- Publishers de conteúdo
- Negócios de serviços
- Escritórios profissionais e consultorias
Desde que seu objetivo seja aparecer e ser citado em respostas de IA, ai-seo pode ser adaptada ao seu segmento usando o seu próprio product marketing context.
Como saber se a ai-seo está funcionando?
Você pode acompanhar o impacto:
- Repetindo periodicamente seu AI visibility audit e registrando melhorias
- Verificando se sua marca passa a aparecer com mais frequência como fonte citada nas queries-alvo
- Monitorando mudanças em tráfego e conversões assistidas por queries influenciadas por IA (quando mensurável)
A própria ai-seo fornece o plano estratégico e recomendações estruturadas; a medição acontece nas suas ferramentas de analytics e nos próprios checks das plataformas de IA.
