Claude Code para SEO: do primeiro prompt a uma equipe de agentes

Claude Code para SEO significa usar um agente de IA que lê os arquivos do seu site, edita-os, executa comandos e, por meio de um conector MCP, lê os seus dados do Search Console, do Analytics e do Google Business Profile. Comece pequeno: uma pasta sob git, uma regra de ler todo diff e acesso a dados somente leitura. Quando esse ciclo for confiável, adicione agentes em paralelo e depois várias sessões com um líder.

Algumas pessoas chamam isso de "vibe coding SEO" ou "vibe SEO": descrever o resultado em palavras simples e deixar a IA escrever o código. É um rótulo informal, não um termo da Anthropic nem do Google, e só é seguro com as verificações abaixo. Rótulos relacionados incluem "Claude SEO", "Claude Code SEO" e "MCP SEO". Para começar agora, conecte o conector do ZeusSEO, incluído em todos os planos: o guia do MCP do Google Business Profile traz a configuração, e a seção de MCP abaixo acrescenta os comandos do Claude Code. Se você prefere ler sobre um especialista pronto em vez de montar um fluxo de trabalho, há também a Athena, a especialista de SEO com IA do ZeusSEO (em acesso antecipado).

O que é o Claude Code e o que ele pode fazer por SEO

A Anthropic descreve o Claude Code como uma ferramenta de programação com agentes que lê o seu código, edita arquivos, executa comandos e se integra às suas ferramentas de desenvolvimento. Ele roda em um terminal, em uma IDE, em um app de desktop e em um navegador, e a maioria das superfícies exige uma assinatura do Claude ou uma conta do Anthropic Console.

Para SEO, "código" significa qualquer pasta de texto: modelos, publicações em markdown, trechos de schema, robots.txt, mapas de redirecionamento e exportações em CSV. "SEO com o Claude" muitas vezes significa conversar numa janela; o Claude Code trabalha dentro de uma pasta na sua máquina, então pode abrir arquivos, alterá-los e executar verificações. Ele não enxerga o Google até você dar uma visão, por exportações ou por um conector.

Ferramentas recomendadas e sugeridas

Instale a partir da visão geral oficial, como ferramenta de terminal, extensão do VS Code ou app de desktop. Todas as superfícies usam o mesmo motor, então os seus arquivos CLAUDE.md, configurações e servidores MCP valem em todas.

Um CLAUDE.md inicial para a pasta de um cliente poderia dizer:

• Quais pastas guardam modelos, conteúdo e exportações.
• Nunca edite o robots.txt nem o mapa de redirecionamento sem perguntar.
• Nunca invente fatos, preços, avaliações ou estatísticas.
• Proponha mudanças no Google Business Profile; nunca as publique.

Git e pastas locais: o seu botão de desfazer

Dê a cada cliente uma pasta para arquivos do site, exportações e relatórios, e inicie o Claude Code ali. No modo Manual, ele pergunta antes de ler ou gravar fora da pasta onde começou, como explica a página de segurança.

1. Use git, até para exportações. Sem repositório num site de CMS? Guarde rascunhos e CSVs numa pasta e execute git init.
2. Uma branch por tarefa e um commit antes de cada execução.
3. Leia o git diff antes de aceitar. O Claude Code pode fazer o commit por você, mas a revisão é sua.

Cinco fluxos de trabalho de SEO para começar

Use um único fluxo de trabalho de SEO com IA, repetível, para as cinco tarefas do Claude Code SEO: definir o escopo, obter os dados, planejar, alterar arquivos numa branch, executar uma verificação, ler o diff e fazer o commit. As boas práticas da Anthropic recomendam planejar antes de programar e dar ao Claude uma verificação que ele possa executar, para que itere até a verificação passar.

1. Auditoria técnica dos arquivos de um site

Peça ao Claude que leia modelos, robots.txt e a configuração do sitemap no modo de plano e liste as constatações por arquivo e linha. O Google diz que o robots.txt não é uma forma de manter uma página fora do Google, então sinalize qualquer Disallow usado para isso. O nosso guia de auditoria de SEO técnico cobre o lado ao vivo.

2. Escrever e verificar schema

A introdução a dados estruturados do Google recomenda JSON-LD na maioria dos casos e diz que a marcação deve descrever conteúdo que os usuários possam ver. Peça ao Claude que redija a marcação por modelo e depois valide você mesmo.

3. Correções on-page em massa num repositório

Dê ao Claude um CSV com a URL e o novo título e deixe que ele edite os arquivos correspondentes. Teste primeiro em alguns, depois use o /batch, que divide uma mudança entre 5 e 30 subagentes, cada um trabalhando no seu próprio worktree.

4. Planilhas de clusters de palavras-chave

Exporte as consultas para um CSV e peça ao Claude que escreva e execute um script que as agrupe por tema e proponha uma página para cada grupo.

5. Preparação de relatórios

Obtenha os números pelo conector e peça uma narrativa curta por cliente. Veja o nosso guia de relatório de ranking de SEO para saber o que um relatório de cliente deve conter.

MCP: conecte o ZeusSEO ao Claude Code

MCP, o Model Context Protocol, é um padrão aberto para conectar ferramentas de IA a fontes de dados externas, e o Claude Code aceita servidores MCP remotos por HTTP. MCP para SEO significa que o seu agente lê dados ao vivo do cliente em vez de uma exportação colada. O conector do ZeusSEO tem uma URL e mais de 100 ferramentas.

1. Adicione o servidor num terminal, não dentro de uma sessão:

2. Confira. O claude mcp list mostra "Needs authentication" até você entrar, como descreve o início rápido do MCP.
3. Entre. Inicie o claude, digite /mcp, escolha zeuseo e selecione Authenticate. O seu navegador abre na etapa de login descrita no guia do MCP do Google Business Profile.

Adicione --scope user para usá-lo em todos os projetos. Se você adicionou o conector no Claude e usa a mesma conta no Claude Code, a documentação do MCP diz que os conectores do Claude são carregados automaticamente, a menos que uma chave de API seja o seu login. O nosso login é um fluxo OAuth padrão com PKCE que aceita o endereço de retorno local do Claude Code.

Ler os seus próprios dados não custa Staters, os créditos de uso pré-pagos do ZeusSEO. Algumas ferramentas específicas que chamam os nossos provedores pagos ou IA, como pesquisa de palavras-chave e consulta de concorrentes na SERP, gastam Staters, e o assistente é instruído a avisar você antes. As instruções dele também mandam confirmar conteúdo e alvos antes de qualquer publicação, edição, exclusão ou resposta, e um acesso somente leitura é recusado em escritas. Um teste gratuito tem um limite de uso justo de 100 chamadas de API. Veja Staters e créditos de IA, preços e os guias de MCP do Search Console e do Analytics.

Uso de API: chaves, custos e scripts

Você entra com uma assinatura do Claude ou uma conta do Anthropic Console. A página de custos diz que o valor em dólares no /usage é uma estimativa local e que os assinantes têm o uso incluído no plano.

Para scripts, o claude -p executa um prompt sem uma sessão interativa e aceita entrada por pipe, um padrão da visão geral:

No modo --bare, o Claude Code não usa o login da sua assinatura, então defina ANTHROPIC_API_KEY, como explica a página de uso programático. Se o Claude escrever scripts que chamam uma API de dados, guarde a chave numa variável de ambiente e adicione a regra de negação Read(./.env). Para dados do Google, o conector dispensa a espera de aprovação do seu próprio projeto de API; veja API do Google versus MCP.

Permissões e hooks: defina as proteções uma vez

As instruções num prompt ou no CLAUDE.md moldam o que o Claude tenta, mas as regras de permissão são aplicadas pelo Claude Code, não pelo modelo. As regras são verificadas em ordem: negar, depois perguntar, depois permitir. Os modos de permissão abaixo definem com que frequência o Claude pergunta. A partir do Claude Code 2.1.283, o modo auto é o modo inicial padrão das sessões interativas de terminal e do VS Code, então, para trabalho com clientes, pressione Shift+Tab para chegar ao modo Manual ou comece com claude --permission-mode default.

• Permita as ferramentas de leitura: mcp__zeuseo__gsc_*, mcp__zeuseo__ga4_* e mcp__zeuseo__argus_*. O prefixo zeuseo é o nome do servidor que você escolheu ao adicioná-lo.
• Mantenha as ferramentas de escrita fora das regras de permissão, para que o modo Manual pergunte sempre. No modo auto, um classificador revisa a chamada no seu lugar, então adicione uma regra de pergunta em /permissions se quiser uma confirmação de qualquer jeito.
• Negue segredos: Read(./.env).
• Bloqueios rígidos: um hook PreToolUse que sai com o código 2 impede edições em arquivos protegidos. O guia de hooks diz que os hooks são determinísticos, ao contrário do CLAUDE.md.

Agentes de IA para SEO: subagentes em paralelo

Um subagente roda na sua própria janela de contexto, com um prompt personalizado, ferramentas específicas e permissões independentes, e depois devolve um resumo. Defina um como um arquivo markdown em .claude/agents/, como um revisor de schema limitado a Read, Grep e Glob para que não possa editar. A Anthropic lista várias formas de executar agentes em paralelo, incluindo:

Um agente atuando como líder

A visão geral descreve um agente líder que coordena o trabalho, atribui subtarefas e reúne os resultados. Os subagentes só reportam à conversa que os criou, então essa conversa é o seu ponto único de contato.

1. Oriente o líder: "Use subagentes somente leitura para auditar /product, /locations e /blog em paralelo. Reporte por arquivo e linha."
2. Reúna e edite: o líder remove duplicatas, ordena por gravidade e é o único que edita, para que os trabalhadores não colidam.
3. Revise: execute um revisor novo, como a skill /code-review incluída, sobre o diff.

Avançado: várias sessões, um líder, você como último filtro

Este é um padrão de trabalho montado com recursos documentados, não um modo nativo. A documentação descreve um líder nativo apenas para as agent teams, que são experimentais e vêm desativadas por padrão; ali, os pedidos de permissão dos colegas aparecem na sessão líder, com um custo maior de tokens.

• Mesma lógica: os arquivos CLAUDE.md do projeto e as configurações de permissão podem ser compartilhados pelo controle de versão.
• Arquivos separados: claude --worktree schema-fixes inicia uma sessão na sua própria branch em .claude/worktrees/; a documentação de worktrees sugere adicionar essa pasta ao .gitignore.
• Mensagens: a troca de mensagens entre sessões permite que o Claude liste as suas outras sessões e envie a elas texto simples. Exige o Claude Code 2.1.224 ou posterior (2.1.234 no Windows nativo).

1. Faça o commit das regras e divida por arquivos: toda sessão começa igual, e duas sessões nunca compartilham um arquivo.
2. Dê nome às sessões com --name ou /rename; confira-as com /list-agents ou mencione uma com @name.
3. O líder atribui por mensagem; os trabalhadores fazem o commit e devolvem um resumo por mensagem.
4. O líder revisa cada diff, executa as verificações e rejeita edições fora do escopo. Você revisa a lista curta dele.

Prática segura e o que o Google diz sobre conteúdo de IA

• Leia todo diff. A página de segurança da Anthropic diz que você é responsável por revisar o código e os comandos propostos.
• Privilégio mínimo, sem segredos: permita leituras, pergunte nas escritas e nunca coloque chaves ou senhas em prompts, no CLAUDE.md nem em configurações com commit.

Uma ordem sensata para adotar tudo isso

1. Instale o Claude Code, abra a pasta de um cliente e execute git init se preciso.
2. Escreva um CLAUDE.md curto, negue Read(./.env) e passe para o modo Manual nos arquivos de clientes.
3. Execute uma auditoria somente leitura no modo de plano.
4. Conecte o ZeusSEO e permita apenas as ferramentas de leitura.
5. Faça uma mudança em massa numa branch, com uma verificação.
6. Adicione um subagente revisor somente leitura, depois uma segunda sessão no seu próprio worktree e depois um líder com nome.

Gerencia muitos locais? A mesma abordagem serve para os nossos guias sobre vários locais, otimização do perfil e respostas a avaliações. O seu próximo passo é o guia do MCP do Google Business Profile, que conecta o conector do ZeusSEO. Se você prefere ler sobre um especialista pronto em vez de montar o seu, há também a Athena (em acesso antecipado).