OpenWeb Ninja MCP

OpenWeb Ninja MCP サーバー

OpenWeb Ninja API の公式 Model Context Protocol サーバーです。MCP に対応したあらゆる AI エージェント（Claude、Cursor、Cline など）が、1 つの接続を通じて、ウェブ検索、地域のビジネス情報、求人、e コマース、不動産、金融、ニュースなどにリアルタイムでアクセスできます。

API 製品ごとに 1 つのツール（計 50 個）があり、それぞれの API の操作を提供します。また、必要に応じて API の無料枠を追加できる subscribe ツールも用意されており、ツールは合計 51 個です。スキーマは OpenWeb Ninja の OpenAPI 仕様から直接生成されるため、サーバーは常に最新の API と一致します。

セットアップ

OpenWeb Ninja API キーが必要です。openwebninja.com で取得してください。

サーバーは npx で実行するため、グローバルにインストールする必要はありません。以下からクライアントを選択してください。npx が必要に応じて @openwebninja/mcp-server を取得します。

Claude Desktop

claude_desktop_config.json に追加します（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

クライアントの MCP 設定（mcp.json または同等のファイル）で、同じ command / args / env の形式を使用してください。

ソースから（ローカル開発）

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

次に、ビルドしたエントリを MCP クライアントに指定します：

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

ツールの仕組み

各ツールは 1 つの OpenWeb Ninja API に対応し、次の 2 つの入力を受け取ります。

• operation：呼び出すエンドポイント（例：search、product_details）
• args：その操作のパラメーター

ツールの説明には、すべての操作と必須パラメーターが記載されています。jsearch ツールの呼び出し例：

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

リクエストを送信する前に引数の検証と型変換が行われ、レスポンスでは OpenWeb Ninja の data ペイロードと request_id が返されます。

環境変数

変数	必須	説明
OPENWEBNINJA_API_KEY	はい	OpenWeb Ninja API キー（x-api-key として送信されます）。
OPENWEBNINJA_BASE_URL	いいえ	API ホストを上書きします（デフォルトは https://api.openwebninja.com）。ステージング／テスト用です。

利用可能なツール（51）

検索と情報発見： 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

地域情報と地図： 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

求人と企業： jsearch、realtime_linkedin_data、realtime_indeed_data、realtime_ziprecruiter_data、realtime_monster_data、realtime_bing_jobs_data、job_salary_data、realtime_glassdoor_data

コマースと製品： realtime_amazon_data、realtime_product_search、real_time_walmart_data、real_time_ebay_data、realtime_costco_data、real_time_wayfair_data、realtime_homedepot_data、realtime_books_data、play_store_apps

不動産： realtime_zillow_data、real_time_redfin_data

金融とイベント： realtime_finance_data、realtime_events_data

連絡先と情報拡充： website_contacts_scraper、email_search

ユーティリティ： web_unblocker

LLM リレー： chatgpt、gemini、copilot

アクセス： subscribe（必要に応じて API の無料枠を追加）

開発

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

パイプラインは次のとおりです：OpenAPI 仕様（openapi-cache/）-> scripts/generate.ts -> src/generated/manifest.ts -> src/server.ts で実行時にツールを登録します。API を追加または更新するには、仕様を再同期して再生成してください。ツールごとにコードを手書きする必要はありません（src/lib/descriptions.ts にある厳選された説明のみ必要です）。