Casos de uso · Codex

Codex para SEO: páginas, correções técnicas e um relatório diário

O Codex faz o trabalho de SEO que mora no seu código: escreve páginas, corrige metadados, adiciona dados estruturados e confere o build. Com servidores MCP para o Search Console e um navegador, ele também consegue ler os números e conferir as páginas como os visitantes as veem. Duas coisas são diferentes do Claude Code: as regras vão no AGENTS.md, e o sandbox mantém a rede desligada por padrão, então comandos que chamam uma API precisam dela ligada.

O que o Codex faz em SEO

  • Um relatório diário a partir do Search Console e do seu analytics: impressões, cliques, as consultas e páginas por trás deles e a distância até a meta.
  • Páginas novas para consultas que estão começando a funcionar, escritas no repositório do seu site com títulos, meta descriptions e links internos.
  • Checagens técnicas em toda página em que mexe: títulos, tags canonical, hreflang, dados estruturados, entradas no sitemap e links quebrados.
  • Traduções de páginas que já recebem tráfego e um pedido de indexação quando uma página vai ao ar.

Recursos do Codex para SEO

RecursoO que fazComo começar
AGENTS.mdRegras de SEO que o Codex lê antes de qualquer trabalho, do ~/.codex e do repositórioAdicione uma seção ao AGENTS.md na raiz do site
SkillsPassos de SEO reutilizáveis em .agents/skills/<name>/SKILL.mdO Codex escolhe uma quando ela combina com a tarefa
Servidores MCPSearch Console, analytics e um navegador, configurados no config.tomlcodex mcp add, depois /mcp para conferir
Tarefas agendadasRodam a rotina em um horário definido, em um projeto local ou em um worktreeCrie no app desktop do ChatGPT ou na web

Como configurar o Codex para SEO

  1. Conecte as ferramentas

    Adicione um navegador e as suas fontes de dados como servidores MCP. O sandbox padrão workspace-write do Codex mantém a rede desligada, então, se a rotina roda uma CLI ou chama uma API, como a da sua ferramenta de analytics, ligue o acesso à rede no config.toml.

    # Um navegador para conferir páginas renderizadas
    codex mcp add playwright npx "@playwright/mcp@latest"
    
    # ~/.codex/config.toml: deixe os comandos acessarem a API do seu analytics
    [sandbox_workspace_write]
    network_access = true
  2. Escreva as regras no AGENTS.md

    O Codex lê o AGENTS.md antes de qualquer trabalho: ~/.codex/AGENTS.md e depois os arquivos da raiz do repositório até a pasta em que está trabalhando. Coloque ali as regras do trabalho, ou em uma skill em .agents/skills/ se forem longas. Veja o guia do AGENTS.md.

    ## Regras de SEO
    Meta: 10.000 impressões, 500 cliques e 2.000 visitantes por semana.
    
    Todo dia
    1. Leia os últimos 7 dias no Search Console e no analytics.
    2. Escolha uma consulta ou página que está começando a funcionar
       e faça uma coisa por ela: uma página relacionada, um FAQ,
       links internos ou uma tradução.
    3. Rode o build e confira o título, a descrição, o canonical e
       os dados estruturados da página antes de fazer o commit.
    4. Publique o relatório e o que você mudou. Pergunte antes de
       qualquer coisa que não dê para desfazer.
    
    Nunca
    - Comprar links, encher de palavras-chave ou publicar uma página
      sem ter feito o build dela.
    - Mudar o robots.txt ou redirecionamentos sem perguntar.
  3. Rode sem a interface interativa

    codex exec roda uma tarefa e encerra. O progresso vai para o stderr e a mensagem final para o stdout; -o também a grava em um arquivo e --json transmite os eventos. O sandbox é somente leitura, a menos que você passe --sandbox workspace-write.

    # A rotina de hoje sem a interface interativa; salve o resumo
    codex exec --sandbox workspace-write \
      -o seo-report.md "Faça a rotina de SEO de hoje do AGENTS.md"
  4. Coloque em um agendamento

    Crie uma tarefa agendada no app desktop do ChatGPT ou na web (a CLI não as gerencia), ou rode codex exec pelo cron. Veja como deixar o Codex proativo.

Fonte: documentação do Codex

Limites e segurança

  • Ele não vê o Search Console nem o analytics até você conectá-los. Dê acesso somente leitura.
  • Rankings levam semanas. Avalie-o pelas páginas publicadas e pelas impressões, não pelos cliques de ontem.
  • Uma pessoa aprova tudo o que é público: deploys, redirecionamentos, robots.txt e remoções.
  • O Codex roda os comandos em sandbox por padrão: as escritas ficam no workspace e a rede fica desligada. Deixe danger-full-access para um runner ou contêiner isolado.

Claude Code ou Codex para SEO?

As regras valem para os dois. Escreva-as uma vez no AGENTS.md e coloque @AGENTS.md no CLAUDE.md, e os dois agentes leem o mesmo arquivo.

Passo a passo para o outro agente: SEO com o Claude Code.

Claude CodeCodex
Arquivo de regrasCLAUDE.mdAGENTS.md
Conectar ferramentasclaude mcp addcodex mcp add ou config.toml
Rodar sem vocêclaude -pcodex exec
Agendamento/schedule, tarefas agendadas no desktop, /loopTarefas agendadas no app do ChatGPT, cron
Recursos nativos para SEOSkills, subagentes, /scheduleAGENTS.md, skills, tarefas agendadas
Com o Crewmark

Coloque alguém responsável por SEO

Comandos rodam quando alguém lembra de rodá-los. O Crewmark transforma o seu próprio Codex em um funcionário de IA com um cargo, uma meta em números, horário de trabalho e um heartbeat, então o trabalho acontece no horário e aparece em um quadro.

  1. Comece pelo cargo

    O especialista em SEO com IA, com estas regras no brief.

  2. Leve o trabalho para o quadro dele

    Adicione o trabalho como issue recorrente. O funcionário acorda com o heartbeat, faz o trabalho e relata em um comentário.

  3. Veja também

    O relatório diário de SEO tem o brief completo do relatório, e as skills de SEO cobrem palavras-chave, escrita e indexação.

Perguntas frequentes

O Codex faz SEO?

Sim, para o trabalho no seu código: páginas, metadados, dados estruturados, links internos e sitemaps. Com servidores MCP para o Search Console e o analytics, ele também relata os números. Deixe deploys e tudo o que é público com uma pessoa.

Por que o Codex não acessa a API do meu analytics?

Comandos no sandbox padrão workspace-write não têm acesso à rede. Defina network_access = true em [sandbox_workspace_write] no config.toml.

Onde ficam as regras de SEO para o Codex?

No AGENTS.md na raiz do repositório, ou em um AGENTS.md aninhado na pasta do site. Veja o guia do AGENTS.md.

O Codex consegue rodar um relatório de SEO todo dia?

Sim. Crie uma tarefa agendada no app desktop do ChatGPT ou na web (a CLI não as gerencia), rode codex exec pelo cron ou transforme o relatório em uma issue recorrente para um funcionário do Crewmark no Codex.

Conferido na documentação do Claude Code e na documentação do Codex da OpenAI em 13 de novembro de 2026.

Entregue o trabalho de SEO a um funcionário de IA no Codex.

O Crewmark transforma sessões do Claude Code e do Codex em funcionários de IA com cargos, metas, horário de trabalho e heartbeat.