O servidor MCP do Ranktracker já está em operação

Introdução

O servidor MCP do Ranktracker já está oficialmente em funcionamento.

Agora você pode conectar assistentes de IA e ferramentas de desenvolvimento compatíveis diretamente à sua conta do Ranktracker, incluindo ChatGPT, Claude, Cursor e outros clientes que suportam o Model Context Protocol.

Depois de conectado, você pode fazer perguntas sobre seu desempenho em SEO usando linguagem natural.

Por exemplo:

• Qual das minhas palavras-chave monitoradas teve a maior queda nesta semana?
• Mostre-me as palavras-chave que estão atualmente classificadas entre as posições 11 e 20.
• Quais palavras-chave ganharam visibilidade nos últimos 30 dias?
• Resuma a tendência de backlinks do meu site.
• Quais problemas técnicos foram detectados na minha última auditoria do site?
• Quais das minhas palavras-chave monitoradas aparecem na Visão Geral de IA?
• Mostre-me os backlinks descobertos mais recentemente.
• Qual é o status do meu último relatório de SEO?

O assistente de IA seleciona a ferramenta apropriada do Ranktracker, recupera com segurança os dados relevantes da conta e os utiliza para responder à sua pergunta.

Não é necessário exportar manualmente um CSV, alternar entre vários relatórios ou criar uma integração personalizada antes de começar a analisar seus dados.

O acesso ao MCP está incluído em todos os planos do Ranktracker.

Leia a documentação completa em:

https://developers.ranktracker.com/mcp

O que é o Protocolo de Contexto do Modelo?

O Protocolo de Contexto do Modelo, comumente conhecido como MCP, oferece uma maneira padronizada para que aplicativos de IA se conectem a ferramentas externas e fontes de dados.

Normalmente, um modelo de IA tem acesso apenas às informações contidas em sua conversa e a qualquer conhecimento geral disponível para ele. Ele não consegue visualizar automaticamente os projetos, palavras-chave, relatórios ou auditorias dentro da sua conta do Ranktracker.

Uma conexão MCP muda isso.

Depois que você autorizar o Ranktracker, o cliente de IA poderá identificar um conjunto definido de ferramentas do Ranktracker. Quando você fizer uma pergunta relevante, o cliente poderá escolher a ferramenta correta, fornecer os identificadores de conta necessários e recuperar os dados necessários para responder.

Em vez de navegar manualmente por várias seções do Ranktracker, você pode fazer a pergunta de forma coloquial.

Por exemplo, quando você pergunta:

Quais palavras-chave do example.com perderam mais posições neste mês?

O assistente pode:

1. Encontre o domínio monitorado relevante.
2. Recupere as palavras-chave rastreadas dele.
3. Analise o histórico de posicionamento.
4. Compare as posições atuais com as anteriores.
5. Resuma as perdas mais significativas.

O servidor MCP do Ranktracker gerencia a conexão entre o assistente de IA e sua conta.

Conecte o Ranktracker ao ChatGPT, ao Claude e ao Cursor

O servidor MCP do Ranktracker é um servidor remoto hospedado que funciona com clientes compatíveis com conexões MCP HTTP transmissíveis.

Ele pode ser conectado a:

• ChatGPT
• Claude Desktop
• Claude Code
• Cursor
• MCP Inspector
• Outros clientes MCP compatíveis
• Agentes de IA internos e ferramentas para desenvolvedores

O servidor está disponível por meio de um endpoint hospedado:

https://api.ranktracker.com/mcp

Você não precisa baixar nem hospedar um servidor Ranktracker separado.

Para a maioria das ferramentas interativas de IA, o OAuth é o método de conexão recomendado. Basta adicionar a URL do servidor Ranktracker ao cliente, aprovar o acesso pelo navegador e a conexão será criada automaticamente.

Não é necessário código personalizado

Uma das maiores vantagens do MCP é que você não precisa criar a integração por conta própria.

Com uma integração de API tradicional, um desenvolvedor geralmente precisa:

• Leia a documentação da API
• Crie solicitações para endpoints individuais
• Gerenciar a autenticação
• Processe a resposta
• Armazene ou exiba os dados
• Crie uma interface para o usuário

O servidor MCP do Ranktracker apresenta ferramentas claramente definidas diretamente ao cliente de IA.

O assistente identifica essas ferramentas automaticamente e decide quais usar com base na sua solicitação.

Isso significa que um usuário pode conectar o Ranktracker e começar a fazer perguntas sem precisar escrever código ou criar um aplicativo de relatórios separado.

Os desenvolvedores ainda podem usar a API REST do Ranktracker para sistemas totalmente automatizados, pipelines de dados programados e aplicativos personalizados. O MCP foi projetado para casos em que uma pessoa ou um agente de IA está explorando ativamente os dados.

A quais dados do Ranktracker os assistentes de IA podem acessar?

A versão inicial do Ranktracker MCP oferece 14 ferramentas.

Treze ferramentas são somente de leitura. Uma ferramenta adicional pode gerar com segurança uma nova execução de um relatório existente.

As ferramentas disponíveis abrangem sites rastreados, palavras-chave, classificações, concorrentes, pesquisa de palavras-chave, backlinks, relatórios e auditorias de sites.

Domínios monitorados

Seu assistente pode listar os domínios disponíveis na sua conta do Ranktracker e recuperar a configuração de um projeto específico.

Isso serve como ponto de partida para a maioria das conversas, pois os recursos do Ranktracker são conectados por meio de identificadores exclusivos de projeto.

Exemplos de perguntas incluem:

• Listar todos os sites da minha conta no Ranktracker.
• Encontrar meu projeto para example.com.
• Mostre-me a configuração de monitoramento para este domínio.
• Quais limites de monitoramento estão configurados para este projeto?

A conexão só tem acesso aos domínios pertencentes à conta do Ranktracker que a autorizou.

Palavras-chave rastreadas e classificações atuais

Seu assistente pode recuperar as palavras-chave rastreadas para um domínio, juntamente com seus resultados de classificação mais recentes.

Isso permite perguntar:

• Quais são minhas palavras-chave com melhor classificação?
• Quais palavras-chave estão atualmente na primeira página?
• Mostre-me as palavras-chave classificadas entre as posições 11 e 20.
• Quais palavras-chave monitoradas estão fora do Top 100?
• Quais palavras-chave estão pausadas no momento?
• Mostre-me as 50 principais palavras-chave para este domínio.

Por padrão, os dados das palavras-chave são ordenados pela melhor posição orgânica, permitindo que o assistente identifique rapidamente as melhores classificações atuais.

Movimentações históricas de classificação

O servidor MCP pode recuperar o histórico diário de classificação de uma palavra-chave rastreada específica.

Isso inclui:

• Posição orgânica
• Posição absoluta na SERP
• Posição no pacote local
• Possuir recursos da SERP
• Visibilidade da visão geral da IA
• Histórico de classificação em um intervalo de datas selecionado

O intervalo de datas padrão abrange o mês anterior, mas o cliente pode solicitar datas específicas de início e término.

Você pode fazer perguntas como:

• Como essa palavra-chave se comportou nos últimos 30 dias?
• Quando essa palavra-chave entrou no Top 10?
• Perdemos nosso snippet em destaque?
• Nossa posição no pacote local melhorou?
• Este domínio está incluído na Visão Geral de IA atual?
• Qual foi a melhor posição dessa palavra-chave neste mês?

Isso facilita a análise das mudanças no ranking sem precisar abrir e comparar manualmente gráficos individuais.

Dados da concorrência

O assistente pode listar os sites dos concorrentes configurados para um domínio monitorado.

Exemplos de perguntas incluem:

• Quais concorrentes estão sendo monitorados para este projeto?
• Liste os concorrentes associados ao site example.com.
• Estamos monitorando o site competitor.com?
• Resuma o conjunto de concorrentes para este site.

O servidor MCP recupera apenas os concorrentes que já foram configurados na conta do Ranktracker. Ele não adiciona automaticamente novos concorrentes nem altera as configurações do projeto.

Pesquisa no Keyword Finder

O assistente pode recuperar sessões de pesquisa existentes do Keyword Finder da sua conta.

Isso permite que você encontre e discuta pesquisas que já foram concluídas.

Você poderia perguntar:

• Mostre minhas últimas sessões de pesquisa de palavras-chave.
• Quais projetos de pesquisa de palavras-chave estão disponíveis?
• Encontre a sessão de pesquisa criada para nossa nova categoria de produtos.
• Resuma as pesquisas de palavras-chave disponíveis na minha conta.

A conexão com o MCP não inicia novas pesquisas de palavras-chave pagas. Ela apenas lê as sessões de pesquisa existentes, ajudando a evitar que um cliente de IA consuma cotas sem o seu conhecimento.

Monitoramento de backlinks

As ferramentas do Ranktracker MCP podem recuperar informações de backlinks para um domínio monitorado.

Os dados de backlinks disponíveis incluem:

• URL de origem
• URL de destino
• Texto âncora
• Status dofollow
• Pontuação de spam
• Classificação do domínio e da página
• Data da primeira visualização
• Data da última visualização

Isso significa que você pode perguntar:

• Mostre-me os backlinks mais recentes descobertos para o meu site.
• Quais novos backlinks são dofollow?
• Existem links suspeitos com alta pontuação de spam?
• Quais páginas receberam os links mais recentes?
• Qual texto âncora está sendo usado com mais frequência?
• Mostre os backlinks mais fortes descobertos recentemente.

Os backlinks são exibidos com os links mais recentes em primeiro lugar, tornando a conexão particularmente útil para analisar atividades recentes de construção de links.

Tendências do perfil de backlinks

Além de links individuais, o assistente pode recuperar resumos históricos do perfil de backlinks.

Esses resumos podem incluir:

• Classificação do domínio
• Total de backlinks
• Novos backlinks
• Backlinks perdidos
• Domínios de referência
• Instantâneos históricos do perfil

Exemplos de perguntas incluem:

• Resuma o crescimento dos nossos backlinks neste mês.
• Ganhamos ou perdemos domínios de referência?
• Quando ocorreu a maior queda nos backlinks?
• Nosso perfil geral de backlinks está crescendo?
• Compare o instantâneo mais recente de backlinks com o anterior.

Isso permite que um assistente de IA explique a tendência, em vez de simplesmente apresentar uma lista de links.

Resumos de monitoramento

O assistente pode gerar um resumo combinado de monitoramento para um domínio, abrangendo áreas como:

• Monitoramento de palavras-chave
• Monitoramento de backlinks
• Monitoramento de auditoria de sites

Isso pode ser usado para solicitar uma visão geral concisa de um site sem precisar verificar cada ferramenta do Ranktracker individualmente.

Por exemplo:

Me forneça um resumo de monitoramento de SEO para example.com.

O cliente pode acessar os dados de monitoramento disponíveis e transformá-los em uma lista clara de alterações, riscos e áreas que requerem atenção.

Relatórios de SEO

Seu assistente pode listar os relatórios já configurados na sua conta do Ranktracker.

Ele também pode recuperar informações sobre um relatório específico, incluindo:

• Agendamento de relatórios
• Destinatários
• Última execução
• Histórico de execuções recentes
• Status atual do relatório
• URL do arquivo do relatório concluído

Você pode perguntar:

• Listar meus relatórios de SEO configurados.
• Quando foi gerado o último relatório do cliente?
• O relatório desta semana foi concluído com sucesso?
• Mostre-me o relatório mais recente disponível.
• Quais destinatários estão configurados para este relatório?
• Qual é a programação atual do relatório?

Isso pode ser particularmente útil para agências que gerenciam vários relatórios recorrentes de clientes.

Executar um relatório existente

O servidor MCP inclui uma ação de gravação cuidadosamente controlada: run_report.

Isso permite que um assistente de IA gere uma nova execução de um relatório que você já configurou no Ranktracker.

A ação é intencionalmente limitada.

Ela:

• Não cria um novo relatório
• Não envia o relatório por e-mail aos destinatários
• Não adquire dados adicionais
• Não adiciona palavras-chave
• Não altera os projetos rastreados
• Não consome créditos de rastreamento de palavras-chave
• Não é possível executar repetidamente o mesmo relatório dentro de um mesmo período de relatório

O relatório gerado aparece no Ranktracker, e a ferramenta pode retornar seu status e o arquivo quando a execução for concluída.

Isso oferece aos usuários uma ação útil sem permitir que um cliente de IA faça alterações amplas ou onerosas na conta.

Auditorias de sites

O assistente pode listar as auditorias de sites associadas a um domínio e recuperar os resultados de uma auditoria específica.

As informações de auditoria disponíveis incluem:

• Status da auditoria
• Progresso do rastreamento
• Estatísticas de rastreamento
• Pontuações de auditoria
• Avisos
• Verificações técnicas de SEO
• Status do SSL
• Status do HTTP/2
• Verificações do mapa do site
• Verificações do robots.txt
• Informações de indexação

Você poderia perguntar:

• Quais foram os principais problemas identificados em nossa última auditoria do site?
• A auditoria identificou algum problema de indexação?
• O site está usando HTTP/2?
• Houve algum problema com o mapa do site ou com o arquivo robots.txt?
• Resuma os avisos técnicos de maior prioridade.
• A última auditoria já foi concluída?
• Compare o número de avisos com o da auditoria anterior.

Isso oferece às equipes de SEO uma maneira mais rápida de compreender os resultados das auditorias técnicas e transformá-los em ações priorizadas.

Faça perguntas em diferentes ferramentas do Ranktracker

O verdadeiro valor de uma conexão com IA não se limita a recuperar um campo por vez.

Um assistente pode acionar várias ferramentas durante a mesma conversa e combinar os resultados em uma resposta mais completa.

Por exemplo, você poderia perguntar:

Prepare um resumo semanal de SEO para example.com.

Dependendo da solicitação e das informações disponíveis, o assistente poderia analisar:

• Posições atuais das palavras-chave
• Movimentações recentes no ranking
• Visibilidade da visão geral da IA
• Backlinks novos e perdidos
• Tendências do perfil de backlinks
• Status mais recente da auditoria do site
• Concorrentes configurados
• Disponibilidade do relatório

Em seguida, ele pode apresentar as conclusões como um resumo gerencial, uma atualização para o cliente, uma lista de prioridades ou um plano de ação técnico.

Você pode dar continuidade à conversa com perguntas complementares, como:

• Qual queda no ranking devemos investigar primeiro?
• Mostre-me as palavras-chave relacionadas.
• Transforme isso em um resumo de fácil compreensão para o cliente.
• Separe as soluções rápidas das questões de longo prazo.
• Qual aviso técnico poderia ter o maior impacto no SEO?

Em vez de exportar e reformatar dados repetidamente, a análise pode ser feita diretamente na conversa.

Como conectar o Ranktracker ao OAuth

O OAuth é a opção recomendada para o ChatGPT, o Claude, o Cursor e outros clientes interativos.

O processo geral de configuração é o seguinte:

1. Abra as configurações do MCP ou do conector no seu cliente de IA.
2. Adicione o endpoint do MCP do Ranktracker: https://api.ranktracker.com/mcp
3. Deixe o campo de autenticação manual em branco.
4. Permita que o cliente identifique o fluxo OAuth do Ranktracker.
5. Faça login no Ranktracker na janela do navegador.
6. Verifique as permissões solicitadas.
7. Aprove a conexão.
8. Volte ao cliente de IA e confirme se as ferramentas do Ranktracker estão disponíveis.

Somente um administrador da conta do Ranktracker pode aprovar uma conexão, pois o cliente conectado tem acesso aos dados de toda a conta autorizada.

Conectando o ChatGPT

No ChatGPT:

1. Abra “Configurações”.
2. Abra “Conectores”.
3. Selecione “Adicionar conector personalizado”.
4. Cole a URL do servidor MCP do Ranktracker.
5. Conclua o processo de autorização do navegador.

Não é necessário nenhum cabeçalho de autenticação manual ao usar o OAuth.

Conectando o Claude Code

Os usuários do Claude Code podem adicionar o Ranktracker com:

A tela de consentimento do navegador é exibida quando a autenticação é necessária.

Conectando o Claude Desktop ou o Cursor

O Claude Desktop e o Cursor podem usar a seguinte configuração de servidor:

Após salvar a configuração, conecte-se ao servidor e aprove o acesso na tela de consentimento do Ranktracker no navegador.

A localização exata do arquivo de configuração depende do cliente. Instruções completas específicas para cada cliente estão disponíveis na documentação do Ranktracker MCP.

Permissões do MCP e segurança da conta

A tela de consentimento do OAuth mostra qual aplicativo está solicitando acesso, qual conta do Ranktracker será conectada e quais permissões estão sendo solicitadas.

Os escopos de permissão disponíveis são:

• mcp:read — ler projetos, palavras-chave, classificações, concorrentes, backlinks, auditorias e relatórios
• mcp:write — gerar uma nova execução de um relatório existente

Os tokens de acesso OAuth têm validade de uma hora e são atualizados automaticamente pelo cliente conectado. A conexão permanece ativa até ser revogada.

O cliente só pode acessar informações pertencentes à conta do Ranktracker que aprovou a conexão.

A maioria das ações disponíveis no MCP é somente para leitura. Ações que poderiam consumir créditos pagos ou realizar alterações significativas no rastreamento são deliberadamente excluídas.

Um cliente de IA não pode usar o servidor MCP para:

• Adicionar novos domínios monitorados
• Adicionar ou remover palavras-chave
• Adquira dados adicionais
• Iniciar uma nova pesquisa no Keyword Finder
• Atualizar as classificações das palavras-chave
• Alterar frequências de monitoramento
• Excluir projetos
• Modificar concorrentes
• Enviar relatórios por e-mail aos destinatários

Essas restrições permitem que os usuários analisem suas informações de SEO sem conceder a um assistente de IA controle irrestrito sobre sua conta do Ranktracker.

OAuth ou token MCP?

A maioria dos usuários deve se conectar via OAuth.

O OAuth não exige que você copie, salve ou cole um token permanente. O cliente de IA abre o Ranktracker no seu navegador, solicita aprovação e gerencia as credenciais de acesso temporárias automaticamente.

Um token MCP dedicado também está disponível para:

• Pipelines de CI
• Scripts
• Agentes internos
• Ambientes automatizados
• Clientes que não suportam OAuth

Os tokens MCP começam com:

tkn_mcp_usr_...

Eles são distintos das chaves normais da API REST do Ranktracker e funcionam apenas com o endpoint MCP.

Uma chave da API REST que comece com tkn_usr_... não funcionará como credencial MCP. Da mesma forma, um token MCP não pode ser usado com endpoints da API REST do Ranktracker.

Manter as credenciais separadas significa que um token MCP pode ser revogado sem afetar as integrações de API existentes de uma organização.

Ranktracker MCP x API REST do Ranktracker

O servidor MCP e a API REST se conectam aos mesmos dados da conta do Ranktracker, mas foram projetados para fluxos de trabalho diferentes.

Ranktracker MCP	API REST do Ranktracker
Projetado para assistentes e agentes de IA	Projetado para aplicativos e sistemas de back-end
Oferece suporte à exploração de dados por meio de conversas	Utiliza endpoints programáticos fixos
A IA seleciona a ferramenta apropriada	Um desenvolvedor seleciona e chama cada endpoint
Principalmente somente leitura	Oferece suporte a operações mais abrangentes de criação, leitura, atualização e exclusão
Ideal quando uma pessoa ou agente faz perguntas	Ideal para movimentação de dados programada e automatizada
Utiliza OAuth ou um token MCP dedicado	Utiliza uma chave de API REST

Use o MCP quando quiser explorar, explicar ou resumir seus dados de SEO por meio de uma conversa com IA.

Use a API REST quando precisar criar um painel, manter um data warehouse, sincronizar sistemas ou executar uma integração programada.

Muitas equipes utilizam ambos: o MCP para análise conversacional e a API REST para automação estruturada.

Projetado para lidar com grandes contas de SEO

As tabelas de palavras-chave e backlinks podem conter uma quantidade significativa de dados.

Por padrão, o Ranktracker MCP retorna JSON estruturado e legível. Para conjuntos de resultados maiores, os usuários podem habilitar o formato de resposta TOON opcional adicionando:

?format=toon

ao endpoint do MCP.

O TOON retorna as mesmas informações subjacentes em um formato tabular mais compacto. De acordo com a documentação do Ranktracker, isso pode reduzir o uso de tokens em aproximadamente 40% a 60% para grandes conjuntos de dados.

O endpoint padrão é:

https://api.ranktracker.com/mcp

O endpoint otimizado para tokens é:

https://api.ranktracker.com/mcp?format=toon

A maioria dos usuários pode manter a conexão no formato JSON padrão. A opção compacta é útil principalmente para conjuntos de dados maiores de palavras-chave e backlinks.

Limites de taxa

O endpoint do Ranktracker MCP possui limites distintos da API REST:

• 200 solicitações por minuto para cada credencial MCP
• 300 solicitações por minuto para cada endereço IP

Solicitações que excedam o limite retornam uma resposta HTTP 429 e devem ser repetidas após um intervalo.

Esses limites são suficientes para interações normais, ao mesmo tempo em que ajudam a proteger contas e infraestrutura contra solicitações automatizadas excessivas.

O acesso ao MCP está incluído em todos os planos do Ranktracker

O servidor MCP do Ranktracker está disponível em todos os planos de assinatura do Ranktracker.

Isso significa que os clientes dos planos Launch, Growth, Scale e Authority podem conectar clientes de IA compatíveis aos dados dentro de suas contas.

A quantidade de dados disponíveis dependerá dos projetos, palavras-chave, backlinks, auditorias e relatórios já disponíveis na assinatura e nas cotas existentes da conta.

Não é necessária nenhuma assinatura separada do MCP para começar a conectar sua conta do Ranktracker a um cliente de IA compatível.

Comece a usar o Ranktracker com seu assistente de IA

O servidor MCP do Ranktracker cria uma nova maneira de trabalhar com dados de SEO.

Em vez de alternar entre telas individuais, baixar planilhas e preparar resumos manualmente, você pode conectar seu assistente de IA e fazer perguntas diretas sobre sua conta.

Você pode analisar:

• Palavras-chave monitoradas
• Variações na classificação
• Visibilidade da visão geral da IA
• Concorrentes
• Pesquisa de palavras-chave
• Backlinks novos e perdidos
• Tendências do perfil de backlinks
• Auditorias de sites
• Relatórios programados

A conexão é rápida de configurar, funciona com os principais clientes MCP e foi projetada com permissões controladas que impedem alterações dispendiosas ou prejudiciais à conta.

Conecte seu cliente de IA preferido e confira as instruções completas de configuração em:

https://developers.ranktracker.com/mcp