/seo

Executa o fluxo de 8 etapas de SEO, GEO/AEO e Google Ads, produzindo os documentos de pesquisa e estratégia em marketing/seo/. Use com “seo”, “geo”, “aparecer no chatgpt”, “google meu negócio”, “pesquisa de nicho” ou /seo [01-08].

Como funciona

O que lê

• _memoria/empresa.md (produtos, região, público, diferenciais, ## Idioma de saída)
• _memoria/preferencias.md (tom de voz), _memoria/estrategia.md (prioridades)
• DATAFORSEO_LOGIN/DATAFORSEO_PASSWORD (env): se presentes, dados reais de volume/CPC/dificuldade/SERP live
• GSC_SITE_URL/GSC_SERVICE_ACCOUNT_JSON (env): se presentes, rankings atuais via Search Console API
• SITE_REPO_PATH (env): estrutura de páginas existente, para a etapa 04
• Pesquisa e navegação web nativas do agente, em quase todas as etapas
• Argumento opcional com o número da etapa (01–08) para rodar isoladamente

Passos por etapa (cada uma grava seu arquivo em marketing/seo/ e mostra um resumo antes de seguir)

01-demanda.md — Termos-semente a partir do contexto do negócio, classificados por intenção (problem-aware / solution-aware / decision) e por estágio de funil (dor / solução / produto). Com DATAFORSEO_*: volume/CPC/dificuldade via dataforseo_labs (search volume + keyword difficulty) — confirmar o endpoint exacto na documentação oficial DataForSEO antes da primeira chamada da sessão. Sem credenciais: método manual com Google Trends, autocomplete e “As pessoas também perguntam”, marcando cada termo sem dado real como “estimativa” com a lógica usada. Tabela de termos, top 10 prioritários, sazonais e descartados (com motivo).

02-concorrencia.md — Mapear quem domina os resultados para os termos prioritários da etapa 01 (SERP real, nunca lembrada de memória); tabela de concorrentes, gaps de conteúdo/oferta, recomendações de onde atacar primeiro.

03-google-meu-negocio.md — Checklist do Google Business Profile: informações, descrição, atributos, fotos, posts, estratégia de avaliação (referenciar a skill responder-avaliacoes para a execução), diretórios locais.

04-on-page.md — Por página existente em SITE_REPO_PATH (ou por página que o usuário descrever, se a pasta não existir): keyword-alvo, title, description, H1; JSON-LD (Article/ Organization/BreadcrumbList, somando FAQPage onde há Q&A); checklist técnico (HTML estático/SSR, TL;DR citável no topo, densidade semântica). Score 0–10 por eixo (technical, on-page AI-search, schema.org) com justificativa.

05-conteudo.md — Cluster pilar + satélites a partir da etapa 01; calendário editorial; lista de páginas evergreen. Este documento é a fonte de temas para /publicar-tema — nunca duplicar aqui um tema já publicado (checar SITE_REPO_PATH/src/content/blog/).

06-google-ads.md — Estrutura de Search: 3 ad groups por estágio de intenção (nunca misturar produto/feature no mesmo grupo); match types só EXACT (bottom-funnel) e PHRASE (mid-funnel), broad proibido; negativas em camadas (anti-ICP, consumidor/RH/suporte, cross-campaign, caça-preço/DIY — incluir formas com e sem acento); 10–30 keywords por grupo; orçamento e RSA/copies derivados do mesmo posicionamento da etapa 05, nunca isolados. Consumida por /anuncio-google.

07-monitoramento.md — Checklist semanal (referenciar /relatorio-ads), mensal e trimestral; decisão de médias móveis de 7 dias (nunca 1 dia isolado) para CPL/CTR/CPA; critérios: outlier só vira ação se repetir 3 dias úteis; CPA subindo persistente → baixar bid/cortar termo, nunca as duas mudanças juntas.

08-aeo-geo.md — Baseline de citação por IA: rodar a keyword-alvo em SERP live e registar se há AI Overview e se o domínio aparece; rodar 5–10 prompts-teste diretos no ChatGPT/ Perplexity relacionados ao negócio e registar se e como a empresa é citada (data, prompt, resposta, citada sim/não); distinguir bot de treino (GPTBot) de bot de citação ao vivo (OAI-SearchBot, ChatGPT-User, PerplexityBot, ClaudeBot) ao ler robots.txt/logs; FAQ com schema FAQPage; lista de ações de citação; checklist de monitoramento (repetir os mesmos prompts-teste mensalmente para medir progresso vs. este baseline).

Passos gerais

1. Se o argumento indicar uma etapa (01–08), rodar só essa etapa; senão, rodar as 8 em ordem, mostrando o resumo do achado antes de seguir para a próxima.
2. Etapa que depende de resultado de etapa anterior não executada: avisar e oferecer rodar a etapa anterior primeiro, em vez de assumir dado que não existe.
3. Ao concluir o fluxo completo, apresentar resumo executivo: 5 principais oportunidades, ações prioritárias, estimativa de investimento em Ads e próximos passos.

O que grava e onde

marketing/seo/01-demanda.md · 02-concorrencia.md · 03-google-meu-negocio.md · 04-on-page.md · 05-conteudo.md · 06-google-ads.md · 07-monitoramento.md · 08-aeo-geo.md

Pontos de aprovação

• Estimativas de custo/investimento em Ads (etapa 06): mostrar a lógica de cálculo antes do usuário decidir orçamento real.

Falha cedo

• DATAFORSEO_LOGIN/PASSWORD ausentes: seguir com método manual (Trends/autocomplete/PAA) e dizer no documento que a integração desbloquearia volume/CPC/dificuldade reais.
• GSC_SITE_URL/GSC_SERVICE_ACCOUNT_JSON ausentes: seguir sem rankings atuais e dizer que a integração desbloquearia posição real por termo.
• SITE_REPO_PATH ausente na etapa 04: perguntar UMA vez pelas páginas existentes, sem bloquear a etapa.
• Dado de volume/CPC/dificuldade/custo não obtido com precisão: marcar como estimativa explícita com a lógica usada — nunca apresentar como dado real.

Verificação final

Cada arquivo da etapa executada existe em marketing/seo/ com conteúdo (não vazio) e nenhum número sem indicação de fonte ou “estimativa” — confirmar com ls -la marketing/seo/ e leitura do documento gerado.