OpenWeb Ninja MCP

官方

官方 OpenWeb Ninja MCP 服务器，将任何 AI 代理连接到 40 多个网络数据 API，用于网络搜索、电子商务、本地商家、招聘、房地产和金融数据。

GitHub

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

实时搜索网络 — 使用 realtime_web_search、real_time_news_search、realtime_forums_search 及相关工具，查询当前网页结果、新闻、论坛、图片或视频。
查找本地商家与评价 — 通过 local_business_data、yelp_business_data、trustpilot_company_and_reviews 和 driving_directions 查询商家详情、Yelp 数据、Trustpilot 评价或获取驾车路线。
搜索职位与薪资 — 使用 jsearch 查询职位列表，或通过 job_salary_data 和 realtime_glassdoor_data 获取薪资及公司评价数据。
研究产品与价格 — 通过 realtime_amazon_data、real_time_walmart_data、real_time_ebay_data 等工具获取亚马逊、沃尔玛、eBay、Costco 或 Wayfair 的产品数据。
访问房产列表 — 使用 realtime_zillow_data 和 real_time_redfin_data 从 Zillow 或 Redfin 拉取房产数据。
按需添加 API — 使用 subscribe 激活任意 OpenWeb Ninja API 的免费套餐，无需离开当前对话。

文档

OpenWeb Ninja MCP 服务器

官方 Model Context Protocol 服务器，用于 OpenWeb Ninja API。通过单一连接，为任何兼容 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 中精心编写的描述）。