OpenWeb Ninja MCP

OpenWeb Ninja MCP Server

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

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

Настройка

Вам понадобится API-ключ OpenWeb Ninja. Получите его на openwebninja.com.

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

Claude Desktop

Добавьте в 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

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

Из исходного кода (локальная разработка)

git clone <repo> && cd openwebninja-mcp
npm install
npm run build

Затем укажите вашему MCP-клиенту путь к собранной точке входа:

{
  "mcpServers": {
    "openwebninja": {
      "command": "node",
      "args": ["/absolute/path/to/openwebninja-mcp/dist/index.js"],
      "env": { "OPENWEBNINJA_API_KEY": "your-api-key" }
    }
  }
}

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

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

• operation: какую конечную точку вызвать (например, search, product_details)
• args: параметры для этой операции

Описание инструмента перечисляет все операции и их обязательные параметры. Пример вызова инструмента jsearch:

{
  "operation": "search",
  "args": { "query": "site reliability engineer remote", "country": "us" }
}

Аргументы проверяются и приводятся к нужным типам перед отправкой запроса, а ответы возвращают полезную нагрузку data OpenWeb Ninja плюс request_id.

Переменные окружения

Переменная	Обязательна	Описание
OPENWEBNINJA_API_KEY	да	Ваш API-ключ OpenWeb Ninja (отправляется как x-api-key).
OPENWEBNINJA_BASE_URL	нет	Переопределить хост API (по умолчанию https://api.openwebninja.com). Для staging/тестирования.

Доступные инструменты (42)

Поиск и обнаружение: realtime_web_search, realtime_news_data, real_time_news_search, realtime_forums_search, web_search_autocomplete, realtime_image_search, reverse_image_search, realtime_lens_data, real_time_video_search, realtime_shorts_search, ai_overviews, google_ai_mode, social_links_search

Локальные данные и карты: local_business_data, yelp_business_data, trustpilot_company_and_reviews, local_rank_tracker, driving_directions, waze, ev_charge_finder

Вакансии и компании: jsearch, job_salary_data, realtime_glassdoor_data

Коммерция и товары: realtime_amazon_data, realtime_product_search, real_time_walmart_data, real_time_ebay_data, realtime_costco_data, real_time_wayfair_data, realtime_books_data, play_store_apps

Недвижимость: realtime_zillow_data, real_time_redfin_data

Финансы и события: realtime_finance_data, realtime_events_data

Контакты и обогащение данных: website_contacts_scraper, email_search

Утилиты: web_unblocker

LLM-ретрансляторы: chatgpt, gemini, copilot

Доступ: subscribe (добавить бесплатный уровень API по запросу)

Разработка

npm run sync       # sync OpenAPI specs from S3 into openapi-cache/ (needs AWS creds)
npm run generate   # regenerate src/generated/manifest.ts from the specs
npm run build      # compile TypeScript to dist/
npm run dev        # run the server over stdio (tsx, no build)
npm run inspect    # launch the MCP Inspector against the server
npx tsx test/smoke.ts   # smoke test: list tools + validation + request path

Пайплайн: спецификации OpenAPI (openapi-cache/) -> scripts/generate.ts -> src/generated/manifest.ts -> инструменты регистрируются во время выполнения в src/server.ts. Чтобы добавить или обновить API, повторно синхронизируйте спецификации и перегенерируйте; ручное написание кода для каждого инструмента не требуется (только курируемые описания в src/lib/descriptions.ts).