
OpenWeb Ninja APIS MCP server
概览
OpenWeb Ninja API 的官方模型上下文协议服务器。通过单一连接,允许任何兼容 MCP 的 AI 代理(Claude、Cursor、Cline 等)实时访问网页搜索、本地商业数据、职位、电子商务、房地产、金融、新闻等内容。 每个API产品(41个工具)一个工具,每个工具暴露该API的操作,外加一个订阅工具,按需添加API的免费套餐——总共42个工具。模式直接根据OpenWeb Ninja的OpenAPI规范生成,因此服务器始终与实时API匹配。 你需要一个OpenWeb Ninja API密钥。openwebninja.com 获取一个。 服务器通过 npx 运行——全局无需安装任何东西。请在下方选择您的客户端;npx 按需获取 @openwebninja/mcp-server。 添加到claude_desktop_config.json(设置 -> 开发者 -> 编辑配置): 在客户端的MCP配置中使用相同的命令/args/env形状(mcp.json或等效代码)。
概述(AI 翻译)
OpenWeb Ninja API 的官方模型上下文协议服务器。通过单一连接,允许任何兼容 MCP 的 AI 代理(Claude、Cursor、Cline 等)实时访问网页搜索、本地商业数据、职位、电子商务、房地产、金融、新闻等内容。
每个API产品只有一个工具(50个工具),每个工具暴露该API的操作,外加一个subscribe工具,按需添加API的免费套餐——总共51个工具。模式直接根据OpenWeb Ninja的OpenAPI规范生成,因此服务器始终与实时API匹配。
布置
你需要一个OpenWeb Ninja API密钥。openwebninja.com 获取一个。
服务器通过 npx 运行——全局无需安装任何东西。请在下方选择您的客户端;npx 按需获取 @openwebninja/mcp-server。
克劳德桌面
添加到claude_desktop_config.json(设置 -> 开发者 -> 编辑配置):
克劳德·科德
光标 / 线索 / 继续 / 风帆冲浪
在客户端的MCP配置中使用相同的command / args / env形状(mcp.json或等效格式)。
来自源(地方发展)
然后指向已构建的入口:
工具的工作原理
每个工具映射到一个 OpenWeb Ninja API,并接受两个输入:
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
OpenWeb Ninja MCP Server
Official Model Context Protocol server for OpenWeb Ninja APIs. Gives any MCP-compatible AI agent (Claude, Cursor, Cline, and others) real-time access to web search, local business data, jobs, e-commerce, real estate, finance, news, and more, through a single connection.
One tool per API product (52 tools), each exposing that API’s operations, plus a subscribe tool for adding an API’s free tier on demand — 53 tools in total. Schemas are generated directly from OpenWeb Ninja’s OpenAPI specs, so the server always matches the live APIs.
Setup
You need an OpenWeb Ninja API key. Get one at openwebninja.com.
The server runs via npx — there’s nothing to install globally. Pick your client below; npx fetches @openwebninja/mcp-server on demand.
Claude Desktop
Add to 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
Use the same command / args / env shape in the client’s MCP config (mcp.json or equivalent).
From source (local development)
git clone && cd openwebninja-mcp
npm install
npm run build
Then point your MCP client at the built entry:
{
"mcpServers": {
"openwebninja": {
"command": "node",
"args": ["/absolute/path/to/openwebninja-mcp/dist/index.js"],
"env": { "OPENWEBNINJA_API_KEY": "your-api-key" }
}
}
}
How the tools work
Each tool maps to one OpenWeb Ninja API and takes two inputs:
operation: which endpoint to call (e.g.search,product_details)args: the parameters for that operation
The tool description lists every operation and its required parameters. Example call to the jsearch tool:
{
"operation": "search",
"args": { "query": "site reliability engineer remote", "country": "us" }
}
Arguments are validated and type-coerced before the request is sent, and responses return the OpenWeb Ninja data payload plus a request_id.
Environment variables
| Variable | Required | Description |
|---|---|---|
OPENWEBNINJA_API_KEY |
yes | Your OpenWeb Ninja API key (sent as x-api-key). |
OPENWEBNINJA_BASE_URL |
no | Override the API host (defaults to https://api.openwebninja.com). For staging/testing. |
Available tools (53)
安装
npx -y @openwebninja/mcp-server配置
{
"mcpServers": {
"openwebninja": {
"command": "npx",
"args": ["-y", "@openwebninja/mcp-server"],
"env": { "OPENWEBNINJA_API_KEY": "your-api-key" }
}
}
}