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
- Bikin API key di halaman Keys di konsol 1ToolRing. Key cuma ditampilkan sekali, jadi langsung salin.
- Tambahkan node AI Agent beserta chat model-nya, lalu sambungkan node MCP Client Tool ke konektor Tool.
- Di node MCP Client Tool, isi Endpoint dengan URL server:
https://mcp.1toolring.com/mcp - Pilih Server Transport: HTTP Streamable.
- Pilih Authentication: Bearer Auth, bikin credential baru, lalu tempel API key kamu sebagai token.
- Biarkan Tools to Include di All. Server-nya memang cuma punya empat tool.
- 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.
| Kebutuhan | Id tool | Harga | Ditagih |
|---|---|---|---|
| Hasil organik Google live, fitur SERP sudah diurai | dataforseo/serp/google-organic | $0.0026 (Rp48) | per call (satu halaman, 10 hasil) |
| Pencarian Google, semua elemen halaman hasil dalam JSON | serpapi/google/search | $0.0195 (Rp354) | per pencarian yang berhasil |
| Volume pencarian Google Ads, CPC dan kompetisi | dataforseo/keywords/google-ads-search-volume | $0.117 (Rp2.122) | per call (sampai 1.000 keyword) |
| Tempat di Google Maps, atau detail satu tempat | serpapi/google/maps | $0.0195 (Rp354) | per pencarian yang berhasil |
| Pencarian Amazon lengkap dengan harga, rating dan badge | dataforseo/amazon/products | $0.0043 (Rp78) | per call (satu halaman, 48 hasil) |
| Kurs harian dari satu mata uang dasar | 1toolring/fx/latest | $0.0003 (Rp5) | per call |
Kalau ada masalah
Node-nya cuma ada kolom SSE Endpoint, atau transport-nya Server Sent Events
Muncul "Authentication required" atau 401
Authorization: Bearer.Run menjawab 400 VALIDATION_ERROR
input_schema-nya lewat inspect, lalu kirim bagian yang dideklarasikan saja (body, queryParams atau pathParams).Tools menjawab 403 EARLY_ACCESS_PENDING
Run gagal dengan 402 INSUFFICIENT_BALANCE
Tool menjawab 403 TOOL_BLOCKED
discover_tools.Pertanyaan
Harus punya akun di tiap penyedia data?
Bisa bayar tanpa kartu kredit?
Lihat juga
Halaman tool
Panduan lain
- Cara kasih Claude Code akses Google Search (bayar pakai rupiah)
- Semua panduan (bahasa Inggris)
- Semua klien di halaman instalasi (bahasa Inggris)
Langkah dicek dengan n8n docs: MCP Client Tool node (dicek 2026-11-05).