OpenWeb Ninja MCP

OpenWeb Ninja MCP Server

เซิร์ฟเวอร์ Model Context Protocol อย่างเป็นทางการสำหรับ API ของ OpenWeb Ninja มอบการเข้าถึงแบบเรียลไทม์ให้กับเอเจนต์ AI ที่เข้ากันได้กับ 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) สำหรับการจัดเตรียม/ทดสอบ

เครื่องมือที่พร้อมใช้งาน (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)