Pregunta a Claude, Cursor y otros asistentes de IA por tu SEO

1. Crea una API key

En serp.ac, abre Ajustes → API y crea una clave (solo pueden hacerlo el propietario de la cuenta y los administradores). Cópiala: solo se muestra una vez. El servidor MCP usa las mismas claves, el mismo límite de solicitudes (120 solicitudes por minuto y clave) y las mismas cuotas que la REST API. Cada clave da acceso completo a la cuenta que la creó, así que mantenla en secreto y revócala en esa misma página si se filtra.

2. Conecta Claude

Claude (claude.ai y las apps de Claude): conector personalizado

Ve a Settings → Connectors → Add custom connector, ponle el nombre serp.ac y usa la URL del servidor https://serp.ac/api/mcp. El servidor autentica cada solicitud con tu API key enviada como Authorization: Bearer sk_live_…; si el diálogo de conectores de tu plan no permite enviar esa cabecera, usa en su lugar la configuración de Claude Desktop que aparece abajo.

Claude Desktop: archivo de configuración

Abre Settings → Developer → Edit config y añade el servidor a claude_desktop_config.json. Ejecuta el puente mcp-remote (requiere Node.js), que reenvía tu clave como cabecera. Después, reinicia 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. Conecta Cursor y otros clientes

Cursor: añade el servidor a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json dentro de un proyecto y, después, actívalo en Settings → MCP.

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

Cualquier otro cliente MCP (ChatGPT, VS Code, Windsurf, tu propio agente) funciona igual, siempre que admita el transporte Streamable HTTP y pueda enviar la cabecera Authorization. Los clientes que solo admiten stdio pueden usar el puente mcp-remote mostrado arriba.

Comprobación rápida desde una 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 de solo lectura

Las herramientas marcadas como Modifica datos añaden cosas a tu cuenta y las marcadas como Consume cuota gastan tus cuotas mensuales; se indica a los asistentes que te pregunten antes. Para exponer solo las herramientas de lectura, conéctate con https://serp.ac/api/mcp?readonly=1. El modo de solo lectura es un ajuste de la conexión, no de la clave: una clave siempre tiene todos los permisos de la cuenta.

Herramientas

Cada herramienta responde con un breve resumen más los mismos datos en JSON estructurado. Las listas están limitadas (hasta 200 filas) y solo contienen datos de tu propia cuenta. Puedes referirte a los proyectos por id o por dominio.

• list_projectsLectura

  Lista los proyectos (sitios web) de serp.ac de esta cuenta con sus ids, dominios y cuántas palabras clave, prompts de IA y enlaces comprados sigue cada uno. Llámala primero para obtener los ids de proyecto.

• get_rankingsLectura

  Posiciones en Google de las palabras clave seguidas de un proyecto: posición actual, cambio desde la comprobación anterior (positivo = ha subido), URL posicionada, si se muestra un AI Overview de Google y si cita el sitio, y hora de la última comprobación. Filtros opcionales por texto de palabra clave y por dispositivo.

• get_ai_visibilityLectura

  Visibilidad en IA de un proyecto en ChatGPT, Perplexity, Gemini, Claude y Google AI Mode: porcentaje de respuestas que mencionan la marca, tasa de citas, posición media, cifras por motor, una matriz prompt × motor, dominios fuente más citados, cuota de voz y otras marcas que recomiendan los asistentes de IA.

• get_backlinks_summaryLectura

  Resumen de backlinks de un proyecto: total de backlinks y dominios de referencia, domain rank, porcentaje dofollow, enlaces nuevos en los últimos 30 días, enlaces perdidos y los dominios de referencia más fuertes.

• list_purchased_linksLectura

  Enlaces comprados (de pago) seguidos en Gestión de enlaces: estado (pending, active, issue, lost, expired, cancelled = en pausa), problemas detectados, precio, ciclo de facturación, próxima fecha de pago / renovación y proveedor, más los pagos que vencen en los próximos 30 días. Todos los proyectos, salvo que se indique uno.

• get_index_jobLectura

  Estado de un trabajo de comprobación de indexación iniciado con check_index, con el estado de indexación de cada URL (indexed, not_indexed, queued, error).

• get_usageLectura

  El plan y el estado de la suscripción de la cuenta, los límites del plan con el uso actual (proyectos, palabras clave, prompts de IA, enlaces) y las cuotas mensuales restantes (envíos al indexador, comprobaciones de indexación, consultas de datos de palabras clave).

• get_maps_rankingsLectura

  Seguimiento de posiciones en Google Maps (geo-grid local) de un proyecto: sin campaña, cada campaña de Maps con su última puntuación de presencia local (0–100), cobertura en el top 10 y posición media; con campaña (id o texto de la palabra clave), la posición del último escaneo en cada punto de la cuadrícula, el historial de escaneos, los competidores que te superan y el local pack.

• track_keywordsModifica datos

  empieza a seguir las posiciones en Google de nuevas palabras clave en un proyecto. Cada palabra clave nueva cuenta para el límite de palabras clave SERP del plan; las que ya se siguen no cambian. Pregunta al usuario antes de añadir muchas palabras clave.

• add_ai_promptsModifica datos

  añade prompts (preguntas que la gente hace a los asistentes de IA) al seguimiento de visibilidad en IA de un proyecto; después se ejecutan de forma programada. Cada prompt nuevo cuenta para el límite de prompts de IA del plan; los que ya se siguen no cambian.

• add_purchased_linkModifica datos

  añade un enlace comprado (de pago) a la Gestión de enlaces de un proyecto para que serp.ac lo compruebe a diario y recuerde los pagos. Cuenta para el límite de enlaces monitorizados del plan. Falla con already_tracked si ya existe el mismo enlace origen → destino.

• check_indexConsume cuota

  inicia un trabajo que comprueba si Google ha indexado unas URL. Cada URL consume 1 comprobación de indexación de la cuota mensual (y después de los paquetes comprados); no se cobra nada si no hay suficiente. Devuelve un id de trabajo: llama a get_index_job para obtener los resultados.

• get_keyword_dataConsume cuota

  volumen de búsqueda, CPC, competencia, dificultad de la palabra clave, intención de búsqueda y tendencia de 12 meses por palabra clave. Cada palabra clave que no esté ya en caché cuenta para la cuota mensual de pago de consultas de palabras clave de la cuenta (las que están en caché son gratis); consulta get_usage primero si la lista es grande.

Límites y errores

• Las herramientas de escritura respetan tu plan exactamente igual que el panel y la REST API: límites de palabras clave, prompts y enlaces, motores de IA incluidos en el plan, y un plan o prueba activos.
• check_index consume 1 comprobación de indexación por URL de la cuota mensual y, después, de los paquetes; get_keyword_data consume la cuota mensual de consultas de palabras clave para las que no están en caché. No se cobra nada si la cuota no alcanza.
• Los problemas con una llamada (proyecto desconocido, argumentos no válidos, límite alcanzado) se devuelven como un error de herramienta que el asistente puede leer. Una clave ausente o revocada devuelve HTTP 401, una cuenta suspendida 403 y el exceso de solicitudes 429.

¿Quieres automatizar sin un asistente de IA? Consulta la referencia de la REST API en Ajustes → API.