n8n

n8n 集成

在 n8n 工作流中使用全部 28 个 CrawlForge 网页抓取工具。通过 n8n 的 MCP Client 节点以 Streamable HTTP 原生连接，或在 HTTP Request 节点中调用 REST API——两条路径均经过端到端验证。

两种连接方式

n8n 可以通过两种协议与 CrawlForge 通信。根据你的 n8n 运行环境选择合适的一种。

MCP Client 节点

通过 Streamable HTTP 的原生 Model Context Protocol 连接。n8n 会自动发现全部 28 个工具，并将每个工具的参数渲染为表单字段。需要你自行托管一个 CrawlForge MCP 服务器端点（一条 npx 命令即可）。

原生 MCP

HTTP Request 节点

直接向 crawlforge.dev 发起 REST 调用——每个工具都是一个 POST 端点。无需托管任何服务，n8n Cloud 与自托管环境均可使用。

REST API

方式一：MCP Client 节点

n8n 内置了 MCP Client 节点（以及用于 AI Agent 工作流的 MCP Client Tool 子节点）。它使用 MCP 的 Streamable HTTP 传输——与 CrawlForge MCP 服务器在 HTTP 模式下暴露的传输方式相同。本指南已在 n8n 2.1.3 上完成端到端验证：该节点可以连接、列出全部 28 个工具并执行它们。

以 HTTP 模式启动 CrawlForge MCP 服务器

npm 包默认通过 stdio 运行；--http 标志会将其切换为 Streamable HTTP。你的 API 密钥身兼两职：既用于服务器向 CrawlForge 认证，也是 n8n 必须提供的 Bearer 令牌。

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

添加 MCP Client 节点并连接

Server Transport: HTTP Streamable（默认值）
MCP Endpoint URL: http://localhost:10000/mcp——当 n8n 在同一台机器的 Docker 中运行时，改用 http://host.docker.internal:10000/mcp
Authentication: Bearer Auth——创建一个凭据，其令牌就是启动服务器时使用的同一个 CrawlForge API 密钥

选择工具并执行

打开 Tool 下拉菜单——n8n 会连接到服务器并列出全部 28 个 CrawlForge 工具。选择其中一个（例如 fetch_url），在 Input Mode: Manual 下，n8n 会将该工具的参数渲染为表单字段。点击 Execute step 运行；工具结果会作为该节点的输出出现，可直接接入任意下游节点。

n8n 运行在 Docker 中？ 容器化的 n8n 无法访问宿主机上的 localhost。请改用 http://host.docker.internal:10000/mcp 作为端点 URL。

AI Agent 工作流： 同样的连接也适用于挂接在 AI Agent 节点上的 MCP Client Tool 子节点——你的智能体随后可以自主调用 CrawlForge 工具。使用 Tools to Include 限制智能体可调用 28 个工具中的哪些，让 credits 消耗保持可控。

方式二：HTTP Request 节点

每个 CrawlForge 工具同时也是位于 https://www.crawlforge.dev/api/v1/tools/<tool_name> 的 REST 端点。这种方式无需自建服务器，因此是 n8n Cloud（无法访问 localhost MCP 端点）的正确选择。添加一个 HTTP Request 节点并进行配置：

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

n8n 工作流自动化指南基于这一模式构建了一条完整的生产级流水线——可复用的凭据、定时价格监控、错误处理和 Slack 通知。工具参数与响应结构见 API 参考。

该选择哪种方式？

	MCP Client 节点	HTTP Request 节点
支持 n8n Cloud	仅当 MCP 服务器公开托管时	是
需要自行运行服务器	是——一条 `npx` 命令即可	否
工具发现	自动——节点中列出全部 28 个工具	手动——每个工具一个端点
参数输入	由工具的 schema 自动生成	手写 JSON 请求体
AI Agent 工具调用	是，通过 MCP Client Tool 子节点	否

公开托管 MCP 端点： 要在 n8n Cloud 中使用 MCP Client 节点，需要将服务器托管在公网 URL 上——crawlforge-mcp-server 仓库自带 Dockerfile 和 Render 蓝图，可将其以 HTTP 模式运行。

Credits 费用

两种连接方式都会按相同的每工具 credits 费用向你的 API 密钥计费——例如 fetch_url 为 1 credit，extract_content 为 2，search_web 为 5。完整表格见 API 参考；Free 套餐一次性提供的 1,000 credits 足够用于构建和测试工作流。

故障排除

症状	解决方法
MCP Client 节点返回 401 Unauthorized	Bearer 凭据必须与启动服务器时使用的 `CRAWLFORGE_API_KEY` 完全一致——二者按字符串比较。
Connection refused / 无法连接	服务器未以 HTTP 模式运行，或者 n8n 运行在 Docker 中而端点写的是 `localhost`——请改用 `host.docker.internal`。
Tool 下拉菜单一直为空	检查 Server Transport 是否为 HTTP Streamable，且端点路径以 `/mcp` 结尾。通过 `curl http://localhost:10000/health` 确认服务器状态正常。
执行工具时返回 402 Payment Required	该 API 密钥对应的账户 credits 已用完——请在控制台查看用量。

开始用 n8n 实现自动化

免费注册即可获得 1,000 credits——无需信用卡。然后按照工作流指南构建你的第一条抓取流水线。

获取免费 API 密钥 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" }

MCP Client 节点

HTTP Request 节点

支持 n8n Cloud

仅当 MCP 服务器公开托管时

是

需要自行运行服务器

是——一条 npx 命令即可

否

工具发现

自动——节点中列出全部 28 个工具

手动——每个工具一个端点

参数输入

由工具的 schema 自动生成

手写 JSON 请求体

AI Agent 工具调用

是，通过 MCP Client Tool 子节点

否

症状

解决方法

MCP Client 节点返回 401 Unauthorized

Bearer 凭据必须与启动服务器时使用的 CRAWLFORGE_API_KEY 完全一致——二者按字符串比较。

Connection refused / 无法连接

服务器未以 HTTP 模式运行，或者 n8n 运行在 Docker 中而端点写的是 localhost——请改用 host.docker.internal。

Tool 下拉菜单一直为空

检查 Server Transport 是否为 *HTTP Streamable*，且端点路径以 /mcp 结尾。通过 curl http://localhost:10000/health 确认服务器状态正常。

执行工具时返回 402 Payment Required

该 API 密钥对应的账户 credits 已用完——请在控制台查看用量。