
openweb-ninja/openwebninja-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
OpenWeb Ninja API MCP サーバー
概要
OpenWeb Ninja API 用の公式モデルコンテキストプロトコルサーバー。 MCP 互換 AI エージェント (Claude, Cursor, Cline など) ウェブ検索、ローカルビジネスデータ、ジョブ、e コマース、不動産、金融、ニュースなど、単一の接続を介してリアルタイムでアクセスします。 API 製品の 1 つのツール (41 ツール), 各 API の操作を説明します。, API の無料ティアを追加するためのサブスクリプション ツール — 42 ツールの合計. スキーマはOpenWeb NinjaのOpenAPI仕様から直接生成されるため、サーバーは常にライブAPIにマッチします。 OpenWeb Ninja API キーが必要です。 openwebninja.comで入手してください。 サーバは npx で実行されます。グローバルにインストールするのは何もありません。 以下のクライアントを選択します。 npx は @openwebninja/mcp-server をオンデマンドで取得します。 claude desktop config.json に追加 (設定 -> 開発者 -> 編集 Config): クライアントの MCP 設定 (mcp.json または同等) で同じコマンド/ args/ env 形状を使用します.
概要(AI 翻訳)
OpenWeb Ninja API 用の公式モデルコンテキストプロトコルサーバー。 MCP 互換 AI エージェント (Claude, Cursor, Cline など) ウェブ検索、ローカルビジネスデータ、ジョブ、e コマース、不動産、金融、ニュースなど、単一の接続を介してリアルタイムでアクセスします。
API製品(52ツール)ごとの1つのツールで、APIの操作と、APIの無料ティアを追加するための[[subscribe]ツールをそれぞれ説明しています。 スキーマはOpenWeb NinjaのOpenAPI仕様から直接生成されるため、サーバーは常にライブAPIにマッチします。
セットアップ
OpenWeb Ninja API キーが必要です。 openwebninja.comで入手してください。
サーバは[npx]を経由して実行します。 下のクライアントを選択します。 [npx] は @openwebninja/mcp-server] を要求します。
##Claudeデスクトップ
[claude_desktop_config.jsonに追加] (設定 -> 開発者 -> 編集 Config):
##Claudeコード
カーソル/クライン/続行/ウィンドサーフィン
クライアントの MCP 設定 ([mcp.json) の [args] / [[env] と同じ形状を使用します。
ソースから (ローカル開発)
ビルドされたエントリで MCP クライアントを指す:
ツールの仕組み
各ツールは1つのOpenWeb Ninja APIにマップし、2つの入力を取ります
このページは 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" }
}
}
}