OpenWeb Ninja MCP

OpenWeb Ninja MCP サーバー

OpenWeb Ninja API の公式 Model Context Protocol サーバーです。MCP 互換の AI エージェント (Claude、Cursor、Cline など) に、単一の接続でウェブ検索、ローカルビジネスデータ、求人、E コマース、不動産、金融、ニュースなどへのリアルタイムアクセスを提供します。

API 製品ごとに 1 つのツール (41 ツール) があり、それぞれがその API の操作を公開します。さらに、オンデマンドで API の無料枠を追加するための subscribe ツールがあり、合計 42 ツールです。スキーマは OpenWeb Ninja の OpenAPI 仕様から直接生成されるため、サーバーは常に最新の API と一致します。

セットアップ

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

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

Claude Desktop

claude_desktop_config.json (設定 -> 開発者 -> 設定を編集) に追加します:

{
  "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)。ステージング/テスト用です。

利用可能なツール (42)

検索 & ディスカバリー: 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_business_data、yelp_business_data、trustpilot_company_and_reviews、local_rank_tracker、driving_directions、waze、ev_charge_finder

求人 & 企業: jsearch、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_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 のキュレーションされた説明のみが必要です)。