Panduan integrasi

Agent n8n yang bisa googling

Oleh Khairul Muhtadin, n8n Ambassador

Biar AI Agent di n8n bisa googling, sambungkan ke 1ToolRing pakai node MCP Client Tool: isi Endpoint dengan https://mcp.1toolring.com/mcp, pilih Server Transport HTTP Streamable, dan Authentication Bearer Auth dengan API key 1ToolRing. Agen kamu langsung dapat empat tool (discover_tools, inspect_tool, run_tool, get_tool_run) untuk ambil hasil Google live, volume keyword, tempat di Google Maps, produk Amazon dan kurs. Bayarnya per call dari saldo rupiah, top up mulai Rp10.000. Kalau workflow-nya gak butuh agen, panggil REST API-nya langsung dari node HTTP Request.

Pasang node MCP Client Tool

  1. Bikin API key di halaman Keys di konsol 1ToolRing. Key cuma ditampilkan sekali, jadi langsung salin.
  2. Tambahkan node AI Agent beserta chat model-nya, lalu sambungkan node MCP Client Tool ke konektor Tool.
  3. Di node MCP Client Tool, isi Endpoint dengan URL server:
    https://mcp.1toolring.com/mcp
  4. Pilih Server Transport: HTTP Streamable.
  5. Pilih Authentication: Bearer Auth, bikin credential baru, lalu tempel API key kamu sebagai token.
  6. Biarkan Tools to Include di All. Server-nya memang cuma punya empat tool.
  7. Buka chat, kirim prompt pertama di bawah, dan lihat agen memanggil discover_tools, inspect_tool lalu run_tool.

Tanpa agen: pakai node HTTP Request

Kalau workflow kamu selalu menjalankan tool yang sama (misalnya cek ranking harian untuk daftar keyword), gak perlu agen. Panggil REST API di https://api.1toolring.com langsung. Cari dulu id tool-nya sekali, lewat discover_tools di chat atau pakai call ini:

curl -X POST https://api.1toolring.com/api/v1/tools/discover \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"google search results for a keyword","limit":3}'

Setting node HTTP Request

Method POST, URL https://api.1toolring.com/api/v1/tools/run. Di Authentication pilih Generic Credential Type, lalu Bearer Auth, dengan API key yang sama. Body-nya JSON seperti ini, dengan {{ $json.keyword }} diambil dari node sebelumnya:

{
  "tool": "dataforseo/serp/google-organic",
  "input": {
    "body": {
      "keyword": "{{ $json.keyword }}",
      "language_code": "id"
    }
  }
}

Run yang lama dan biayanya

Kalau selesai tepat waktu, jawabannya 200 dengan hasil di data.output dan biaya di data.cost ({"usd", "idr"}). Tool yang lambat menjawab 202 dengan run_id: tambahkan node Wait, lalu GET ke URL di bawah (gratis) sampai status jadi completed atau failed.

Header X-ToolRing-Cost-IDR berisi biaya pasti dalam rupiah kalau kamu mau mencatatnya. Contoh harga: hasil organik Google Rp48 per call, kurs Rp5 per call.

https://api.1toolring.com/api/v1/tools/runs/{{ $json.data.run_id }}

Prompt pertama yang bisa dicoba

Kirim ini di chat AI Agent. Agen seharusnya cari tool dulu, kasih tahu harganya, baru menjalankannya.

Pakai 1toolring untuk ambil hasil Google teratas buat "kopi susu gula aren" di Indonesia. Sebutkan dulu tool yang mau kamu pakai dan harganya sebelum dijalankan, lalu tampilkan 10 URL teratas beserta peringkatnya.

Berapa biaya tiap call

Beberapa tool yang kemungkinan dipilih agen kamu. Cari dan cek tool itu gratis; yang ditagih cuma run yang berhasil. Cara kerja harga.

Harga per 5 Nov 2026; harga live selalu ditampilkan sebelum run.
KebutuhanId toolHargaDitagih
Hasil organik Google live, fitur SERP sudah diuraidataforseo/serp/google-organic$0.0026 (Rp48)per call (satu halaman, 10 hasil)
Pencarian Google, semua elemen halaman hasil dalam JSONserpapi/google/search$0.0195 (Rp354)per pencarian yang berhasil
Volume pencarian Google Ads, CPC dan kompetisidataforseo/keywords/google-ads-search-volume$0.117 (Rp2.122)per call (sampai 1.000 keyword)
Tempat di Google Maps, atau detail satu tempatserpapi/google/maps$0.0195 (Rp354)per pencarian yang berhasil
Pencarian Amazon lengkap dengan harga, rating dan badgedataforseo/amazon/products$0.0043 (Rp78)per call (satu halaman, 48 hasil)
Kurs harian dari satu mata uang dasar1toolring/fx/latest$0.0003 (Rp5)per call

Kalau ada masalah

Node-nya cuma ada kolom SSE Endpoint, atau transport-nya Server Sent Events
Itu versi lama node MCP Client Tool. 1ToolRing pakai Streamable HTTP, jadi tambahkan node MCP Client Tool yang baru (atau update n8n) dan pilih HTTP Streamable.
Muncul "Authentication required" atau 401
Call-nya sampai tanpa key yang valid. Pastikan Authentication di Bearer Auth dan credential-nya berisi key lengkap. Server MCP cuma menerima key lewat Authorization: Bearer.
Run menjawab 400 VALIDATION_ERROR
Body-nya gak cocok dengan input tool. Baca input_schema-nya lewat inspect, lalu kirim bagian yang dideklarasikan saja (body, queryParams atau pathParams).
Tools menjawab 403 EARLY_ACCESS_PENDING
1ToolRing masih akses awal, dan akun baru disetujui bertahap. Kamu tetap bisa masuk sebelum disetujui, tapi tools, key dan top up terkunci sampai email persetujuan datang. Call seperti ini gak ditagih.
Run gagal dengan 402 INSUFFICIENT_BALANCE
Saldo kamu gak cukup untuk harga call itu. Error-nya sudah berisi saldo kamu, jumlah yang dibutuhkan, dan link top up. Top up berapa pun di halaman Billing: mulai Rp10.000 lewat virtual account bank atau Alfamart/Indomaret, atau mulai $1 pakai kartu. Call yang ditolak gak ditagih.
Tool menjawab 403 TOOL_BLOCKED
Tool itu memang gak tersedia di 1ToolRing, dan gak ada yang ditagih. Data orang atau kontak, pencarian email, data media sosial dan web scraping gak ada di katalog. Minta agen kamu cari tool lain lewat discover_tools.

Pertanyaan

Harus punya akun di tiap penyedia data?
Gak perlu. Cukup satu key 1ToolRing dan satu saldo prabayar, gak ada akun lain yang perlu dibuat.
Bisa bayar tanpa kartu kredit?
Bisa. Top up dalam rupiah lewat virtual account bank atau tunai di Alfamart/Indomaret, mulai Rp10.000. Gak ada langganan.

Lihat juga

Halaman tool

Panduan lain

Langkah dicek dengan n8n docs: MCP Client Tool node (dicek 2026-11-05).