OpenWeb Ninja MCP

OpenWeb Ninja MCP Server

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

每個 API 產品各有一個工具（共 52 個工具），每個工具都提供該 API 的操作；另有一個 subscribe 工具，可依需求新增 API 的免費方案，總計 53 個工具。結構描述直接從 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 設定中使用相同的 command / args / env 格式（mcp.json 或同等設定）。

從原始碼建置（本機開發）

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）。適用於預備環境／測試。

可用工具（53 個）

搜尋與探索： 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_aliexpress_data、realtime_costco_data、real_time_wayfair_data、realtime_homedepot_data、realtime_lowes_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 中經整理的說明）。