Servidor MCP para SEO con agentes de IA

Un servidor MCP local por stdio expone las mismas herramientas a Claude Code, Claude Desktop, Codex, Cursor y otros clientes MCP. Se muestra el registro antes de cambiar cualquier archivo.

Qué hace

Perfiles

--profile full expone todas las herramientas. Los perfiles audit, infra, quick-check y router exponen conjuntos más pequeños para sesiones centradas, de modo que el agente ve menos esquemas. El perfil router anuncia solo la herramienta doctor, la inspección de URL, el flujo de auditoría y el catálogo de herramientas; el resto lo descubre el agente a través del catálogo. Un perfil más estrecho bloquea de inmediato las herramientas excluidas, mientras que el cliente debe reiniciarse para ver las que se hayan activado.

  • audit: herramientas de auditoría de Screaming Frog acotadas
  • infra: comprobaciones de dominio, CDN, tecnologías, seguridad, cabeceras, robots y sitemap
  • quick-check: comprobaciones rápidas de URL, incluida la comprobación por lotes
  • seohead mcp status --json muestra el perfil y el número exacto de herramientas

Registro seguro

El registro empieza por un plan. Ejecuta seohead mcp install con --dry-run para ver el bloque de configuración, el archivo que cambiaría, la ruta de la copia de seguridad y el SHA-256 original. No se escribe nada. Añade --yes para aplicarlo. La configuración del cliente se copia, se sustituye de forma atómica, se vuelve a analizar y se conservan los demás servidores que contiene.

  • Clientes: Claude Code, Claude Desktop, Codex y Cursor, que se eligen con --client
  • --expected-sha256 rechaza la instalación si el archivo cambió después de la vista previa
  • seohead mcp uninstall restaura desde la copia de seguridad
  • seohead mcp disable impide que el servidor acepte llamadas

Agentes con memoria

Los proyectos guardan el alcance, la política de rastreo, los escaneos y el historial, así que el siguiente agente continúa desde el proyecto guardado y no desde el chat. Una bandeja de entrada del proyecto recoge las notas del especialista y los objetivos propuestos. Un host también puede limitar un proceso MCP a un nombre de consumidor y a una lista de carpetas de proyecto permitidas.

  • workflow-status indica a un agente nuevo el siguiente paso registrado
  • Las escrituras usan la revisión actual y fallan ante un conflicto
  • Las operaciones de pago necesitan confirmación explícita, por ejemplo confirm_paid=true

Tres pasos, un análisis guardado

  1. Previsualiza el registro

    Ejecuta primero la instalación con --dry-run. Muestra el bloque de configuración exacto, el archivo que cambiaría, la ruta de la copia de seguridad y un sha256, y no escribe nada.

  2. Instala con --yes

    Cuando hayas leído el plan, añade --yes. La configuración anterior se copia junto a ella, y --expected-sha256 rechaza la instalación si el archivo cambió después de la vista previa.

  3. Los agentes continúan el proyecto guardado

    Los proyectos guardan el alcance, la política de rastreo, los escaneos y el historial. El siguiente agente retoma el proyecto guardado en lugar de empezar desde el chat.

Comprobaciones de esta función

ComprobaciónQué significaGravedadEvidencia
REDIRECT_LOOPUna cadena de redirecciones vuelve a una URL que ya visitó, así que nunca se estabilizaCriticalRuta del bucle dentro de la cadena de redirecciones (exportación Redirect Chains de SF o registros de saltos de un rastreo nativo)
BROKEN_INTERNAL_LINKUn enlace interno apunta a una URL que devuelve 4xxCriticalEnlaces entrantes con error de cliente (4xx): página de origen y posición del enlace
REDIRECT_CHAINHay más de un salto antes de la URL finalImportantCada salto con su código de estado y su cabecera location
INTERNAL_LINK_TO_REDIRECTUn enlace interno apunta a una URL 3xx en lugar de a la página finalImportantEnlaces entrantes de redirección (3xx): página de origen y posición en el DOM
BAD_REDIRECT_TYPESe usa un 302, 303 o 307 cuando se quiere un traslado permanenteTipCódigo de estado de cada salto

Un solo comando

bash
claude mcp add seohead -- /absolute/path/to/spiderhead/.venv/bin/seohead mcp

Primero, instala SpiderHead: guía de instalación. Cada comando también funciona como herramienta MCP para agentes de IA.

Qué necesitas

  • Un cliente MCP: Claude Code, Claude Desktop, Codex, Cursor o cualquier cliente stdio
  • El ejecutable seohead de un entorno virtual, con ruta absoluta
  • El extra mcp del toolkit instalado
  • Claves de proveedor solo para herramientas de pago o que requieren cuenta

Límites

  • Es un servidor stdio local. No hay un endpoint MCP alojado
  • Todavía no hay diario de llamadas; si necesitas un registro de auditoría, lleva el tuyo
  • Las herramientas pueden enviar peticiones cuando pides una comprobación o un rastreo. Consulta el catálogo para ver cuáles
  • Instalar la entrada no activa MCP por sí sola, y para escribir cualquier cambio hace falta --yes

Preguntas

¿Registrar el servidor cambia mi configuración?
No en la vista previa. --dry-run no escribe nada y muestra el archivo que cambiaría (en Claude Code, ~/.claude.json), la ruta de la copia de seguridad y un sha256. El cambio solo se produce con --yes.
¿Qué clientes son compatibles?
Claude Code, Claude Desktop, Codex y Cursor, que se eligen con --client. Cualquier otro cliente MCP puede usar el mismo comando del servidor stdio.
¿Cuántas herramientas ve un agente?
Depende del perfil. El perfil full expone todas las herramientas registradas, y audit, infra, quick-check y router exponen conjuntos mucho más pequeños. Ejecuta seohead mcp status --json para ver el número exacto de cada perfil en tu instalación.
¿El servidor se ejecuta en la nube?
No. Es un proceso stdio local. Las peticiones de red salen solo para las comprobaciones que lances, como una URL o un rastreo. Un rastreo guarda su escaneo en ./scans/ por defecto.
¿Puede un agente gastar mi dinero?
No sin avisarte. Las operaciones de pago necesitan confirmación explícita (confirm_paid=true) y tus propias claves de proveedor. tool-catalog marca qué herramientas pueden gastar dinero.
¿Cómo lo desactivo?
Ejecuta seohead mcp disable. Un servidor en marcha rechaza entonces nuevas llamadas a herramientas. uninstall elimina la entrada de la configuración de un cliente y la restaura desde la copia de seguridad.

Pruébalo en tu propio sitio