SV MCP
Dale a Claude y Cursor 15 herramientas de SEO y GEO con una sola URL.
Servidor MCP alojado
npx add-mcp 'https://mcp.seovendor.co'Se instala en Claude Code, Codex, Cursor y más
Documentación
Un servidor FastMCP que expone las herramientas SEO y GEO de SV de forma nativa a agentes de IA: Claude Desktop, Claude Code, Cursor y cualquier host compatible con MCP. Construido directamente sobre la biblioteca principal de sv-cli: sin lógica duplicada de resolución, autenticación ni tareas asíncronas.
17
Herramientas expuestas
FastMCP
Framework de servidor
OAuth
2.1 auth
HTTP
Transporte
Un núcleo compartido, tres interfaces. sv-cli, sv-mcp y HTTP directo resuelven enums, gestionan autenticación y manejan el sondeo de tareas asíncronas a través de la misma biblioteca subyacente. Una corrección o nueva herramienta añadida a sv-cli está automáticamente disponible a través del servidor MCP y la API REST.
01Cómo funciona
sv-mcp es un servidor FastMCP que envuelve la biblioteca principal de sv-cli. Expone 15 herramientas de la API de SV como herramientas MCP, además de get_task_status y get_task_result para tareas asíncronas. SEO Image está disponible solo a través de la API y la CLI. Cuando un agente de IA llama a una herramienta, el servidor MCP delega en el mismo resolvedor, pila de autenticación y lógica de tareas asíncronas que usa la CLI, por lo que el comportamiento es idéntico tanto si llamas a sv seogpt generate desde una terminal como si invocas la herramienta MCP seogpt desde Claude Desktop.
Las herramientas asíncronas (GEO Audit, Prose, SEO Strategist, SEO Mapping) devuelven un ID de tarea de inmediato. El agente puede pasar wait: true en una llamada para esperar hasta 45 segundos el resultado. Si la tarea sigue en ejecución después de eso, la herramienta devuelve el ID de tarea y el agente continúa con get_task_status / get_task_result.
# The MCP server sits on top of sv-cli core:
#
# Claude Desktop / Claude Code / Cursor
# ↓ MCP protocol (Streamable HTTP)
# sv-mcp (FastMCP server) ← you are here
# ↓ sv-cli core library
# SV REST API (ai.seovendor.co/api)
#
# Every MCP tool call:
# 1. FastMCP receives the JSON-RPC tool call
# 2. sv-cli core resolves enums + validates fields
# 3. Async tools return a task ID (or wait up to 45s)
# 4. Result returned to the MCP host as structured JSON
02Conectar a Claude.ai
Configuración solo con URL. Al registrarte a través de la interfaz de conector personalizado de Claude.ai, solo necesitas la URL base. FastMCP monta el endpoint del protocolo MCP allí; las rutas de devolución de llamada OAuth y de descubrimiento también se sirven en este dominio, pero no necesitas referenciarlas directamente.
# In Claude.ai: Customize → Connectors → + → Add custom connector
Connector URL: https://mcp.seovendor.co
# Click Connect and sign in to SV. Claude handles the OAuth 2.1 flow.
# Your SV API key is linked during sign-in and is never shown to Claude.
En los planes Team y Enterprise, un Propietario primero añade el conector en Configuración de organización → Conectores; luego los miembros lo conectan ellos mismos.
03Conectar a Claude Desktop
Claude Desktop usa los mismos conectores que Claude.ai. Abre Personalizar → Conectores → + → Añadir conector personalizado, pega https://mcp.seovendor.co, luego haz clic en Conectar e inicia sesión en SV. Los conectores que añadas en Claude.ai aparecen automáticamente en Claude Desktop.
04Conectar a Claude Code
Añade sv-mcp como servidor remoto desde la terminal, o confirma un .mcp.json en tu proyecto para que cada colaborador lo reciba automáticamente.
# Add via Claude Code CLI
claude mcp add --transport http sv-mcp https://mcp.seovendor.co
# Verify it registered
claude mcp list
{
"mcpServers": {
"sv-mcp": { "type": "http", "url": "https://mcp.seovendor.co" }
}
}
05Otros hosts MCP
Cualquier host compatible con MCP que admita Streamable HTTP puede conectarse a sv-mcp usando la misma URL base.
| Host | Dónde añadirlo | Valor |
|---|---|---|
| Cursor | ~/.cursor/mcp.json | { "mcpServers": { "sv-mcp": { "url": "https://mcp.seovendor.co" } } } |
| VS Code | .vscode/mcp.json | { "servers": { "sv-mcp": { "type": "http", "url": "https://mcp.seovendor.co" } } } |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | { "mcpServers": { "sv-mcp": { "serverUrl": "https://mcp.seovendor.co" } } } |
| Cline / Roo | Configuración MCP → Servidor remoto | https://mcp.seovendor.co, Streamable HTTP |
| Continue | array mcpServers de config.json | url: https://mcp.seovendor.co, Streamable HTTP |
| Clientes que solo admiten stdio | Puente a través de mcp-remote | { "mcpServers": { "sv-mcp": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.seovendor.co"] } } } |
| Host personalizado | Cualquier SDK de MCP 1.x | Streamable HTTP, URL base https://mcp.seovendor.co |
06Herramientas disponibles
15 herramientas de la API de SV se exponen como herramientas MCP, además de dos herramientas de tareas. Las herramientas asíncronas devuelven un ID de tarea de inmediato; pasa wait: true para esperar hasta 45 segundos el resultado.
| Nombre de herramienta MCP | Endpoint de API | Modo | Descripción |
|---|---|---|---|
| seogpt | seogpt | Síncrono | Texto SEO de formato corto, como títulos meta y descripciones. |
| prose | seogpt2 | Asíncrono | Artículos de formato largo y publicaciones de blog. |
| content-transformer | content-transformer | Síncrono | Reescribe o reformatea el texto proporcionado en un tipo de contenido. |
| better-keywords | better-keywords | Síncrono | Investigación de palabras clave con volumen, CPC, competencia e intención. |
| insight-igniter | insight-igniter | Síncrono | Entidades y temas que los motores de IA asocian con un sitio web. |
| topical-authority | topical-authority | Síncrono | Plan de contenido temático para una palabra clave. |
| core-analysis | core-analysis | Síncrono | Análisis SEO on-page de una URL. |
| preliminaryaudit | preliminaryaudit | Síncrono | Puntuación rápida de salud SEO para una URL. |
| geogptaudit | geogptaudit | Asíncrono | Visibilidad en respuestas generadas por IA para entidades dadas. |
| seogptcompare | seogptcompare | Asíncrono | Compara una URL con sus principales competidores. |
| seogptmapping | seogptmapping | Asíncrono | Mapea palabras clave a las páginas más relevantes de un dominio. |
| ranklens | ranklens | Síncrono | Cómo se posiciona un sitio en consultas repetidas de motores de IA, y sus competidores. |
| content-quality | content-quality | Síncrono | Puntuación E-E-A-T y de contenido útil para una página. |
| top-competitors | top-competitors | Síncrono | URLs de competidores mejor posicionados para una palabra clave. |
| marketplace-services | marketplace-services | Síncrono | Busca en el catálogo de servicios de SV. |
| get_task_status | — | — | Comprueba el estado de una tarea asíncrona. |
| get_task_result | — | — | Obtiene el resultado de una tarea asíncrona finalizada. |
07Autenticación
sv-mcp usa OAuth 2.1 para todas las conexiones alojadas. Te autenticas una vez a través de tu cuenta de SV: no se requiere configuración de clave API en el host MCP. El flujo siguiente ocurre automáticamente cuando haces clic en Conectar.
| Paso | Qué ocurre |
|---|---|
| 1. Conectar | Haces clic en Conectar en tu host MCP (Claude, Cursor, etc.). El host abre el endpoint OAuth de SV. |
| 2. Consentimiento | SV presenta una pantalla de consentimiento OAuth. Aceptas los permisos solicitados. |
| 3. Inicio de sesión | Inicias sesión con tus credenciales de cuenta de SV en la página de inicio de sesión OAuth de SV. |
| 4. Redirección | En caso de éxito, SV redirige de vuelta al host MCP con un código de autorización de corta duración. El host ahora está Conectado. |
| 5. Intercambio de token | sv-mcp intercambia el código de autorización por un token de sesión de corta duración. Este token nunca sale del servidor. |
| 6. Resolución de clave API | Antes de cada llamada a la API, sv-mcp intercambia de forma segura el token de sesión por tu clave API de SV en el lado del servidor. La clave API nunca se expone al host MCP ni al modelo de IA. |
| 7. Caché en memoria | La clave API resuelta se mantiene en la memoria del servidor durante 5 minutos y luego se descarta. sv-mcp la vuelve a resolver bajo demanda cuando es necesario. |
Tu clave API nunca se expone. El flujo OAuth mantiene tu clave API de SV completamente en el lado del servidor. El host MCP (Claude, Cursor, etc.) y el modelo de IA solo ven los resultados de las herramientas: la clave se resuelve en memoria por sv-mcp y se descarta después de 5 minutos.
08sv-cli vs API REST vs sv-mcp
Las tres interfaces usan la misma biblioteca principal. SV MCP expone todas las herramientas excepto SEO Image. Elige según el contexto.
| Interfaz | sv-cli (terminal) | API REST de SV (HTTP) | sv-mcp (MCP) |
|---|---|---|---|
| Quién la usa | Humanos, scripts de shell, CI | Cualquier cliente HTTP | Agentes de IA (hosts MCP) |
| Autenticación | variable de entorno SV_API_KEY o perfil | k en el cuerpo JSON | OAuth 2.1 (alojado) o SV_API_KEY (instalación local) |
| Manejo asíncrono | flag --wait o sondeo manual | 3 pasos: createTask → poll → getResult | Devuelve un ID de tarea, o espera hasta 45 s con wait: true |
| Resolución de enums | Modos difuso + estricto | Enteros / cadenas sin procesar | Núcleo de sv-cli (igual) |
| Formato de salida | tabla, csv, json, markdown… | Envoltura JSON | JSON estructurado al host |
| Núcleo subyacente | Biblioteca sv-cli | N/D | Biblioteca sv-cli (compartida) |
09Puntos y límites
Las llamadas a herramientas exitosas usan puntos de tu cuenta de SV. Las llamadas fallidas, get_task_status y get_task_result son gratuitas. La API de SV acepta 1 solicitud por segundo por clave API; SV MCP reintenta automáticamente si se alcanza ese límite.
10Ejecutar SV MCP localmente (opcional)
pip install sv-mcp
{
"mcpServers": {
"sv-mcp": {
"command": "uvx",
"args": ["sv-mcp"],
"env": { "SV_API_KEY": "your-key" }
}
}
}
11Privacidad, soporte y código fuente
Privacidad: seovendor.co/privacy-policy/#api-mcp-cli · Soporte: [email protected] · Código fuente: github.com/seovendorco/sv-mcp
API de SV
URL base https://ai.seovendor.co/api · Todas las solicitudes son POST · JSON de entrada, JSON de salida · © 2026 SEO Vendor. Construido para agencias desde 2004.