OpenWeb Ninja MCP

OpenWeb Ninja MCP सर्वर

OpenWeb Ninja API के लिए आधिकारिक मॉडल कॉन्टेक्स्ट प्रोटोकॉल सर्वर। किसी भी MCP-संगत AI एजेंट (Claude, Cursor, Cline, और अन्य) को एक ही कनेक्शन के माध्यम से वेब खोज, स्थानीय व्यापार डेटा, नौकरियां, ई-कॉमर्स, रियल एस्टेट, वित्त, समाचार, और बहुत कुछ तक रीयल-टाइम पहुंच प्रदान करता है।

प्रति API उत्पाद एक उपकरण (41 उपकरण), प्रत्येक उस API के संचालन को उजागर करता है, साथ ही मांग पर API का निःशुल्क स्तर जोड़ने के लिए एक subscribe उपकरण — कुल 42 उपकरण। स्कीमा सीधे OpenWeb Ninja के OpenAPI विनिर्देशों से उत्पन्न होते हैं, इसलिए सर्वर हमेशा लाइव API से मेल खाता है।

सेटअप

आपको एक OpenWeb Ninja API कुंजी की आवश्यकता है। openwebninja.com पर प्राप्त करें।

सर्वर npx के माध्यम से चलता है — विश्व स्तर पर स्थापित करने के लिए कुछ भी नहीं है। नीचे अपना क्लाइंट चुनें; npx मांग पर @openwebninja/mcp-server प्राप्त करता है।

Claude Desktop

claude_desktop_config.json में जोड़ें (सेटिंग्स -> डेवलपर -> कॉन्फ़िग संपादित करें):

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

क्लाइंट के MCP कॉन्फ़िग (mcp.json या समकक्ष) में समान command / args / env आकार का उपयोग करें।

स्रोत से (स्थानीय विकास)

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

उपकरण कैसे काम करते हैं

प्रत्येक उपकरण एक OpenWeb Ninja API से मैप करता है और दो इनपुट लेता है:

• operation: किस एंडपॉइंट को कॉल करना है (जैसे search, product_details)
• args: उस संचालन के लिए पैरामीटर

उपकरण विवरण प्रत्येक संचालन और उसके आवश्यक पैरामीटर को सूचीबद्ध करता है। jsearch उपकरण के लिए उदाहरण कॉल:

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

अनुरोध भेजे जाने से पहले तर्कों को मान्य और प्रकार-सही किया जाता है, और प्रतिक्रियाएं OpenWeb Ninja data पेलोड और एक request_id लौटाती हैं।

पर्यावरण चर

चर	आवश्यक	विवरण
OPENWEBNINJA_API_KEY	हाँ	आपकी OpenWeb Ninja API कुंजी (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 में क्यूरेटेड विवरण)।