RankOrg MCP

npx add-mcp 'https://rankorg.com/api/mcp'

Configuração do agente e prompt de cópia

Crie um token de acesso pessoal em Configurações → Acesso à API (MCP), depois escolha seu agente e copie o trecho de configuração e o prompt.

Configuração do Claude

Adicione RankOrg como um conector MCP remoto personalizado. O Claude detecta automaticamente OAuth 2.0 e solicita que você autorize com um clique.

https://rankorg.com/api/mcp

Use the RankOrg MCP server. First get my site context, then list my scheduled articles for the next 7 days as a concise list with title, publish date, status, slug, and article ID.

Início rápido do MCP

1. 1

   Conecte seu agente de IA

   Adicione https://rankorg.com/api/mcp como um servidor MCP remoto no Claude ou ChatGPT. Eles autenticarão automaticamente via OAuth 2.0 seguro.
2. 2

   Ou use um token pessoal para ferramentas CLI

   Para ferramentas como Codex, Cursor ou scripts, gere um token pessoal em Configurações → Acesso à API (MCP) e forneça-o via Authorization: Bearer rankorg_....
3. 3

   Pergunte em linguagem simples

   Tente "Qual conteúdo está agendado para hoje?" ou "Pesquise palavras-chave e escreva meu próximo artigo."

Autenticação

RankOrg suporta OAuth 2.0 padrão (RFC 8414, RFC 7591 Dynamic Client Registration e PKCE) para clientes assistentes de IA (Claude, ChatGPT), bem como Tokens de Acesso Pessoal para ambientes CLI headless.

• OAuth 2.0 (Conectores de IA): Basta inserir https://rankorg.com/api/mcp no seu cliente de IA. A descoberta acontece automaticamente via /.well-known/oauth-protected-resource.
• Cabeçalho Bearer (CLI e Scripts): Authorization: Bearer rankorg_... ou Authorization: Bearer mcp_at_...
• Consulta de URL (Legado): https://rankorg.com/api/mcp?token=rankorg_...

POST https://rankorg.com/api/mcp
Authorization: Bearer mcp_at_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
Accept: application/json, text/event-stream

Ferramentas MCP

As ferramentas de leitura inspecionam sua conta. As ferramentas de escrita alteram conteúdo, agendamentos ou estado de publicação.

getSiteContext leitura

Retorna o site (domínios) do usuário e o perfil de negócio/nicho. Os agentes devem chamar isso primeiro para fundamentar todo o resto.

Diga: "Para qual negócio minha conta RankOrg está configurada?"

listContent leitura

Lista os artigos do usuário. Use filter='today' para ver o que publica hoje, 'scheduled' para os próximos, 'published' para posts ao vivo ou 'all'.

Parâmetro	Tipo	Observações
filter	"today" | "scheduled" | "published" | "all"	Qual fatia de conteúdo retornar. O padrão é 'all'.

Diga: "Qual conteúdo está agendado para publicar hoje?"

getContent leitura

Retorna o conteúdo HTML completo de um único artigo, título, meta descrição, status e agendamento por id. Chame antes de editar para ter o rascunho atual.

Parâmetro	Tipo	Observações
id *	string	O id do artigo.

Diga: "Mostre-me o rascunho intitulado '…' para que eu possa revisá-lo."

getSearchPerformance leitura

Retorna o desempenho do site no Google Search Console — cliques, impressões, CTR, posição média, principais páginas, principais consultas e uma tendência diária. Relata um próximo passo claro quando o Search Console ainda não está conectado.

Diga: "Como meu conteúdo está performando na pesquisa do Google?"

getTopicalMap leitura

Retorna o mapa tópico — clusters → tópicos → subtópicos → palavras-chave com demanda (volume/CPC), dificuldade de palavra-chave, pontuações de rankeabilidade e quais palavras-chave já têm artigos agendados ou publicados.

Diga: "Quais palavras-chave estamos segmentando e quais ainda estão abertas?"

generateContentMap leitura

Gera um mapa de conteúdo tópico gratuito para qualquer site — nicho, Domain Rating e 4 clusters → tópicos → subtópicos → palavras-chave com volume de pesquisa mensal, KD estimado, intenção e rankeabilidade. Cache de 30 dias por domínio; funciona sem plano pago (3 novos sites/dia).

Parâmetro	Tipo	Observações
url *	string	URL do site ou domínio para mapear, ex.: example.com.

Diga: "Construa um mapa tópico para competitor.com — quais palavras-chave poderíamos vencer?"

updateContent escrita

Edita o título, conteúdo HTML e meta descrição de um artigo. O título não pode mudar depois que um artigo é publicado (estabilidade de SEO).

Parâmetro	Tipo	Observações
id *	string	O id do artigo.
title *	string	Novo título.
content *	string	Corpo completo do artigo em HTML.
metaDescription *	string	Nova meta descrição.

Diga: "Aperte a introdução daquele rascunho e atualize a meta descrição."

researchKeywords escrita

Gera um perfil de palavras-chave — palavras-chave principais mais frases de cauda longa específicas — a partir do perfil de negócio do usuário e o salva na conta dele.

Diga: "Pesquise palavras-chave para meu negócio."

generateArticle escrita

Gera o próximo artigo de SEO, escolhendo a palavra-chave de maior prioridade do mapa tópico e agendando-a no próximo espaço de publicação disponível.

Diga: "Escreva e agende meu próximo artigo."

publishContent escrita

Publica um artigo agendado ao vivo imediatamente. Isso é público e irreversível — chame apenas após o usuário confirmar explicitamente.

Parâmetro	Tipo	Observações
id *	string	O id do artigo a publicar agora.

Diga: "Publique esse artigo agora."

rescheduleContent escrita

Move um artigo planejado para uma data futura diferente ou o pula para liberar o dia. Apenas dias planejados não gerados (linhas de pré-planejamento DRAFT) podem ser movidos ou pulados; mover para outro dia planejado troca os dois.

Parâmetro	Tipo	Observações
id *	string	O id do artigo planejado.
action *	"move" | "skip"	Mover para uma nova data ou pular o dia.
newDate	string	Obrigatório para 'move': nova data de publicação (AAAA-MM-DD), deve estar no futuro.

Diga: "Mova o post de amanhã para sexta-feira."

mergeContent escrita

Consolida posts publicados duplicados ou sobrepostos. O primário sobrevive; cada post mesclado se torna um redirecionamento 308 permanente para ele, para que as URLs antigas continuem passando equidade de SEO para o sobrevivente.

Parâmetro	Tipo	Observações
primaryId *	string	O post a manter (deve estar publicado).
mergedIds *	string[]	Posts a mesclar no primário (tornam-se redirecionamentos).

Diga: "Esses dois posts se sobrepõem — mantenha o mais forte e redirecione o outro."

unmergeContent escrita

Reverte uma mesclagem: restaura um post mesclado para publicado para que sua URL sirva conteúdo novamente em vez de redirecionar.

Parâmetro	Tipo	Observações
id *	string	O id do artigo mesclado a restaurar.

Diga: "Desfaça essa mesclagem — traga o post antigo de volta."