RankOrg MCP

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

Configuración del agente y prompt de copiado

Crea un token de acceso personal desde Configuración → Acceso a la API (MCP), luego elige tu agente y copia el fragmento de configuración y el prompt.

Configuración de Claude

Añade RankOrg como un conector MCP remoto personalizado. Claude detecta automáticamente OAuth 2.0 y te solicita autorizar con un clic.

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.

Inicio rápido de MCP

1. 1

   Conecta tu agente de IA

   Añade https://rankorg.com/api/mcp como servidor MCP remoto en Claude o ChatGPT. Se autenticarán automáticamente mediante OAuth 2.0 seguro.
2. 2

   O usa un token personal para herramientas CLI

   Para herramientas como Codex, Cursor o scripts, genera un token personal en Configuración → Acceso a la API (MCP) y proporciónalo mediante Authorization: Bearer rankorg_....
3. 3

   Pregunta en lenguaje natural

   Prueba "¿Qué contenido está programado para hoy?" o "Investiga palabras clave y escribe mi próximo artículo."

Autenticación

RankOrg admite OAuth 2.0 estándar (RFC 8414, RFC 7591 Registro Dinámico de Clientes y PKCE) para clientes de asistentes de IA (Claude, ChatGPT), así como Tokens de Acceso Personal para entornos CLI sin interfaz gráfica.

• OAuth 2.0 (Conectores de IA): Simplemente ingresa https://rankorg.com/api/mcp en tu cliente de IA. El descubrimiento ocurre automáticamente mediante /.well-known/oauth-protected-resource.
• Encabezado Bearer (CLI y Scripts): Authorization: Bearer rankorg_... o 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

Herramientas MCP

Las herramientas de lectura inspeccionan tu cuenta. Las herramientas de escritura modifican contenido, horarios o estado de publicación.

getSiteContext lectura

Devuelve el sitio (dominios) del usuario y su perfil de negocio/niche. Los agentes deben llamar a esto primero para fundamentar todo lo demás.

Di: "¿Para qué negocio está configurada mi cuenta de RankOrg?"

listContent lectura

Lista los artículos del usuario. Usa filter='today' para ver lo que se publica hoy, 'scheduled' para lo próximo, 'published' para publicaciones en vivo o 'all'.

Parámetro	Tipo	Notas
filter	"today" | "scheduled" | "published" | "all"	Qué porción de contenido devolver. Por defecto es 'all'.

Di: "¿Qué contenido está programado para publicarse hoy?"

getContent lectura

Devuelve el contenido HTML completo de un solo artículo, título, meta descripción, estado y horario por id. Llama antes de editar para tener el borrador actual.

Parámetro	Tipo	Notas
id *	string	El id del artículo.

Di: "Muéstrame el borrador titulado '…' para revisarlo."

getSearchPerformance lectura

Devuelve el rendimiento de Google Search Console del sitio: clics, impresiones, CTR, posición promedio, páginas principales, consultas principales y una tendencia diaria. Informa un siguiente paso claro cuando Search Console aún no está conectado.

Di: "¿Cómo está funcionando mi contenido en la búsqueda de Google?"

getTopicalMap lectura

Devuelve el mapa temático: clústeres → temas → subtemas → palabras clave con demanda (volumen/CPC), dificultad de palabras clave, puntuaciones de posicionabilidad y qué palabras clave ya tienen artículos programados o publicados.

Di: "¿Qué palabras clave estamos atacando y cuáles siguen abiertas?"

generateContentMap lectura

Genera un mapa de contenido temático gratuito para cualquier sitio web: niche, Domain Rating y 4 clústeres → temas → subtemas → palabras clave con volumen de búsqueda mensual, KD estimado, intención y posicionabilidad. Se almacena en caché 30 días por dominio; funciona sin plan de pago (3 sitios nuevos/día).

Parámetro	Tipo	Notas
url *	string	URL del sitio web o dominio a mapear, p. ej. example.com.

Di: "Crea un mapa temático para competitor.com — ¿qué palabras clave podríamos ganar?"

updateContent escritura

Edita el título, contenido HTML y meta descripción de un artículo. El título no puede cambiar una vez que un artículo está publicado (estabilidad SEO).

Parámetro	Tipo	Notas
id *	string	El id del artículo.
title *	string	Nuevo título.
content *	string	Cuerpo completo del artículo como HTML.
metaDescription *	string	Nueva meta descripción.

Di: "Ajusta la introducción de ese borrador y actualiza la meta descripción."

researchKeywords escritura

Genera un perfil de palabras clave: palabras clave principales más frases de búsqueda long-tail específicas, a partir del perfil de negocio del usuario, y lo guarda en su cuenta.

Di: "Investiga palabras clave para mi negocio."

generateArticle escritura

Genera el próximo artículo SEO, eligiendo la palabra clave de mayor prioridad del mapa temático y programándola en el próximo espacio de publicación disponible.

Di: "Escribe y programa mi próximo artículo."

publishContent escritura

Publica un artículo programado en vivo inmediatamente. Esto es público y casi irreversible: solo llama después de que el usuario confirme explícitamente.

Parámetro	Tipo	Notas
id *	string	El id del artículo a publicar ahora.

Di: "Publica ese artículo ahora."

rescheduleContent escritura

Mueve un artículo planificado a una fecha futura diferente, o lo omite para liberar el día. Solo los días planificados no generados (filas de preplanificación DRAFT) pueden moverse u omitirse; mover a otro día planificado intercambia los dos.

Parámetro	Tipo	Notas
id *	string	El id del artículo planificado.
action *	"move" | "skip"	Mover a una nueva fecha u omitir el día.
newDate	string	Requerido para 'move': nueva fecha de publicación (AAAA-MM-DD), debe ser futura.

Di: "Mueve la publicación de mañana al viernes."

mergeContent escritura

Consolida publicaciones duplicadas o superpuestas. La principal sobrevive; cada publicación fusionada se convierte en un redireccionamiento 308 permanente hacia ella, para que las URL antiguas sigan pasando el valor SEO a la sobreviviente.

Parámetro	Tipo	Notas
primaryId *	string	La publicación a conservar (debe estar publicada).
mergedIds *	string[]	Publicaciones a fusionar en la principal (se convierten en redireccionamientos).

Di: "Estas dos publicaciones se superponen: conserva la más fuerte y redirige la otra."

unmergeContent escritura

Revierte una fusión: restaura una publicación fusionada a publicada para que su URL vuelva a servir contenido en lugar de redirigir.

Parámetro	Tipo	Notas
id *	string	El id del artículo fusionado a restaurar.

Di: "Deshaz esa fusión: trae de vuelta la publicación anterior."