OpenWeb Ninja MCP

Server OpenWeb Ninja MCP

Server resmi Model Context Protocol untuk API OpenWeb Ninja. Memberikan akses waktu nyata kepada agen AI yang kompatibel dengan MCP (Claude, Cursor, Cline, dan lainnya) ke pencarian web, data bisnis lokal, lowongan kerja, e-commerce, real estat, keuangan, berita, dan lainnya, melalui satu koneksi.

Satu alat per produk API (41 alat), masing-masing mengekspos operasi API tersebut, ditambah alat subscribe untuk menambahkan tingkat gratis API sesuai permintaan — total 42 alat. Skema dihasilkan langsung dari spesifikasi OpenAPI OpenWeb Ninja, sehingga server selalu cocok dengan API langsung.

Penyiapan

Anda memerlukan kunci API OpenWeb Ninja. Dapatkan di openwebninja.com.

Server berjalan melalui npx — tidak ada yang perlu diinstal secara global. Pilih klien Anda di bawah; npx mengambil @openwebninja/mcp-server sesuai permintaan.

Claude Desktop

Tambahkan ke claude_desktop_config.json (Pengaturan -> Pengembang -> Edit Konfigurasi):

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

Gunakan bentuk command / args / env yang sama di konfigurasi MCP klien (mcp.json atau yang setara).

Dari sumber (pengembangan lokal)

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

Kemudian arahkan klien MCP Anda ke entri yang dibangun:

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

Cara kerja alat

Setiap alat dipetakan ke satu API OpenWeb Ninja dan menerima dua masukan:

• operation: titik akhir mana yang akan dipanggil (mis. search, product_details)
• args: parameter untuk operasi tersebut

Deskripsi alat mencantumkan setiap operasi dan parameter yang diperlukan. Contoh panggilan ke alat jsearch:

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

Argumen divalidasi dan dipaksakan jenisnya sebelum permintaan dikirim, dan respons mengembalikan muatan data OpenWeb Ninja ditambah request_id.

Variabel lingkungan

Variabel	Diperlukan	Deskripsi
OPENWEBNINJA_API_KEY	ya	Kunci API OpenWeb Ninja Anda (dikirim sebagai x-api-key).
OPENWEBNINJA_BASE_URL	tidak	Timpa host API (bawaan ke https://api.openwebninja.com). Untuk staging/pengujian.

Alat yang tersedia (42)

Pencarian & penemuan: 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

Lokal & peta: local_business_data, yelp_business_data, trustpilot_company_and_reviews, local_rank_tracker, driving_directions, waze, ev_charge_finder

Lowongan & perusahaan: jsearch, job_salary_data, realtime_glassdoor_data

Perdagangan & produk: 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

Real estat: realtime_zillow_data, real_time_redfin_data

Keuangan & acara: realtime_finance_data, realtime_events_data

Kontak & pengayaan: website_contacts_scraper, email_search

Utilitas: web_unblocker

Relai LLM: chatgpt, gemini, copilot

Akses: subscribe (tambahkan tingkat gratis API sesuai permintaan)

Pengembangan

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

Alurnya adalah: spesifikasi OpenAPI (openapi-cache/) -> scripts/generate.ts -> src/generated/manifest.ts -> alat didaftarkan saat runtime di src/server.ts. Untuk menambah atau memperbarui API, sinkronkan ulang spesifikasi dan hasilkan ulang; tidak diperlukan kode per alat yang ditulis tangan (hanya deskripsi yang dikurasi di src/lib/descriptions.ts).