ON

openweb-ninja/openwebninja-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

38 stars 5 forks Качество 87 Тренд 32MIT

OpenWeb Ninja API MCP сервер

Обзор

Официальный сервер Model Context Protocol для OpenWeb Ninja API. Предоставляет любому MCP-совместимому агенту искусственного интеллекта (Клоду, Курсору, Клайну и другим) доступ в режиме реального времени к веб-поискам, местным бизнес-данным, рабочим местам, электронной коммерции, недвижимости, финансам, новостям и т. д. через одно соединение. Один инструмент на продукт API (41 инструмент), каждый из которых раскрывает операции API, плюс инструмент подписки для добавления бесплатного уровня API по требованию — всего 42 инструмента. Схемы генерируются непосредственно из спецификаций OpenAPI OpenWeb Ninja, поэтому сервер всегда соответствует API. Вам нужен OpenWeb Ninja API ключ. Получить один на openwebninja.com. Сервер работает через npx — в мире нечего устанавливать. Выберите клиента ниже; npx fetches @openwebninja/mcp-сервер по запросу. Добавить в claude desktop config.json (Настройки -> Разработчик -> Редактирование Config): Используйте ту же форму команды / args / env в конфигурации MCP клиента (mcp.json или эквивалент).

Обзор (машинный перевод)

Официальный сервер Model Context Protocol для OpenWeb Ninja API. Предоставляет любому MCP-совместимому агенту искусственного интеллекта (Клоду, Курсору, Клайну и другим) доступ в режиме реального времени к веб-поискам, местным бизнес-данным, рабочим местам, электронной коммерции, недвижимости, финансам, новостям и т. д. через одно соединение.

Один инструмент на продукт API (52 инструмента), каждый из которых раскрывает операции API, плюс инструмент для добавления бесплатного уровня API по требованию — всего 53 инструмента. Схемы генерируются непосредственно из спецификаций OpenAPI OpenWeb Ninja, поэтому сервер всегда соответствует API.

Настройка

Вам нужен OpenWeb Ninja API ключ. Получить один на openwebninja.com.

Сервер работает через npx — в мире нечего устанавливать. Выберите своего клиента ниже; npx берет @openwebninja/mcp-server по требованию.

###Клод Десктоп

Добавить в claude_desktop_config.json (Настройки -> Разработчик -> Редактирование Config):

###Клауд Код

Курсор / Клайн / Продолжить / Виндсерф

Используйте ту же форму command / args / env в конфигурации MCP клиента mcp.json или эквиваленте.

###От источника (локальное развитие)

Затем наведите MCP-клиент на встроенный вход:

##Как работают инструменты

Каждый инструмент отображается на одном API OpenWeb Ninja и принимает два входа:

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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)

Открыть полный README на GitHub

Установка

npx -y @openwebninja/mcp-server
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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