ON

openweb-ninja/openwebninja-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

38 stars 5 forks 品質 87 トレンド 32MIT

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)

GitHub で README 全文を見る

インストール

npx -y @openwebninja/mcp-server
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "openwebninja": { "command": "npx", "args": ["-y", "@openwebninja/mcp-server"], "env": { "OPENWEBNINJA_API_KEY": "your-api-key" } } } }