Pergunte ao Claude, ao Cursor e a outros assistentes de IA sobre o seu SEO

1. Crie uma API key

No serp.ac, abra Configurações → API e crie uma chave (apenas o proprietário da conta e os administradores podem fazer isso). Copie-a — ela é exibida uma única vez. O servidor MCP usa as mesmas chaves, o mesmo limite de requisições (120 requisições por minuto por chave) e as mesmas cotas da REST API. Cada chave dá acesso total à conta que a criou, então mantenha-a em segredo e revogue-a na mesma página se ela vazar.

2. Conecte o Claude

Claude (claude.ai e os apps do Claude) — conector personalizado

Acesse Settings → Connectors → Add custom connector, dê o nome serp.ac e use a URL do servidor https://serp.ac/api/mcp. O servidor autentica cada requisição com sua API key enviada como Authorization: Bearer sk_live_…; se a janela do conector no seu plano não permitir enviar esse cabeçalho, use a configuração do Claude Desktop abaixo.

Claude Desktop — arquivo de configuração

Abra Settings → Developer → Edit config e adicione o servidor ao claude_desktop_config.json. Ele roda a ponte mcp-remote (requer Node.js), que encaminha sua chave como cabeçalho. Depois, reinicie o Claude Desktop.

{
  "mcpServers": {
    "serp-ac": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://serp.ac/api/mcp", "--header", "Authorization:${SERP_AC_AUTH}"],
      "env": { "SERP_AC_AUTH": "Bearer sk_live_..." }
    }
  }
}

Claude Code

claude mcp add --transport http serp-ac https://serp.ac/api/mcp \
  --header "Authorization: Bearer sk_live_..."

3. Conecte o Cursor e outros clientes

Cursor: adicione o servidor ao ~/.cursor/mcp.json (todos os projetos) ou ao .cursor/mcp.json de um projeto e ative-o em Settings → MCP.

{
  "mcpServers": {
    "serp-ac": {
      "url": "https://serp.ac/api/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

Qualquer outro cliente MCP (ChatGPT, VS Code, Windsurf, seu próprio agente) funciona da mesma forma, desde que suporte o transporte Streamable HTTP e consiga enviar o cabeçalho Authorization. Clientes que só suportam stdio podem usar a ponte mcp-remote mostrada acima.

Teste rápido pelo terminal:

curl https://serp.ac/api/mcp \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Modo somente leitura

Ferramentas marcadas com Altera dados adicionam itens à sua conta, e as marcadas com Usa cota consomem suas cotas mensais; os assistentes são instruídos a perguntar antes. Para expor apenas as ferramentas de leitura, conecte com https://serp.ac/api/mcp?readonly=1. O modo somente leitura é uma configuração da conexão, não da chave — uma chave sempre tem todos os direitos da conta.

Ferramentas

Cada ferramenta responde com um resumo curto mais os mesmos dados em JSON estruturado. As listas são limitadas (até 200 linhas) e contêm apenas os dados da sua própria conta. Os projetos podem ser referenciados pelo id ou pelo domínio.

• list_projectsLeitura

  Lista os projetos (sites) do serp.ac nesta conta, com ids, domínios e quantas palavras-chave, prompts de IA e links comprados cada um monitora. Chame esta primeiro para obter os ids dos projetos.

• get_rankingsLeitura

  Posições no Google das palavras-chave monitoradas de um projeto: posição atual, variação desde a verificação anterior (positivo = subiu), URL ranqueada, se um Google AI Overview é exibido e cita o site, e o horário da última verificação. Filtros opcionais por texto da palavra-chave e por dispositivo.

• get_ai_visibilityLeitura

  Visibilidade em IA de um projeto no ChatGPT, Perplexity, Gemini, Claude e Google AI Mode: parcela de respostas que mencionam a marca, taxa de citação, posição média, números por mecanismo, uma matriz prompt × mecanismo, principais domínios citados como fonte, share of voice e outras marcas que os assistentes de IA recomendam.

• get_backlinks_summaryLeitura

  Visão geral de backlinks de um projeto: total de backlinks e domínios de referência, rank do domínio, parcela dofollow, links novos nos últimos 30 dias, links perdidos e os domínios de referência mais fortes.

• list_purchased_linksLeitura

  Links comprados (pagos) monitorados na Gestão de links: status (pending, active, issue, lost, expired, cancelled = pausado), problemas detectados, preço, ciclo de cobrança, próxima data de pagamento / renovação e fornecedor, além dos pagamentos que vencem nos próximos 30 dias. Todos os projetos, a menos que um projeto seja informado.

• get_index_jobLeitura

  Status de um job de verificação de indexação iniciado com check_index, com o status de indexação de cada URL (indexed, not_indexed, queued, error).

• get_usageLeitura

  O plano e o status da assinatura da conta, os limites do plano com o uso atual (projetos, palavras-chave, prompts de IA, links) e as cotas mensais restantes (envios ao indexador, verificações de indexação, consultas de dados de palavras-chave).

• get_maps_rankingsLeitura

  Monitoramento de posições no Google Maps (geo-grid local) de um projeto: sem campanha, todas as campanhas do Maps com a pontuação de presença local mais recente (0–100), cobertura no top 10 e posição média; com campanha (id ou texto da palavra-chave), a posição da última varredura em cada ponto da grade, o histórico de varreduras, os concorrentes que ranqueiam acima e o local pack.

• track_keywordsAltera dados

  começa a monitorar as posições no Google de novas palavras-chave em um projeto. Cada nova palavra-chave conta no limite de palavras-chave SERP do plano; palavras-chave já monitoradas ficam inalteradas. Pergunte ao usuário antes de adicionar muitas palavras-chave.

• add_ai_promptsAltera dados

  adiciona prompts (perguntas que as pessoas fazem aos assistentes de IA) ao monitoramento de visibilidade em IA de um projeto; eles passam a rodar de forma programada. Cada novo prompt conta no limite de prompts de IA do plano; prompts já monitorados ficam inalterados.

• add_purchased_linkAltera dados

  adiciona um link comprado (pago) à Gestão de links de um projeto, para que o serp.ac o verifique diariamente e lembre dos pagamentos. Conta no limite de links monitorados do plano. Falha com already_tracked se o mesmo link origem → destino já existir.

• check_indexUsa cota

  inicia um job que verifica se as URLs estão indexadas no Google. Cada URL usa 1 verificação de indexação da cota mensal (depois dos pacotes comprados); nada é cobrado se não houver saldo suficiente. Retorna um id de job — chame get_index_job para obter os resultados.

• get_keyword_dataUsa cota

  volume de busca, CPC, concorrência, dificuldade da palavra-chave, intenção de busca e tendência de 12 meses por palavra-chave. Cada palavra-chave que ainda não está em cache conta na cota mensal paga de consultas de palavras-chave da conta (palavras-chave em cache são grátis); para listas grandes, verifique get_usage antes.

Limites e erros

• As ferramentas de escrita seguem o seu plano exatamente como o painel e a REST API: limites de palavras-chave, prompts e links, mecanismos de IA incluídos no plano e um plano ou teste ativo.
• check_index usa 1 verificação de indexação por URL da cota mensal e depois dos pacotes; get_keyword_data usa a cota mensal de consultas de palavras-chave para palavras-chave que não estão em cache. Nada é cobrado quando a cota não é suficiente.
• Problemas em uma chamada (projeto desconhecido, argumentos inválidos, limite atingido) voltam como um erro de ferramenta que o assistente consegue ler. Uma chave ausente ou revogada retorna HTTP 401, uma conta suspensa 403 e requisições demais 429.

Quer automatizar sem um assistente de IA? Veja a referência da REST API em Configurações → API.