OpenWeb Ninja MCP

官方

官方 OpenWeb Ninja MCP 伺服器，可將任何 AI 代理連接到 40 多個網路資料 API，用於網路搜尋、電子商務、本地商家、工作、房地產和金融資料。

GitHub

你可以用 Open Web Ninja MCP 做什麼？

即時搜尋網路 — 要求取得最新的網頁結果、新聞、論壇、圖片或影片，使用 realtime_web_search、real_time_news_search、realtime_forums_search 及相關工具。
尋找本地商家與評論 — 查詢商家詳細資訊、Yelp 資料、Trustpilot 評論，或透過 local_business_data、yelp_business_data、trustpilot_company_and_reviews 和 driving_directions 取得駕駛路線。
搜尋職缺與薪資 — 使用 jsearch 查詢職缺列表，或從 job_salary_data 和 realtime_glassdoor_data 取得薪資與公司評論資料。
研究產品與價格 — 透過 realtime_amazon_data、real_time_walmart_data、real_time_ebay_data 及類似工具取得 Amazon、Walmart、eBay、Costco 或 Wayfair 的產品資料。
存取房地產列表 — 使用 realtime_zillow_data 和 real_time_redfin_data 從 Zillow 或 Redfin 提取房產資料。
按需新增 API — 使用 subscribe 啟用任何 OpenWeb Ninja API 的免費方案，無需離開對話。

文件

OpenWeb Ninja MCP 伺服器

OpenWeb Ninja API 的官方 Model Context Protocol 伺服器。透過單一連線，讓任何相容 MCP 的 AI 代理（Claude、Cursor、Cline 等）即時存取網頁搜尋、本地商家資料、職缺、電子商務、房地產、金融、新聞等更多資訊。

每個 API 產品對應一個工具（共 41 個工具），每個工具會公開該 API 的操作，再加上一個 subscribe 工具，可依需求新增 API 的免費層級——總計 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" }
    }
  }
}

工具運作方式

每個工具對應一個 OpenWeb Ninja API，並接受兩個輸入：

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 中精心編寫說明）。