SERPHouse MCP

Permite que agentes y herramientas de IA accedan a datos de motores de búsqueda en tiempo real y de alto volumen a través de una interfaz unificada del Protocolo de Contexto de Modelo.

GitHub

Prueba este MCPPatrocinado

Documentación

SERPHouse MCP Server

Conecta asistentes de IA a datos SERP en vivo, verticales de Google e inteligencia SEO, impulsado por SERPHouse.

Ejecuta búsquedas en Google, Bing y Yahoo, resuelve ubicaciones y consulta Empleos, Local, Videos y más, directamente desde Cursor, VS Code, Claude Desktop o cualquier cliente compatible con MCP. No se requiere integración de API personalizada.

Por qué SERPHouse MCP


21 herramientas MCP	SERP en vivo de Google, Bing y Yahoo, verticales de Google y consultas de cuenta, todo expuesto con esquemas tipados
Cero código de integración	Tu asistente elige la herramienta adecuada; tú describes lo que necesitas en lenguaje natural
Alojado o autoalojado	Usa el endpoint gestionado en `https://mcp.serphouse.com/mcp` o ejecuta el servidor en tu propia infraestructura
Contexto integrado	Los recursos MCP (`serphouse_capabilities`, `serphouse_constraints`, `serphouse_examples`) enseñan las reglas de uso a la IA automáticamente

Inicio rápido (alojado)

El camino más rápido: sin paso de compilación, sin servidor que mantener.

1. Obtén tu clave de API desde el Panel de SERPHouse.

2. Añade el servidor a la configuración de tu cliente MCP usando autenticación basada en cabecera o basada en URL (consulta Autenticación para más detalles).

Cabecera (recomendado):

{
  "mcpServers": {
    "serphouse": {
      "url": "https://mcp.serphouse.com/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

Ruta URL:

{
  "mcpServers": {
    "serphouse": {
      "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

3. Empieza a conversar. Pide a tu asistente que busque en Google, Bing o Yahoo, consulte ubicaciones, obtenga empleos o revise tu cuenta: enrutará a la herramienta correcta.

Instalación con un clic: usa las insignias Instalar en VS Code o Instalar en Cursor de arriba y luego reemplaza la clave de API de ejemplo con la tuya.

Autenticación

El servidor acepta tu clave de API de SERPHouse de dos maneras. Usa la que se adapte a tu cliente MCP.

Método	Endpoint	Cómo pasar la clave
Cabecera (recomendado)	`POST /mcp`	Cabecera de solicitud `SERPHOUSE_API: <api_key>`
Ruta URL	`POST /{apiKey}/mcp`	Incorpora la clave en la ruta de la URL

Las herramientas y los recursos se pueden descubrir sin clave. La clave de API solo se requiere al llamar a las herramientas de la API de SERPHouse.

Opción A: Cabecera (recomendado)

Ideal cuando tu cliente MCP admite cabeceras personalizadas. Mantiene la clave fuera de las URLs y de los registros de acceso del servidor.

{
  "mcpServers": {
    "serphouse": {
      "url": "https://mcp.serphouse.com/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

Ejemplo autoalojado:

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

Opción B: Ruta URL

Útil cuando tu cliente solo admite una URL y no puede enviar cabeceras personalizadas.

{
  "mcpServers": {
    "serphouse": {
      "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

Ejemplo autoalojado:

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

Nota: la autenticación basada en URL coloca la clave de API en la ruta de la solicitud, que puede aparecer en los registros del proxy o en el historial del navegador. Prefiere el método de cabecera cuando sea posible.

Qué puedes preguntar

Para equipos de SEO, agencias y especialistas en marketing SaaS que necesitan datos de búsqueda en vivo dentro de su flujo de trabajo de IA, sin paneles, scripts ni cambios de contexto.

Por qué lo usas	Ejemplo de prompt
Seguimiento de posiciones	"¿Dónde aparecemos en Google EE. UU. de escritorio para 'crm software'?"
Supera a la competencia	"¿Quién ocupa los 5 primeros puestos de 'project management software' en Londres?"
Domina la búsqueda local	"Principales resultados de Google Local para 'emergency plumber' en Chicago."
Descubre palabras clave	"¿Qué sugiere Autocomplete para 'best saas for'?"
Monitorea posiciones	"Ejecuta una verificación SERP móvil de Bing para nuestra marca en Nueva York e informa nuestra posición."
Cobertura multi-motor	"Compara los resultados de noticias de Yahoo y Google para 'electric vehicles'."

Resumen de herramientas

El servidor expone 21 herramientas en cinco categorías. Las solicitudes SERP de Google y Bing requieren exactamente un campo de ubicación: loc (p. ej. Austin,Texas,United States) o loc_id (de serphouse_location_search). Nunca envíes ambos ni omitas ambos en esos endpoints. Las herramientas SERP de Yahoo no requieren ubicación.

Referencia

Herramienta	Descripción
`serphouse_domain_list`	Dominios de búsqueda compatibles de Google, Bing y Yahoo
`serphouse_language_list`	Códigos de idioma por tipo de motor de búsqueda
`serphouse_location_search`	Resuelve nombres de ciudad/país a `loc_id`
`serphouse_account_info`	Saldo y uso de la cuenta

Google SERP

Herramienta	Descripción
`serphouse_google_web`	Búsqueda web de Google
`serphouse_google_image`	Búsqueda de imágenes de Google
`serphouse_google_news`	Búsqueda de noticias de Google
`serphouse_google_shop`	Búsqueda de compras de Google
`serphouse_serp_google_advanced`	SERP avanzado de Google con parámetros extendidos (hasta 100 resultados)

Bing SERP

Herramienta	Descripción
`serphouse_bing_web`	Búsqueda web de Bing
`serphouse_bing_image`	Búsqueda de imágenes de Bing
`serphouse_bing_news`	Búsqueda de noticias de Bing

Yahoo SERP

Herramienta	Descripción
`serphouse_yahoo_web`	Búsqueda web de Yahoo
`serphouse_yahoo_image`	Búsqueda de imágenes de Yahoo
`serphouse_yahoo_news`	Búsqueda de noticias de Yahoo

Verticales de Google

Herramienta	Descripción
`serphouse_google_jobs`	Búsqueda de empleos de Google
`serphouse_google_autocomplete`	Sugerencias de Autocomplete de Google
`serphouse_google_videos`	Resultados de videos de Google
`serphouse_google_short_videos`	Videos cortos de Google (Shorts)
`serphouse_google_forums`	Resultados de foros de Google
`serphouse_google_local`	Resultados de Google Local / Maps

Autoalojamiento local

Ejecuta el servidor en tu máquina para tener control total o desarrollo local.

git clone https://github.com/SERPHouse/serphouse-mcp.git
cd serphouse-mcp
npm install
npm run build
npm start

El servidor escucha en http://localhost:3000. Endpoints MCP:

POST /mcp — pasa la clave de API mediante la cabecera SERPHOUSE_API
POST /{apiKey}/mcp — pasa la clave de API en la ruta de la URL

Apunta tu cliente MCP a la instancia local (consulta Autenticación para ambas opciones):

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

O con autenticación basada en URL:

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

Comandos

Comando	Descripción
`npm run build`	Compila TypeScript a `dist/`
`npm start`	Ejecuta el servidor HTTP (`http://localhost:3000/mcp`)
`npm run start:stdio`	Ejecuta el servidor de transporte stdio (modo de proceso MCP local)
`npm run dev`	Ejecuta el servidor HTTP con recarga en caliente
`npm run dev:ins`	Inicia MCP Inspector contra el servidor stdio para depuración
`npm run typecheck`	Verifica tipos sin emitir archivos

Verificación de estado: GET http://localhost:3000/health

Opciones del servidor

Variable	Predeterminado	Descripción
`PORT`	`3000`	Puerto de escucha HTTP
`HOST`	`0.0.0.0`	Dirección de enlace HTTP

La autenticación admite tanto cabecera como ruta URL. Consulta Autenticación.

Autoalojamiento con Docker

Ejecuta el servidor MCP localmente en Docker sin instalar Node.js.

docker compose up -d

El servidor se ejecuta en http://localhost:3000/mcp (autenticación por cabecera) o http://localhost:3000/{apiKey}/mcp (autenticación por URL).

Conecta tu cliente MCP usando cualquiera de los métodos de Autenticación:

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

Uso con modelos Llama locales (Ollama)

Conecta tu SERPHouse MCP Server a un modelo Llama local (p. ej. Llama 3.1 o 3.2) usando ollmcp, un cliente de interfaz de terminal interactiva que lleva el poder de búsqueda en tiempo real directamente a tu flujo de trabajo LLM local.

Requisitos previos

Requisito	Notas
Modelo Llama con llamada a herramientas	Un modelo que admita llamadas a herramientas (p. ej. `llama3.1`, `llama3.2`) instalado y ejecutándose mediante Ollama
Python 3.10+	Necesario para ejecutar el cliente de terminal `ollmcp`
Node.js	Necesario para ejecutar el SERPHouse MCP server mediante `npx`

1. Instala `ollmcp`

ollmcp es un cliente de Python, así que instálalo globalmente con pip:

pip install --upgrade ollmcp

2. Crea un archivo `config.json`

El cliente necesita un perfil de configuración que le indique cómo conectarse al servidor de SERPHouse y pasar tus credenciales de API. Crea un config.json en tu carpeta de trabajo usando cualquiera de los métodos de autenticación de Autenticación:

{
  "mcpServers": {
    "serphouse-mcp": {
      "url": "https://mcp.serphouse.com/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

O con autenticación basada en URL:

{
  "mcpServers": {
    "serphouse-mcp": {
      "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

Reemplaza YOUR_SERPHouse_API_KEY con tu clave activa del Panel de SERPHouse.

3. Ejecuta el cliente de terminal

Inicia la interfaz interactiva, pasando tu perfil de configuración y el modelo objetivo:

ollmcp --servers-json config.json --model llama3.1

Cuando se cargue la interfaz de terminal:

Selecciona tu modelo Llama objetivo de la lista de modelos.
Envía un prompt que necesite datos web en vivo, p. ej. "Busca los principales resultados de Google para 'best developer tools' usando SERPHouse."
Observa cómo tu modelo Llama local llama a las herramientas de SERPHouse y convierte los datos SERP en tiempo real en una respuesta conversacional.

Modelos compatibles

Los siguientes modelos de Ollama funcionan bien con el uso de herramientas:

gemma4
qwen3.5
lfm2.5-thinking
llama3.2
mistral

Para obtener una lista completa de modelos de Ollama con capacidades de uso de herramientas, visita la página oficial de modelos de Ollama.

Para modelos que también pueden procesar imágenes devueltas por las herramientas, consulta la página de modelos de visión de Ollama.

Solución de problemas

Problema	Solución
Clave de API faltante	Envía la cabecera `SERPHOUSE_API` en `POST /mcp`, o usa `POST /{apiKey}/mcp` con la clave en la ruta de la URL
Clave no válida	Verifica tu clave en el panel de SERPHouse
Crédito agotado	Revisa el saldo con `serphouse_account_info`
Error de ubicación	Para las herramientas de Google y Bing, incluye `loc` o `loc_id` (no ambos); usa `serphouse_location_search` para resolver IDs. Las herramientas SERP de Yahoo no requieren ubicación.
Conexión rechazada	Confirma que el servidor está en ejecución y que la URL/puerto es correcto

Contribuciones

Las contribuciones son bienvenidas. Mantén los cambios enfocados y acordes al estilo de código existente.

git checkout -b feature/your-feature
npm install
# make changes
npm run typecheck
git commit -m "Add your feature"
git push origin feature/your-feature

Luego abre un Pull Request. Actualiza este README si cambias la configuración o el setup.