Servidor MCP de SEO para agentes de IA

Dá ao Claude Code, ao Cursor, ao Zed ou a qualquer agente Model Context Protocol a mesma auditoria de 91 regras que move o painel do MetricSpot. Seis ferramentas, um único endpoint HTTP, sem código de cola.

Sem cartão. Resultados em 30 segundos.

Ou cola simplesmente um URL: a mesma auditoria, sem instalar nada.

Atualizado

Instala o servidor MCP de SEO no teu agente

O servidor MCP do MetricSpot está ativo em https://mcp.metricspot.com sobre Streamable HTTP, e no npm como @metricspot/mcp-server para stdio local. A maioria dos agentes pede apenas uma linha de configuração. A ferramenta de auditoria anónima funciona sem chave (1 auditoria por IP a cada 24 horas); as outras 5 ferramentas aceitam um Bearer token gerado a partir do teu painel MetricSpot.

Claude Code

CLI oficial da Anthropic. Reinicia a sessão depois de adicionar.

claude mcp add metricspot --transport http https://mcp.metricspot.com/mcp

Cursor

Adiciona a ~/.cursor/mcp.json e recarrega o Cursor.

{
  "mcpServers": {
    "metricspot": {
      "url": "https://mcp.metricspot.com/mcp"
    }
  }
}

Zed

Adiciona a ~/.config/zed/settings.json.

{
  "context_servers": {
    "metricspot": {
      "command": {
        "url": "https://mcp.metricspot.com/mcp"
      }
    }
  }
}

Claude Desktop

Adiciona a ~/Library/Application Support/Claude/claude_desktop_config.json no macOS e reinicia o Claude Desktop.

{
  "mcpServers": {
    "metricspot": {
      "url": "https://mcp.metricspot.com/mcp"
    }
  }
}

ChatGPT

Os conectores MCP personalizados exigem um plano ChatGPT Pro, Team ou Enterprise. Adiciona em Definições, Conectores.

{
  "name": "MetricSpot",
  "url": "https://mcp.metricspot.com/mcp",
  "headers": {
    "Authorization": "Bearer ms_live_xxx"
  }
}

Gemini

Usa a configuração MCP do CLI do Gemini. Precisa de uma versão do CLI do Gemini que suporte servidores MCP remotos.

gemini mcp add metricspot --transport http https://mcp.metricspot.com/mcp

Seis ferramentas expostas pelo servidor MCP

Cada ferramenta corre o mesmo motor de auditoria que o app.metricspot.com. Sem lacunas de funcionalidades, sem dados de segunda categoria. As descrições, entradas e saídas são validadas com esquemas Zod, por isso os agentes recebem respostas estritas e previsíveis.

run_audit_anonymous Sem chave API

Corre uma auditoria pontual de SEO e legibilidade para IA sobre qualquer URL público. Devolve pontuações em 11 módulos e cerca de 90 verificações, mais findings acionáveis com ligações para a documentação. Limitada a 1 auditoria por IP a cada 24 horas.

Entrada:
url
Saída:
Envelope de auditoria completo com pontuações por módulo, findings e URL do relatório.
run_audit Chave API necessária

Coloca em fila uma auditoria completa de SEO e legibilidade para IA. Inclui Core Web Vitals do Google PSI e tráfego orgânico se tiveres o Google Search Console ligado. Devolve de imediato com status: queued e um audit_id.

Entrada:
url
Saída:
Envelope de auditoria com audit_id, status e indicação de polling.
get_audit Chave API necessária

Recupera por id uma auditoria já executada. Devolve as pontuações por módulo (0-100), a pontuação total, cada finding com severidade e texto de recomendação, e ligações para os relatórios HTML e PDF.

Entrada:
audit_id
Saída:
Envelope de auditoria com status, total_score, module_scores, findings.
list_audits Chave API necessária

Lista as auditorias do utilizador, mais recentes primeiro, desduplicadas por URL. Devolve audit_id, url, status, total_score e created_at. Limite por defeito 24, máximo 100.

Entrada:
limit (opcional)
Saída:
Array de resumos de auditoria.
get_audit_pdf Chave API necessária

Devolve um URL assinado para descarregar o relatório PDF com a tua marca. Se ainda não houver PDF renderizado, coloca o render em fila e devolve status: queued para que o agente volte a chamar a mesma ferramenta.

Entrada:
audit_id
Saída:
URL assinado do PDF ou estado queued.
get_organic_traffic Chave API necessária

Devolve o snapshot de 28 dias de tráfego orgânico para uma auditoria, se o utilizador tiver o GA4 e o Google Search Console ligados. Inclui sessões, tendência diária, principais páginas de aterragem, principais queries e saúde de indexação.

Entrada:
audit_id
Saída:
Snapshot de tráfego orgânico ou estado not-linked.

Porquê usar um servidor MCP em vez de uma API REST ou de uma auditoria manual

O MCP foi pensado para agentes de IA: as descrições das ferramentas, os esquemas tipados e a autenticação viajam com a ligação. O agente consegue planear uma auditoria multipasso (correr, fazer polling, resumir, gerar PDF, aprofundar findings) sem que escrevas código de cola.

Funcionalidade Auditoria SEO manual Outras APIs de SEO MCP do MetricSpot
Tempo de configuração Horas por site, repetidas em cada execução Horas: ler docs, escrever cliente, tratar auth, parsear JSON Uma linha de configuração no teu cliente MCP
Nativo para agentes Não: humano no ciclo em cada passo Parcial: os agentes podem chamar REST, mas com wrappers escritos à mão Sim: descrições, esquemas e rate limits viajam com a ligação
Verificações de legibilidade para IA Raro: a maioria dos templates é anterior ao llms.txt e aos AI Overviews Limitado: a maioria das APIs foca-se em backlinks e keywords 11 regras dedicadas a IA, pontuadas a par do SEO clássico
PDF em marca branca Exportação manual, rebrand manual Normalmente não oferecido, ou apenas no plano mais caro O get_audit_pdf devolve um PDF com a tua marca em todos os planos pagos
Teste anónimo Não aplicável Quase nunca disponível sem conta paga O run_audit_anonymous funciona sem chave, 1 por IP a cada 24 horas
Modelo de preços Faturação à hora Medição por chamada, frequentemente por keyword ou por domínio Planos mensais fixos, alinhados com o painel

Preços do servidor MCP

O servidor MCP está incluído em cada plano pago do MetricSpot: os mesmos créditos de auditoria, os mesmos módulos, o mesmo render de PDF. A ferramenta de auditoria anónima é gratuita e funciona sem conta. As ferramentas autenticadas consomem a mesma quota mensal de auditorias que vês no painel.

Free

$0/mo

Experimenta a plataforma. Sem cartão, sem compromisso.

  • ·10 auditorias por mês (1 por site a cada 24h)
  • ·Os dez módulos de pontuação
  • ·Download PDF com a nossa marca
  • ·Relatórios multilingues

Starter

$29/mo

Para freelancers com relatórios mensais.

  • ·Até 5 domínios em seguimento
  • ·50 auditorias por mês
  • ·Relatórios PDF totalmente em marca branca
  • ·Brand kit personalizado (logo, cor, rodapé)

Pro

$49/mo

Para agências, freelancers e revendedores.

  • ·Tudo o do Starter
  • ·Re-auditorias agendadas (semanal, quinzenal ou mensal)
  • ·Domínios em seguimento ilimitados
  • ·Envio de relatórios diretamente ao cliente por email

Ver limites e preços dos planos →

Que agentes de IA podem usar este servidor MCP

Qualquer cliente compatível com MCP pode ligar-se por Streamable HTTP, ou correr o servidor localmente como subprocesso stdio através do pacote npm @metricspot/mcp-server. Abaixo estão os agentes que testamos hoje.

  • •Claude Code: CLI oficial da Anthropic para o Claude, com suporte MCP de primeira classe.
  • •Cursor: o editor de código AI-first. Adiciona em ~/.cursor/mcp.json.
  • •Zed: o editor de alto desempenho. Adiciona em ~/.config/zed/settings.json.
  • •Claude Desktop: a app para macOS e Windows, configurada via claude_desktop_config.json.
  • •ChatGPT (Pro, Team, Enterprise): conectores MCP personalizados em Definições, Conectores.
  • •Gemini CLI: pela configuração MCP do CLI do Gemini.

Correr o MetricSpot a partir de um agente é metade da história da descoberta por IA. A outra metade é tornar o teu próprio site legível para o ChatGPT, o Perplexity e o Google AI Overviews: vê as nossas verificações de visibilidade em pesquisa IA para as 11 regras que o MetricSpot corre em cada página.

Perguntas frequentes

O que é o MCP e porque é que uma ferramenta de SEO precisa de um?

Model Context Protocol é uma norma aberta da Anthropic para ligar agentes de IA a ferramentas externas. Em vez de pedires ao teu agente que faça scraping da UI do MetricSpot ou escrevas à mão um cliente REST, dás-lhe o URL do nosso servidor MCP e ele descobre automaticamente cada ferramenta, esquema e requisito de autenticação. Para trabalho de SEO, isto significa que um agente pode auditar um site, resumir os findings, ir buscar um PDF e aprofundar regras individuais numa única conversa.

Preciso de uma chave API para usar o servidor MCP?

Apenas para 5 das 6 ferramentas. A ferramenta run_audit_anonymous funciona sem chave nenhuma, com um limite de 1 auditoria por IP a cada 24 horas: suficiente para experimentar o servidor de ponta a ponta. As outras ferramentas (run_audit, get_audit, list_audits, get_audit_pdf, get_organic_traffic) precisam de um Bearer token. Pede-o no teu painel MetricSpot assim que te inscreveres em qualquer plano, incluindo o Free.

Que clientes MCP são suportados?

Qualquer cliente que fale MCP sobre Streamable HTTP funciona. Testamos contra Claude Code, Cursor, Zed, Claude Desktop, ChatGPT (Pro, Team, Enterprise) e o CLI do Gemini. O protocolo é aberto, por isso outros clientes também devem funcionar: se o teu não funcionar, abre uma issue.

Que transportes é que o servidor suporta?

Ambos os transportes estão ativos hoje. Streamable HTTP em https://mcp.metricspot.com/mcp é o caminho mais simples: uma linha de configuração, sem instalar nada. Para agentes que prefiram correr o servidor como subprocesso local, instala o pacote npm @metricspot/mcp-server e aponta o teu cliente para `npx -y @metricspot/mcp-server`.

Quais são os rate limits?

A ferramenta anónima está limitada a 1 auditoria por IP a cada 24 horas. As ferramentas autenticadas consomem a quota mensal de auditorias do teu plano: o mesmo número que vês na página de preços. Não há quota MCP separada nem custo por chamada.

Qual a diferença entre auditorias anónimas e autenticadas?

O mesmo motor de auditoria, as mesmas 91 regras, os mesmos 11 módulos de pontuação. As auditorias autenticadas acrescentam Core Web Vitals (via Google PageSpeed Insights), dados de tráfego orgânico se tiveres o Google Search Console ligado, reexecuções agendadas e acesso ao relatório PDF com a tua marca. As auditorias anónimas estão pensadas para verificações rápidas e demonstrações.

Posso correr isto em CI ou numa tarefa agendada?

Sim. O endpoint Streamable HTTP é stateless do ponto de vista do agente: podes chamá-lo a partir de qualquer runner de CI, scheduler ou função serverless que fale MCP. Usa o run_audit para colocar em fila e depois faz polling com o get_audit até o status estar complete. Combina com o get_audit_pdf se quiseres enviar por email um relatório com a tua marca depois de cada execução.

Onde reporto bugs ou peço novas ferramentas?

Abre uma issue em github.com/MetricSpot/mcp-server (preferido) ou envia email para info@metricspot.com . Os pedidos de ferramentas vindos de agentes em produção são prioritários. O servidor MCP é open source sob licença MIT.

Deixa de escrever relatórios de SEO à mão.

Corre uma auditoria, marca o PDF, envia ao cliente. Em cinco minutos.

Começa a tua primeira auditoria