
openweb-ninja/openwebninja-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
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)
Установка
npx -y @openwebninja/mcp-serverКонфигурация
{
"mcpServers": {
"openwebninja": {
"command": "npx",
"args": ["-y", "@openwebninja/mcp-server"],
"env": { "OPENWEBNINJA_API_KEY": "your-api-key" }
}
}
}