OpenWeb Ninja MCP

Serveur MCP OpenWeb Ninja

Serveur officiel Model Context Protocol pour les API OpenWeb Ninja. Offre à tout agent IA compatible MCP (Claude, Cursor, Cline et autres) un accès en temps réel à la recherche web, aux données d'entreprises locales, aux offres d'emploi, au e-commerce, à l'immobilier, à la finance, à l'actualité et bien plus, via une connexion unique.

Un outil par produit API (41 outils), chacun exposant les opérations de cette API, plus un outil subscribe pour ajouter le niveau gratuit d'une API à la demande — 42 outils au total. Les schémas sont générés directement à partir des spécifications OpenAPI d'OpenWeb Ninja, afin que le serveur corresponde toujours aux API en production.

Configuration

Vous avez besoin d'une clé API OpenWeb Ninja. Obtenez-en une sur openwebninja.com.

Le serveur s'exécute via npx — aucune installation globale n'est nécessaire. Choisissez votre client ci-dessous ; npx récupère @openwebninja/mcp-server à la demande.

Bureau Claude

Ajoutez à claude_desktop_config.json (Paramètres -> Développeur -> Modifier la configuration) :

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

Code Claude

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

Cursor / Cline / Continue / Windsurf

Utilisez la même structure command / args / env dans la configuration MCP du client (mcp.json ou équivalent).

Depuis les sources (développement local)

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

Puis pointez votre client MCP vers le point d'entrée construit :

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

Fonctionnement des outils

Chaque outil correspond à une API OpenWeb Ninja et prend deux entrées :

• operation : quel point de terminaison appeler (par ex. search, product_details)
• args : les paramètres de cette opération

La description de l'outil liste chaque opération et ses paramètres requis. Exemple d'appel à l'outil jsearch :

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

Les arguments sont validés et convertis avant l'envoi de la requête, et les réponses renvoient la charge utile data d'OpenWeb Ninja plus un request_id.

Variables d'environnement

Variable	Requise	Description
OPENWEBNINJA_API_KEY	oui	Votre clé API OpenWeb Ninja (envoyée comme x-api-key).
OPENWEBNINJA_BASE_URL	non	Remplace l'hôte de l'API (par défaut https://api.openwebninja.com). Pour la préproduction/les tests.

Outils disponibles (42)

Recherche et découverte : 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 et cartes : local_business_data, yelp_business_data, trustpilot_company_and_reviews, local_rank_tracker, driving_directions, waze, ev_charge_finder

Emplois et entreprises : jsearch, job_salary_data, realtime_glassdoor_data

Commerce et produits : 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

Immobilier : realtime_zillow_data, real_time_redfin_data

Finance et événements : realtime_finance_data, realtime_events_data

Contact et enrichissement : website_contacts_scraper, email_search

Utilitaires : web_unblocker

Relais LLM : chatgpt, gemini, copilot

Accès : subscribe (ajouter le niveau gratuit d'une API à la demande)

Développement

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

Le pipeline est le suivant : spécifications OpenAPI (openapi-cache/) -> scripts/generate.ts -> src/generated/manifest.ts -> outils enregistrés à l'exécution dans src/server.ts. Pour ajouter ou mettre à jour une API, resynchronisez les spécifications et régénérez ; aucun code manuel par outil n'est nécessaire (seules les descriptions organisées dans src/lib/descriptions.ts).