XiaoFlow MCP Server

Servidor MCP oficial para las herramientas de SEO de XiaoFlow AI y la inteligencia de mercado de Etsy

Documentación

XiaoFlow MCP Server (`xiaoflow-mcp-server`)

Servidor oficial del Model Context Protocol (MCP) para las herramientas de inteligencia de SEO y palabras clave de XiaoFlow AI.

Conecta modelos de lenguaje de gran tamaño (LLMs) como Claude Desktop, Cursor, Windsurf y VS Code directamente con las herramientas de optimización de motores de búsqueda, descubrimiento de palabras clave y análisis de dominios de XiaoFlow.

Punto final remoto: https://mcp.xiaoflow.com/mcp

Transporte: MCP Streamable HTTP con OAuth 2.1 / PKCE, además de stdio a través del paquete npm

Seguridad: Herramientas de investigación de solo lectura, excepto la creación asíncrona de tareas de expansión; no hay herramientas destructivas

Listados oficiales

✨ Características y capacidades

🔍 Descubrimiento de palabras clave: genera palabras clave de alta intención e ideas de SEO a partir de semillas de palabras clave, URL o dominios.
📊 Análisis de dominios: analiza el rendimiento de búsqueda a nivel de dominio, métricas de tráfico orgánico y distribuciones de palabras clave.
📈 Análisis de tendencias de búsqueda: compara demanda de palabras clave, competencia, CPC y tendencias históricas.
🔒 Autenticación flexible: admite autenticación por clave API mediante parámetros de consulta (?key=), tokens Bearer, variables de entorno o inicio de sesión Web OAuth.

⚡ Inicio rápido

1. Ejecutar mediante `npx` (stdio)

Ejecuta el servidor directamente usando npx:

npx -y xiaoflow-mcp-server

Pasa tu clave API de XiaoFlow mediante una variable de entorno:

XIAOFLOW_API_KEY="YOUR_API_KEY" npx -y xiaoflow-mcp-server

2. Conectar mediante Streamable HTTP con inicio de sesión web (recomendado)

Usa el punto final remoto canónico en clientes que admitan MCP remoto. El cliente descubre OAuth de XiaoFlow automáticamente y abre el navegador para iniciar sesión y otorgar consentimiento:

https://mcp.xiaoflow.com/mcp

Los clientes heredados aún pueden usar https://mcp.xiaoflow.com/sse?key=YOUR_API_KEY.

💻 Guías de integración con clientes

Configuración en Cursor

Añade XiaoFlow MCP a Cursor:

Nombre: xiaoflow
Tipo: http
URL: https://mcp.xiaoflow.com/mcp

O haz clic en Añadir a Cursor directamente en el Portal MCP de XiaoFlow.

Configuración en Claude Desktop

Añade la siguiente entrada a tu claude_desktop_config.json:

{
  "mcpServers": {
    "xiaoflow": {
      "command": "npx",
      "args": ["-y", "xiaoflow-mcp-server"],
      "env": {
        "XIAOFLOW_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf, VS Code y otros clientes remotos

Usa la configuración HTTP nativa cuando esté disponible:

{
  "mcpServers": {
    "xiaoflow": {
      "type": "http",
      "url": "https://mcp.xiaoflow.com/mcp"
    }
  }
}

Para clientes solo stdio, conecta mediante el punto final remoto habilitado para OAuth:

{
  "mcpServers": {
    "xiaoflow": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.xiaoflow.com/mcp"]
    }
  }
}

🛠️ Herramientas MCP disponibles

Herramienta MCP	Descripción	Parámetros de entrada clave
`get_keyword_metrics`	Métricas exactas e historial mensual de una palabra clave	`keyword`, `history_months` (1–48), `location`, `language`
`get_related_keywords`	Palabras clave relacionadas con métricas/historial y paginación ilimitada	`seed`, `history_months`, `page`, `page_size` (máx. 1,000)
`bulk_keyword_metrics`	Métricas/historial exactos de hasta 1,000 palabras clave	`keywords`, `history_months`, `location`, `language`
`start_keyword_expansion`	Inicia expansión por rondas a partir de una o más semillas	`seeds`, `max_iterations`, reglas de inclusión/exclusión
`get_keyword_expansion_status`	Consulta una tarea de expansión y recupera resultados	`task_id`, `include_results`
`analyze_url`	Analiza la visibilidad de búsqueda de una página o dominio	`url`, `site`, `brand`, `location`, `language`
`get_domain_stats`	Vista general de métricas de búsqueda y tendencias de tráfico de un dominio	`domain`, `brand` (requeridos: `0`=dominio, `1`=marca)
`list_domain_keywords`	Recupera una lista paginada de palabras clave del dominio	`domain`, `brand`, `page`, `page_size`
`get_keyword_details`	Recupera métricas de palabras clave para una ventana de 12, 24 o 48 meses	`slug`, `time_range`, `location`, `language`
`discover_keywords`	Descubrimiento de palabras clave relacionadas compatible con versiones anteriores	`keyword`, `url`, `site`, `location`, `language`
`bulk_keyword_lookup`	Consulta de métricas por lotes compatible con versiones anteriores	`keywords`, `location`, `language`

Los alias heredados permanecen disponibles para compatibilidad con versiones anteriores.

Cada herramienta publica:

descripciones para cada parámetro de entrada;
un esquema de salida JSON con nombre, que incluye campos de éxito y error;
anotaciones de seguridad MCP (readOnlyHint, destructiveHint, idempotentHint y openWorldHint);
un título de herramienta legible por humanos para clientes y directorios MCP.

Ejemplos de prompts

Get US English metrics and 24 months of history for "AI SEO tools".

Find every related keyword for "standing desk", 200 per page, and continue
until has_more is false. Return search volume, CPC, competition, intent, and history.

Compare these 1,000 keywords over 48 months and rank them by search volume growth.

Expand "home office" for four rounds, keep terms with at least 100 monthly
searches, and poll the task until it is complete.

🔑 Autenticación

Obtén tu clave API desde el Panel MCP de XiaoFlow.

Métodos de autenticación admitidos:

Inicio de sesión Web OAuth (recomendado): conéctate a https://mcp.xiaoflow.com/mcp; los clientes compatibles descubren automáticamente OAuth, PKCE y el registro dinámico de clientes.
Variable de entorno: establece XIAOFLOW_API_KEY al ejecutar mediante npx.
Encabezado de autorización: envía Authorization: Bearer YOUR_API_KEY.
Parámetro de consulta heredado: añade ?key=YOUR_API_KEY a la URL SSE heredada.

🐳 Docker / Glama

El repositorio incluye un Dockerfile de múltiples etapas para producción, útil para la verificación de compilación en directorios y el despliegue con stdio:

docker build -t xiaoflow-mcp .
docker run --rm -i \
  -e XIAOFLOW_API_KEY="YOUR_API_KEY" \
  xiaoflow-mcp

La imagen se ejecuta como el usuario Node sin privilegios, excluye secretos locales y estado de compilación, y escribe mensajes de protocolo MCP únicamente en la salida estándar.

🔐 Seguridad y manejo de datos

El inicio de sesión OAuth ocurre solo en www.xiaoflow.com; los clientes MCP nunca reciben tu contraseña.
Las claves API y los tokens OAuth se envían solo al punto final de API de XiaoFlow configurado.
El servidor no escanea ni sube archivos del proyecto.
Las llamadas a herramientas consultan datos externos respaldados por XiaoFlow/Google Ads y pueden consumir créditos de la cuenta.
Ninguna herramienta elimina o modifica datos de palabras clave o dominios.

Reporta vulnerabilidades de forma privada a través del propietario del repositorio o de la página de contacto de XiaoFlow. No incluyas tokens ni datos de clientes en problemas públicos.

✅ Calidad y compatibilidad

Protocolo MCP: Streamable HTTP y stdio
Autenticación: OAuth 2.1 con PKCE, clave API Bearer
Esquemas de herramientas: descripciones de parámetros, esquemas de salida estructurados, anotaciones
Métodos de descubrimiento opcionales: recursos y prompts devuelven listas vacías válidas
Tiempo de ejecución: Node.js 18+ (node:20-alpine en Docker)
Extremo continuo: https://mcp.xiaoflow.com/mcp

XiaoFlow MCP Server

Documentación