OpenWeb Ninja MCP

chính thức

Máy chủ MCP OpenWeb Ninja chính thức kết nối bất kỳ tác nhân AI nào với hơn 40 API dữ liệu web để tìm kiếm web, thương mại điện tử, doanh nghiệp địa phương, việc làm, bất động sản và dữ liệu tài chính.

GitHub
39

Bạn có thể làm gì với Open Web Ninja MCP?

  • Tìm kiếm web theo thời gian thực — yêu cầu kết quả web hiện tại, tin tức, diễn đàn, hình ảnh hoặc video bằng cách sử dụng realtime_web_search, real_time_news_search, realtime_forums_search và các công cụ liên quan.
  • Tìm doanh nghiệp địa phương và đánh giá — tra cứu thông tin chi tiết doanh nghiệp, dữ liệu Yelp, đánh giá Trustpilot hoặc nhận chỉ đường lái xe qua local_business_data, yelp_business_data, trustpilot_company_and_reviews và driving_directions.
  • Tìm kiếm việc làm và mức lương — truy vấn danh sách việc làm bằng jsearch hoặc lấy dữ liệu mức lương và đánh giá công ty từ job_salary_data và realtime_glassdoor_data.
  • Nghiên cứu sản phẩm và giá cả — lấy dữ liệu sản phẩm từ Amazon, Walmart, eBay, Costco hoặc Wayfair thông qua realtime_amazon_data, real_time_walmart_data, real_time_ebay_data và các công cụ tương tự.
  • Truy cập danh sách bất động sản — lấy dữ liệu bất động sản từ Zillow hoặc Redfin bằng cách sử dụng realtime_zillow_data và real_time_redfin_data.
  • Thêm API theo yêu cầu — sử dụng subscribe để kích hoạt gói miễn phí của bất kỳ API OpenWeb Ninja nào mà không cần rời khỏi cuộc trò chuyện.

Tài liệu

Máy chủ OpenWeb Ninja MCP

Máy chủ Model Context Protocol chính thức cho các API của OpenWeb Ninja. Cung cấp cho bất kỳ tác nhân AI tương thích MCP nào (Claude, Cursor, Cline, và các tác nhân khác) quyền truy cập thời gian thực vào tìm kiếm web, dữ liệu doanh nghiệp địa phương, việc làm, thương mại điện tử, bất động sản, tài chính, tin tức, và nhiều hơn nữa, thông qua một kết nối duy nhất.

Một công cụ cho mỗi sản phẩm API (41 công cụ), mỗi công cụ hiển thị các thao tác của API đó, cộng với một công cụ subscribe để thêm bậc miễn phí của API theo yêu cầu — tổng cộng 42 công cụ. Các lược đồ được tạo trực tiếp từ đặc tả OpenAPI của OpenWeb Ninja, vì vậy máy chủ luôn khớp với các API trực tiếp.

Thiết lập

Bạn cần một khóa API OpenWeb Ninja. Lấy khóa tại openwebninja.com.

Máy chủ chạy qua npx — không cần cài đặt toàn cục. Chọn máy khách của bạn bên dưới; npx tải @openwebninja/mcp-server theo yêu cầu.

Claude Desktop

Thêm vào claude_desktop_config.json (Cài đặt -> Nhà phát triển -> Chỉnh sửa Cấu hình):

{
  "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

Sử dụng cùng hình dạng command / args / env trong cấu hình MCP của máy khách (mcp.json hoặc tương đương).

Từ mã nguồn (phát triển cục bộ)

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

Sau đó trỏ máy khách MCP của bạn đến điểm vào đã xây dựng:

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

Cách các công cụ hoạt động

Mỗi công cụ ánh xạ đến một API OpenWeb Ninja và nhận hai đầu vào:

  • operation: điểm cuối nào để gọi (ví dụ: search, product_details)
  • args: các tham số cho thao tác đó

Mô tả công cụ liệt kê mọi thao tác và các tham số bắt buộc của nó. Ví dụ gọi đến công cụ jsearch:

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

Các đối số được xác thực và ép kiểu trước khi yêu cầu được gửi đi, và phản hồi trả về tải trọng data của OpenWeb Ninja cộng với một request_id.

Biến môi trường

BiếnBắt buộcMô tả
OPENWEBNINJA_API_KEYcóKhóa API OpenWeb Ninja của bạn (được gửi dưới dạng x-api-key).
OPENWEBNINJA_BASE_URLkhôngGhi đè máy chủ API (mặc định là https://api.openwebninja.com). Dành cho staging/thử nghiệm.

Công cụ có sẵn (42)

Tìm kiếm & khám phá: 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

Địa phương & bản đồ: local_business_data, yelp_business_data, trustpilot_company_and_reviews, local_rank_tracker, driving_directions, waze, ev_charge_finder

Việc làm & công ty: jsearch, job_salary_data, realtime_glassdoor_data

Thương mại & sản phẩm: 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

Bất động sản: realtime_zillow_data, real_time_redfin_data

Tài chính & sự kiện: realtime_finance_data, realtime_events_data

Liên hệ & làm giàu: website_contacts_scraper, email_search

Tiện ích: web_unblocker

Chuyển tiếp LLM: chatgpt, gemini, copilot

Truy cập: subscribe (thêm bậc miễn phí của API theo yêu cầu)

Phát triển

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

Quy trình là: Đặc tả OpenAPI (openapi-cache/) -> scripts/generate.ts -> src/generated/manifest.ts -> các công cụ được đăng ký khi chạy trong src/server.ts. Để thêm hoặc cập nhật một API, đồng bộ lại các đặc tả và tạo lại; không cần mã viết tay cho mỗi công cụ (chỉ các mô tả được tuyển chọn trong src/lib/descriptions.ts).