Servidor MCP para SEO com agentes de IA

Um servidor MCP local via stdio expõe as mesmas ferramentas para Claude Code, Claude Desktop, Codex, Cursor e outros clientes MCP. O registro é mostrado antes de qualquer arquivo ser alterado.

O que faz

Perfis

--profile full expõe todas as ferramentas. Os perfis audit, infra, quick-check e router expõem conjuntos menores para sessões focadas, então o agente vê menos schemas. O perfil router anuncia apenas um diagnóstico (doctor), a inspeção de URL, o fluxo de auditoria e o catálogo de ferramentas, e o agente encontra as demais pelo catálogo. Um perfil mais restrito bloqueia de imediato as ferramentas excluídas, enquanto o cliente precisa ser reiniciado para ver as recém-habilitadas.

  • audit: ferramentas limitadas de auditoria do Screaming Frog
  • infra: verificações de domínio, CDN, tecnologia, segurança, cabeçalhos HTTP, robots e sitemap
  • quick-check: verificações rápidas de URL, incluindo a verificação em lote
  • seohead mcp status --json mostra o perfil e a contagem exata de ferramentas

Registro seguro

O registro começa com um plano. Rode seohead mcp install com --dry-run para ver o bloco de configuração, o arquivo que seria alterado, o caminho do backup e o SHA-256 original. Nada é gravado. Adicione --yes para aplicar. A configuração do cliente recebe backup, é substituída de forma atômica e validada de novo, e os outros servidores nela são mantidos.

  • Clientes: Claude Code, Claude Desktop, Codex e Cursor, escolhidos com --client
  • --expected-sha256 recusa a instalação se o arquivo mudou depois da prévia
  • seohead mcp uninstall restaura a partir do backup
  • seohead mcp disable impede o servidor de aceitar chamadas

Agentes com memória

Os projetos guardam escopo, política de rastreamento, scans e histórico, então o próximo agente continua do projeto salvo, e não do chat. Uma caixa de entrada do projeto guarda as anotações do especialista e as metas propostas. Um host também pode limitar um processo MCP a um nome de consumidor e a uma lista de pastas de projeto permitidas.

  • workflow-status indica ao novo agente o próximo passo registrado
  • As gravações usam a revisão atual e falham em caso de conflito
  • Operações pagas exigem confirmação explícita, como confirm_paid=true

Três passos, um rastreamento salvo

  1. Faça a prévia do registro

    Rode a instalação com --dry-run primeiro. Ela mostra o bloco exato de configuração, o arquivo que seria alterado, o caminho do backup e um sha256, e não grava nada.

  2. Instale com --yes

    Depois de ler o plano, adicione --yes. A configuração anterior recebe backup ao lado, e --expected-sha256 recusa a instalação se o arquivo mudou depois da prévia.

  3. Agentes continuam o projeto salvo

    Os projetos guardam escopo, política de rastreamento, scans e histórico. O próximo agente retoma o projeto salvo, em vez de começar pelo chat.

Verificações deste recurso

VerificaçãoO que significaGravidadeEvidência
REDIRECT_LOOPUma cadeia de redirecionamentos volta a uma URL já visitada, então nunca se resolveCriticalCaminho do loop na cadeia de redirecionamentos (exportação Redirect Chains do Screaming Frog ou registros de cada salto de um rastreamento nativo)
BROKEN_INTERNAL_LINKUm link interno aponta para uma URL que retorna 4xxCriticalLinks de entrada Client Error (4xx): página de origem e posição do link
REDIRECT_CHAINMais de um salto antes da URL finalImportantCada salto, com o código de status e o cabeçalho Location
INTERNAL_LINK_TO_REDIRECTUm link interno aponta para uma URL 3xx em vez da página finalImportantLinks de entrada Redirection (3xx): página de origem e posição no DOM
BAD_REDIRECT_TYPEUm 302, 303 ou 307 é usado quando a intenção é uma mudança permanenteTipCódigo de status de cada salto

Um comando

bash
claude mcp add seohead -- /absolute/path/to/spiderhead/.venv/bin/seohead mcp

Instale primeiro: guia de instalação. Todo comando também funciona como ferramenta MCP para agentes de IA.

O que você precisa

  • Um cliente MCP: Claude Code, Claude Desktop, Codex, Cursor ou qualquer cliente stdio
  • O executável seohead de um ambiente virtual, com caminho absoluto
  • O extra mcp do toolkit instalado
  • Chaves de provedores apenas para ferramentas pagas ou que dependem de conta

Limites

  • É um servidor stdio local. Não há endpoint MCP hospedado
  • Ainda não há diário de chamadas, então mantenha o seu próprio registro se precisar de trilha de auditoria
  • Ferramentas podem enviar requisições quando você pede uma verificação ou um rastreamento. Leia o catálogo para ver quais
  • Instalar a entrada não ativa o MCP por si só, e nada é gravado sem --yes

Perguntas

Registrar o servidor altera minha configuração?
Na prévia, não. O --dry-run não grava nada e mostra o arquivo que seria alterado (no Claude Code, ~/.claude.json), o caminho do backup e um sha256. A mudança só acontece com --yes.
Quais clientes são compatíveis?
Claude Code, Claude Desktop, Codex e Cursor, escolhidos com --client. Qualquer outro cliente MCP pode usar o mesmo comando do servidor stdio.
Quantas ferramentas um agente vê?
Depende do perfil. O perfil full expõe todas as ferramentas registradas, e audit, infra, quick-check e router expõem conjuntos bem menores. Rode seohead mcp status --json para ver a contagem exata de cada perfil na sua instalação.
O servidor roda na nuvem?
Não. É um processo stdio local. As requisições de rede saem só para as verificações que você dispara, como uma URL ou um rastreamento. Um rastreamento grava o scan em ./scans/ por padrão.
Um agente pode gastar meu dinheiro?
Não sem aviso. Operações pagas exigem confirmação explícita (confirm_paid=true) e as suas próprias chaves de provedor. O tool-catalog marca quais ferramentas podem gastar dinheiro.
Como desligo?
Rode seohead mcp disable. Um servidor em execução passa a recusar novas chamadas de ferramentas. O uninstall remove a entrada da configuração do cliente e a restaura a partir do backup.

Teste no seu próprio site