n8n

Penyepaduan n8n

Gunakan kesemua 28 alat web scraping CrawlForge di dalam aliran kerja n8n. Sambung secara asli melalui nod MCP Client n8n atas Streamable HTTP, atau panggil REST API daripada nod HTTP Request — kedua-dua laluan telah disahkan hujung ke hujung.

Dua Cara untuk Menyambung

n8n boleh berkomunikasi dengan CrawlForge melalui dua protokol. Pilih yang sepadan dengan tempat n8n anda berjalan.

Nod MCP Client

Sambungan Model Context Protocol asli melalui Streamable HTTP. n8n menemui kesemua 28 alat secara automatik dan memaparkan parameter setiap alat sebagai medan borang. Memerlukan endpoint pelayan CrawlForge MCP yang anda hoskan sendiri (satu arahan npx).

MCP Asli

Nod HTTP Request

Panggilan REST biasa ke crawlforge.dev — setiap alat ialah endpoint POST. Tiada apa-apa yang perlu dihoskan, berfungsi pada n8n Cloud mahupun pemasangan hos sendiri.

REST API

Pilihan 1: Nod MCP Client

n8n dilengkapi nod MCP Client terbina dalam (serta sub-nod MCP Client Tool untuk aliran kerja AI Agent). Ia berkomunikasi melalui transport Streamable HTTP MCP — transport yang sama yang didedahkan oleh pelayan CrawlForge MCP dalam mod HTTP. Panduan ini disahkan hujung ke hujung pada n8n 2.1.3: nod ini menyambung, menyenaraikan kesemua 28 alat, dan melaksanakannya.

Mulakan pelayan CrawlForge MCP dalam mod HTTP

Pakej npm berjalan melalui stdio secara lalai; bendera --http menukarnya kepada Streamable HTTP. API key anda memainkan dua peranan: ia mengesahkan pelayan kepada CrawlForge, dan ia juga token Bearer yang mesti dikemukakan oleh n8n.

Bash

CRAWLFORGE_API_KEY=cf_live_your_api_key_here \
npx crawlforge-mcp-server --http

# MCP endpoint:  http://localhost:10000/mcp
# Health check:  http://localhost:10000/health
# Set PORT to listen somewhere other than 10000

Tambah nod MCP Client dan sambungkan

Server Transport: HTTP Streamable (tetapan lalai)
MCP Endpoint URL: http://localhost:10000/mcp — atau http://host.docker.internal:10000/mcp apabila n8n berjalan dalam Docker pada mesin yang sama
Authentication: Bearer Auth — cipta kelayakan yang tokennya ialah API key CrawlForge yang sama yang digunakan untuk memulakan pelayan

Pilih alat dan laksanakan

Buka menu lungsur Tool — n8n menyambung ke pelayan dan menyenaraikan kesemua 28 alat CrawlForge. Pilih satu (cth. fetch_url), dan dengan Input Mode: Manual n8n memaparkan parameter alat itu sebagai medan borang. Klik Execute step untuk menjalankannya; hasil alat muncul sebagai output nod, sedia untuk disambungkan ke mana-mana nod hiliran.

n8n dalam Docker? n8n yang berjalan dalam kontena tidak dapat mencapai localhost pada mesin hos anda. Gunakan http://host.docker.internal:10000/mcp sebagai URL endpoint.

Aliran kerja AI Agent: Sambungan yang sama berfungsi daripada sub-nod MCP Client Tool yang dilampirkan pada nod AI Agent — ejen anda kemudiannya memanggil alat CrawlForge secara autonomi. Gunakan Tools to Include untuk mengehadkan alat yang boleh dipanggil oleh ejen daripada 28 alat tersebut dan memastikan perbelanjaan credit kekal boleh diramal.

Pilihan 2: Nod HTTP Request

Setiap alat CrawlForge juga merupakan endpoint REST di https://www.crawlforge.dev/api/v1/tools/<tool_name>. Ini tidak memerlukan pelayan anda sendiri, jadi ia pilihan yang tepat untuk n8n Cloud (yang tidak dapat mencapai endpoint MCP localhost). Tambah nod HTTP Request dan konfigurasikannya:

HTTP Request nodeJson

// Method: POST
// URL: https://www.crawlforge.dev/api/v1/tools/extract_content

// Headers
{
  "X-API-Key": "cf_live_your_api_key_here",
  "Content-Type": "application/json"
}

// Body (JSON)
{
  "url": "https://example.com/article"
}

Panduan automasi aliran kerja n8n membina saluran paip pengeluaran yang lengkap berdasarkan corak ini — kelayakan boleh guna semula, pemantau harga berjadual, pengendalian ralat, dan pemberitahuan Slack. Parameter alat dan bentuk respons terdapat dalam rujukan API.

Pilihan mana yang patut anda gunakan?

	Nod MCP Client	Nod HTTP Request
Berfungsi pada n8n Cloud	Hanya dengan pelayan MCP yang dihoskan secara awam	Ya
Menjalankan pelayan anda sendiri	Ya — satu arahan `npx`	Tidak
Penemuan alat	Automatik — kesemua 28 alat disenaraikan dalam nod	Manual — satu endpoint bagi setiap alat
Input parameter	Dijana daripada skema alat	Badan JSON yang ditulis tangan
Penggunaan alat AI Agent	Ya, melalui sub-nod MCP Client Tool	Tidak

Menghoskan endpoint MCP secara awam: Untuk menggunakan nod MCP Client daripada n8n Cloud, hoskan pelayan pada URL awam — repo crawlforge-mcp-server menyediakan Dockerfile dan blueprint Render yang menjalankannya dalam mod HTTP.

Kos Credit

Kedua-dua kaedah sambungan mengenakan kos credit per alat yang sama terhadap API key anda — contohnya fetch_url ialah 1 credit, extract_content ialah 2, dan search_web ialah 5. Jadual penuh terdapat dalam rujukan API; 1,000 credits sekali sahaja daripada pelan Free sudah cukup untuk membina dan menguji aliran kerja.

Penyelesaian Masalah

Gejala	Penyelesaian
401 Unauthorized daripada nod MCP Client	Kelayakan Bearer mesti sepadan sepenuhnya dengan `CRAWLFORGE_API_KEY` yang digunakan untuk memulakan pelayan — kedua-duanya dibandingkan sebagai rentetan.
Connection refused / tidak dapat menyambung	Pelayan tidak berjalan dalam mod HTTP, atau n8n berjalan dalam Docker dan endpoint menyebut `localhost` — gunakan `host.docker.internal`.
Menu lungsur alat kekal kosong	Pastikan Server Transport ialah HTTP Streamable dan laluan endpoint berakhir dengan `/mcp`. Sahkan pelayan berfungsi dengan baik: `curl http://localhost:10000/health`.
402 Payment Required semasa pelaksanaan alat	Akaun di sebalik API key itu telah kehabisan credits — semak penggunaan pada dashboard.

Mula Mengautomasikan dengan n8n

Daftar percuma dan dapatkan 1,000 credits — tiada kad kredit diperlukan. Kemudian ikuti panduan aliran kerja untuk membina saluran paip scraping pertama anda.

Dapatkan API Key Percuma Anda Panduan Aliran Kerja n8n

CRAWLFORGE_API_KEY=cf_live_your_api_key_here \ npx crawlforge-mcp-server --http # MCP endpoint: http://localhost:10000/mcp # Health check: http://localhost:10000/health # Set PORT to listen somewhere other than 10000

// Method: POST // URL: https://www.crawlforge.dev/api/v1/tools/extract_content // Headers { "X-API-Key": "cf_live_your_api_key_here", "Content-Type": "application/json" } // Body (JSON) { "url": "https://example.com/article" }

Nod MCP Client

Nod HTTP Request

Berfungsi pada n8n Cloud

Hanya dengan pelayan MCP yang dihoskan secara awam

Menjalankan pelayan anda sendiri

Ya — satu arahan npx

Tidak

Penemuan alat

Automatik — kesemua 28 alat disenaraikan dalam nod

Manual — satu endpoint bagi setiap alat

Input parameter

Dijana daripada skema alat

Badan JSON yang ditulis tangan

Penggunaan alat AI Agent

Ya, melalui sub-nod MCP Client Tool

Tidak

Gejala

Penyelesaian

401 Unauthorized daripada nod MCP Client

Kelayakan Bearer mesti sepadan sepenuhnya dengan CRAWLFORGE_API_KEY yang digunakan untuk memulakan pelayan — kedua-duanya dibandingkan sebagai rentetan.

Connection refused / tidak dapat menyambung

Pelayan tidak berjalan dalam mod HTTP, atau n8n berjalan dalam Docker dan endpoint menyebut localhost — gunakan host.docker.internal.

Menu lungsur alat kekal kosong

Pastikan Server Transport ialah *HTTP Streamable* dan laluan endpoint berakhir dengan /mcp. Sahkan pelayan berfungsi dengan baik: curl http://localhost:10000/health.

402 Payment Required semasa pelaksanaan alat

Akaun di sebalik API key itu telah kehabisan credits — semak penggunaan pada dashboard.