SEO Perception
Search Console, rastreamento e tarefas de SEO, somente leitura dentro do Cursor e Claude.
Servidor MCP hospedado
npx add-mcp 'https://seoperception.com/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
SEO Perception
Search Console, rastreamento e suas tarefas de SEO em aberto — dentro do Cursor e do Claude.
O SEO Perception já armazena fatos semanais do Search Console, o rastreamento e Possibilidades — uma lista priorizada de tarefas para cada URL. O MCP permite que o Cursor e o Claude leiam esse mesmo workspace e elaborem a próxima edição. As ferramentas são somente leitura e nunca chamam o Google.
Endpoint hospedado
npx add-mcp 'https://seoperception.com/mcp'
- URL:
https://seoperception.com/mcp - Autorização:
Bearer <your MCP token> - Planos: Starter, Pro, Business ou Enterprise. Crie um token depois de entrar.
O Cursor e o Claude podem usar OAuth (consentimento do navegador) quando o cliente suportar Connect. Você também pode criar um token de acesso pessoal em Account → MCP. Cada segredo é exibido uma única vez. Armazene-o como SEOPERCEPTION_MCP_TOKEN.
Cursor
Adicione isto ao ~/.cursor/mcp.json ou ao .cursor/mcp.json do projeto:
{
"mcpServers": {
"seo-perception": {
"url": "https://seoperception.com/mcp",
"headers": {
"Authorization": "Bearer ${env:SEOPERCEPTION_MCP_TOKEN}"
}
}
}
}
Outros clientes MCP
Claude Desktop, Claude Code, VS Code e outros usam o mesmo endpoint remoto. Se um cliente suportar apenas MCP local, use a opção remota ou de proxy desse cliente com a URL e o token acima.
O que o editor está lendo
O MCP não é uma ferramenta de SEO mais enxuta. É o produto que você já usa, aberto a partir do Cursor ou do Claude.
Os dados
Fatos semanais do Search Console, o rastreamento e o histórico de páginas. As consultas permanecem vinculadas à URL. O MCP lê o que já está armazenado. Ele não chama o Google.
O workspace
As mesmas páginas, consultas e evidências que você revisa no SEO Perception, inclusive na página ao vivo com a sobreposição do site.
A lista de tarefas
Possibilidades é a lista priorizada: o que fazer, em qual URL e por quê. O MCP retorna essa lista para que o editor possa elaborar a alteração.
Limite de dados
- O MCP nunca consulta novamente o Google Search Console ou a URL Inspection.
- As respostas usam dados que o SEO Perception já coletou para seus sites.
- Seu cliente MCP pode enviar as evidências retornadas ao provedor de modelo. Trate os resultados como análises sensíveis do site.
- Apenas planos pagos (Starter, Pro, Business, Enterprise).
Ferramentas
Apenas as ferramentas Disponíveis aparecem em tools/list.
Disponíveis
| Ferramenta | Nome | Status | O que faz |
|---|---|---|---|
seoperception_list_sites | Listar sites | Disponível | Lista sites próprios com frescor armazenado do GSC e do rastreamento. |
seoperception_get_site_overview | Visão geral do site | Disponível | Resume o desempenho de pesquisa armazenado, páginas principais, consultas e momentum de posição. |
seoperception_search_queries | Consultas de pesquisa | Disponível | Pesquisa e filtra evidências de consultas armazenadas por correspondência de conteúdo, faixa de posição, impressões, página de destino, CTR e intenção. Os filtros de conteúdo usam apenas linhas de correspondência armazenadas. |
seoperception_list_opportunities | Oportunidades de SEO | Disponível | Lista possibilidades limitadas e baseadas em evidências de rastreamento e Search Console. |
seoperception_find_cannibalization | Canibalização de palavras-chave | Disponível | Encontra conflitos de consultas armazenados e a página preferida determinística. |
seoperception_find_content_gaps | Lacunas de conteúdo e snippets | Disponível | Encontra oportunidades armazenadas de baixo CTR, consultas ausentes, título/snippet, perguntas e atualização. |
seoperception_suggest_internal_links | Sugestões de links internos | Disponível | Retorna oportunidades armazenadas de destino e texto âncora sem rastrear ou sondar URLs. |
seoperception_get_page_diagnostics | Diagnóstico de página | Disponível | Combina metadados de rastreamento de uma página, tendências armazenadas do GSC, principais consultas e possibilidades. |
seoperception_find_content_decay | Decaimento de conteúdo | Disponível | Detecta declínios sustentados armazenados de cliques e posição em linhas abertas de candidatos a atualização. Um resultado vazio significa que ainda não há nenhum armazenado. |
Planejadas
| Ferramenta | Nome | Status | O que faz |
|---|---|---|---|
seoperception_compare_periods | Comparação de períodos | Planejada | Compara períodos semanais armazenados explícitos com deltas determinísticos. |
seoperception_get_geo_breakdown | Detalhamento por país e dispositivo | Planejada | Lê fatos armazenados de país/dispositivo para sites Business e Enterprise. |
seoperception_generate_report | Relatório hospedado | Planejada | Cria um artefato de análise limitado e compartilhável. |
Permanentemente excluídas
| Ferramenta | Nome | Status | O que faz |
|---|---|---|---|
live_gsc_query_or_inspection | Chamadas ao Google ao vivo | Excluída | Consultas diretas ao GSC, URL Inspection, coleta e OAuth do Google são permanentemente excluídas. |
mutations_and_refreshes | Mutações e atualizações | Excluída | Recrawls, gravações de indexação, atualizações de problemas, atualizações de PSI e geração por LLM são excluídas. |
Exemplos de prompts
Prefira evidências observadas nos resultados das ferramentas em vez de recomendações inventadas.
- Listar sites. “Liste meus sites do SEO Perception e diga quais dados estão mais frescos.”
- Visão geral do site. “Resuma os maiores ganhos e perdas do meu site usando dados armazenados.”
- Consultas de pesquisa. “Encontre consultas sem marca nas posições 5–20 com pelo menos 50 impressões que estão ausentes na página de destino.”
- Oportunidades de SEO. “Mostre as oportunidades de SEO em aberto de maior prioridade e explique as evidências.”
- Canibalização de palavras-chave. “Encontre canibalização de palavras-chave e recomende qual página deve ser preferida.”
- Lacunas de conteúdo e snippets. “Encontre as maiores lacunas de conteúdo e snippets e sugira reescritas que correspondam às palavras-chave perdedoras.”
- Sugestões de links internos. “Sugira links internos e texto âncora natural para páginas com potencial de ranqueamento.”
- Diagnóstico de página. “Diagnostique /page1/ a partir do estado de rastreamento, principais consultas e oportunidades, e diga o que reescrever primeiro.”
- Decaimento de conteúdo. “Quais páginas mostram decaimento de conteúdo significativo?”
Limites de taxa
POST /mcp: 60/min por IP antes da autenticação, 120/min por token depois.- Chamadas de ferramenta: 30/min por combinação de usuário, token e site.
- Criação de token: 5 tentativas por usuário por hora.
Segurança
Nunca coloque sua senha de login ou cookie de sessão em uma configuração de cliente MCP. Gerencie tokens em Account → MCP.
Solução de problemas
- 401: crie um novo token em Account → MCP e atualize a variável de ambiente.
- 403
paid_plan_required: faça upgrade e depois crie um token. - 429: aguarde o tempo de nova tentativa na resposta.
- 406: envie
Accept: application/json, text/event-stream. - Listas vazias geralmente significam que ainda não há dados armazenados para esse site.
Perguntas frequentes
O que é um servidor MCP de SEO?
Um servidor MCP de SEO permite que o Cursor ou o Claude leiam seus dados armazenados do Search Console, o rastreamento e as Possibilidades em aberto, e depois elaborem a próxima edição em uma URL.
O MCP é um conjunto de dados separado?
Não. O MCP lê os mesmos fatos semanais do Search Console, o rastreamento e a lista de Possibilidades que você já usa no SEO Perception. Não há uma segunda cópia do seu site.
O MCP do SEO Perception chama o Google Search Console ao vivo?
Não. As ferramentas MCP leem fatos semanais armazenados do Search Console e evidências de rastreamento já coletadas no SEO Perception. A coleta acontece na sincronização do produto, não dentro da chamada de ferramenta MCP.
Quais clientes MCP são suportados?
Qualquer cliente MCP que possa chamar um endpoint HTTP remoto com um token Bearer funciona, incluindo Cursor, Claude Desktop, Claude Code e VS Code com uma extensão MCP.
Preciso de um plano pago?
Sim. Tokens de acesso pessoal MCP e o endpoint POST /mcp exigem Starter, Pro, Business ou Enterprise. Crie tokens em Account → MCP após o upgrade.
Guias
Esta página cobre configuração, tokens e o catálogo de ferramentas. As postagens abaixo explicam fluxos de trabalho, comparações e como executar SEO a partir do Cursor com evidências armazenadas.
- O que é um servidor MCP de SEO?
- Google Search Console MCP: API ao vivo vs. evidências armazenadas
- 7 fluxos de trabalho de SEO a partir do Cursor com MCP
- Transforme consultas do GSC em briefings de conteúdo com MCP
- Encontre canibalização de palavras-chave com um agente de IA e MCP
Próximo passo
O MCP está incluído em todos os planos pagos. Crie um token pessoal em Account → MCP, adicione a configuração acima e cole um dos exemplos de prompts.