OpenWeb Ninja MCP

OpenWeb Ninja MCP Server

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

Ein Tool pro API-Produkt (52 Tools), das jeweils die Operationen dieser API bereitstellt, sowie ein subscribe-Tool, um bei Bedarf den kostenlosen Tarif einer API hinzuzufügen — insgesamt 53 Tools. Die Schemas werden direkt aus den OpenAPI-Spezifikationen von OpenWeb Ninja generiert, sodass der Server stets den aktuellen APIs entspricht.

Einrichtung

Du benötigst einen OpenWeb Ninja API-Schlüssel. Du erhältst ihn unter openwebninja.com.

Der Server wird über npx ausgeführt — eine globale Installation ist nicht erforderlich. Wähle unten deinen Client aus; npx ruft @openwebninja/mcp-server bei Bedarf ab.

Claude Desktop

Füge Folgendes zu claude_desktop_config.json hinzu (Settings -> Developer -> Edit Config):

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

Verwende dieselbe Struktur für command / args / env in der MCP-Konfiguration des Clients (mcp.json oder entsprechend).

Aus dem Quellcode (lokale Entwicklung)

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

Verweise anschließend in deinem MCP-Client auf den erstellten 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 erwartet zwei Eingaben:

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

Die Toolbeschreibung führt alle Operationen und ihre erforderlichen Parameter auf. Beispielaufruf des Tools jsearch:

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

Argumente werden vor dem Senden der Anfrage validiert und typgerecht umgewandelt. Die Antworten enthalten die OpenWeb Ninja-Nutzdaten data sowie ein request_id.

Umgebungsvariablen

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

Verfügbare Tools (54)

Suche & Entdeckung: realtime_web_search, realtime_bing_search_data, 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, local_business_database, yelp_business_data, trustpilot_company_and_reviews, local_rank_tracker, driving_directions, waze, google_maps_traffic_alerts, ev_charge_finder

Stellenangebote & Unternehmen: jsearch, realtime_linkedin_data, realtime_indeed_data, realtime_ziprecruiter_data, realtime_monster_data, job_salary_data, realtime_glassdoor_data

Handel & Produkte: realtime_amazon_data, realtime_product_search, real_time_walmart_data, real_time_ebay_data, realtime_aliexpress_data, realtime_costco_data, real_time_wayfair_data, realtime_homedepot_data, realtime_lowes_data, realtime_books_data, play_store_apps

Immobilien: realtime_zillow_data, real_time_redfin_data

Finanzen & Veranstaltungen: realtime_finance_data, realtime_events_data

Kontakt & Anreicherung: website_contacts_scraper, email_search, realtime_similarweb_data

Dienstprogramme: web_unblocker

LLM-Relays: chatgpt, gemini, copilot

Zugriff: subscribe (fügt bei Bedarf den kostenlosen Tarif einer API 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 lautet: OpenAPI-Spezifikationen (openapi-cache/) -> scripts/generate.ts -> src/generated/manifest.ts -> Tools, die zur Laufzeit in src/server.ts registriert werden. Um eine API hinzuzufügen oder zu aktualisieren, synchronisiere die Spezifikationen erneut und generiere sie neu; manueller Code pro Tool ist nicht erforderlich (nur die kuratierten Beschreibungen in src/lib/descriptions.ts).