OpenWeb Ninja MCP Server

OpenWeb Ninja MCP Server

Offizieller Model Context Protocol-Server für OpenWeb Ninja-APIs. Ermöglicht jedem MCP-kompatiblen KI-Agenten (Claude, Cursor, Cline und andere) Echtzeitzugriff auf Websuche, lokale Unternehmensdaten, Jobs, E-Commerce, Immobilien, Finanzen, Nachrichten und mehr – über eine einzige Verbindung.

Ein Tool pro API-Produkt (41 Tools), jedes stellt die Operationen dieser API bereit, plus ein subscribe-Tool zum bedarfsweisen Hinzufügen des kostenlosen Kontingents einer API – insgesamt 42 Tools. Schemata werden direkt aus den OpenAPI-Spezifikationen von OpenWeb Ninja generiert, sodass der Server stets mit den Live-APIs übereinstimmt.

Einrichtung

Sie benötigen einen OpenWeb Ninja API-Schlüssel. Erhalten Sie einen unter openwebninja.com.

Der Server läuft über npx – es muss nichts global installiert werden. Wählen Sie unten Ihren Client aus; npx ruft @openwebninja/mcp-server bei Bedarf ab.

Claude Desktop

Zu claude_desktop_config.json hinzufügen (Einstellungen -> Entwickler -> Konfiguration bearbeiten):

{
  "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

Verwenden Sie dieselbe command / args / env-Struktur in der MCP-Konfiguration des Clients (mcp.json oder Äquivalent).

Aus dem Quellcode (lokale Entwicklung)

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

Richten Sie dann Ihren MCP-Client auf den gebauten Einstiegspunkt:

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

Funktionsweise der Tools

Jedes Tool ist einer OpenWeb Ninja API zugeordnet und akzeptiert zwei Eingaben:

• operation: welcher Endpunkt aufgerufen werden soll (z. B. search, product_details)
• args: die Parameter für diese Operation

Die Tool-Beschreibung listet jede Operation und ihre erforderlichen Parameter auf. Beispielaufruf des jsearch-Tools:

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

Argumente werden validiert und typkonvertiert, bevor die Anfrage gesendet wird, und Antworten liefern die OpenWeb Ninja data-Nutzlast sowie eine request_id.

Umgebungsvariablen

Variable	Erforderlich	Beschreibung
OPENWEBNINJA_API_KEY	ja	Ihr OpenWeb Ninja API-Schlüssel (gesendet als x-api-key).
OPENWEBNINJA_BASE_URL	nein	Überschreibt den API-Host (Standard ist https://api.openwebninja.com). Für Staging/Tests.

Verfügbare Tools (42)

Suche & Entdeckung: 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

Lokales & Karten: local_business_data, yelp_business_data, trustpilot_company_and_reviews, local_rank_tracker, driving_directions, waze, ev_charge_finder

Jobs & Unternehmen: jsearch, job_salary_data, realtime_glassdoor_data

Handel & Produkt: 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

Immobilien: realtime_zillow_data, real_time_redfin_data

Finanzen & Ereignisse: realtime_finance_data, realtime_events_data

Kontakt & Anreicherung: website_contacts_scraper, email_search

Dienstprogramm: web_unblocker

LLM-Relays: chatgpt, gemini, copilot

Zugriff: subscribe (fügt das kostenlose Kontingent einer API bei Bedarf hinzu)

Entwicklung

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

Die Pipeline ist: OpenAPI-Spezifikationen (openapi-cache/) -> scripts/generate.ts -> src/generated/manifest.ts -> Tools werden zur Laufzeit in src/server.ts registriert. Um eine API hinzuzufügen oder zu aktualisieren, synchronisieren Sie die Spezifikationen erneut und generieren Sie neu; es ist kein handgeschriebener Code pro Tool erforderlich (nur die kuratierten Beschreibungen in src/lib/descriptions.ts).