OpenWeb Ninja MCP

Servidor MCP de OpenWeb Ninja

Servidor oficial del Protocolo de Contexto de Modelo para las APIs de OpenWeb Ninja. Proporciona a cualquier agente de IA compatible con MCP (Claude, Cursor, Cline y otros) acceso en tiempo real a búsqueda web, datos de negocios locales, empleos, comercio electrónico, bienes raíces, finanzas, noticias y más, a través de una única conexión.

Una herramienta por producto de API (41 herramientas), cada una exponiendo las operaciones de esa API, más una herramienta subscribe para añadir el nivel gratuito de una API bajo demanda — 42 herramientas en total. Los esquemas se generan directamente desde las especificaciones OpenAPI de OpenWeb Ninja, por lo que el servidor siempre coincide con las APIs en vivo.

Configuración

Necesitas una clave de API de OpenWeb Ninja. Consíguela en openwebninja.com.

El servidor se ejecuta mediante npx — no hay nada que instalar globalmente. Elige tu cliente a continuación; npx obtiene @openwebninja/mcp-server bajo demanda.

Claude Desktop

Añade a claude_desktop_config.json (Configuración -> Desarrollador -> Editar Configuración):

{
  "mcpServers": {
    "openwebninja": {
      "command": "npx",
      "args": ["-y", "@openwebninja/mcp-server"],
      "env": { "OPENWEBNINJA_API_KEY": "your-api-key" }
    }
  }
}

Claude Code

claude mcp add openwebninja -e OPENWEBNINJA_API_KEY=your-api-key -- npx -y @openwebninja/mcp-server

Cursor / Cline / Continue / Windsurf

Usa la misma forma de command / args / env en la configuración MCP del cliente (mcp.json o equivalente).

Desde el código fuente (desarrollo local)

git clone <repo> && cd openwebninja-mcp
npm install
npm run build

Luego apunta tu cliente MCP a la entrada construida:

{
  "mcpServers": {
    "openwebninja": {
      "command": "node",
      "args": ["/absolute/path/to/openwebninja-mcp/dist/index.js"],
      "env": { "OPENWEBNINJA_API_KEY": "your-api-key" }
    }
  }
}

Cómo funcionan las herramientas

Cada herramienta se asigna a una API de OpenWeb Ninja y recibe dos entradas:

• operation: qué endpoint llamar (p. ej. search, product_details)
• args: los parámetros para esa operación

La descripción de la herramienta enumera cada operación y sus parámetros requeridos. Ejemplo de llamada a la herramienta jsearch:

{
  "operation": "search",
  "args": { "query": "site reliability engineer remote", "country": "us" }
}

Los argumentos se validan y se convierten de tipo antes de enviar la solicitud, y las respuestas devuelven la carga útil data de OpenWeb Ninja más un request_id.

Variables de entorno

Variable	Requerida	Descripción
OPENWEBNINJA_API_KEY	sí	Tu clave de API de OpenWeb Ninja (enviada como x-api-key).
OPENWEBNINJA_BASE_URL	no	Anula el host de la API (por defecto https://api.openwebninja.com). Para staging/pruebas.

Herramientas disponibles (42)

Búsqueda y descubrimiento: realtime_web_search, realtime_news_data, real_time_news_search, realtime_forums_search, web_search_autocomplete, realtime_image_search, reverse_image_search, realtime_lens_data, real_time_video_search, realtime_shorts_search, ai_overviews, google_ai_mode, social_links_search

Local y mapas: local_business_data, yelp_business_data, trustpilot_company_and_reviews, local_rank_tracker, driving_directions, waze, ev_charge_finder

Empleos y empresas: jsearch, job_salary_data, realtime_glassdoor_data

Comercio y producto: realtime_amazon_data, realtime_product_search, real_time_walmart_data, real_time_ebay_data, realtime_costco_data, real_time_wayfair_data, realtime_books_data, play_store_apps

Bienes raíces: realtime_zillow_data, real_time_redfin_data

Finanzas y eventos: realtime_finance_data, realtime_events_data

Contacto y enriquecimiento: website_contacts_scraper, email_search

Utilidad: web_unblocker

Retransmisiones LLM: chatgpt, gemini, copilot

Acceso: subscribe (añade el nivel gratuito de una API bajo demanda)

Desarrollo

npm run sync       # sync OpenAPI specs from S3 into openapi-cache/ (needs AWS creds)
npm run generate   # regenerate src/generated/manifest.ts from the specs
npm run build      # compile TypeScript to dist/
npm run dev        # run the server over stdio (tsx, no build)
npm run inspect    # launch the MCP Inspector against the server
npx tsx test/smoke.ts   # smoke test: list tools + validation + request path

El flujo es: especificaciones OpenAPI (openapi-cache/) -> scripts/generate.ts -> src/generated/manifest.ts -> herramientas registradas en tiempo de ejecución en src/server.ts. Para añadir o actualizar una API, vuelve a sincronizar las especificaciones y regenera; no se necesita código manual por herramienta (solo las descripciones curadas en src/lib/descriptions.ts).