n8n

Integración con n8n

Use las 28 herramientas de web scraping de CrawlForge dentro de flujos de trabajo de n8n. Conéctese de forma nativa mediante el nodo MCP Client de n8n sobre Streamable HTTP, o llame a la REST API desde el nodo HTTP Request — ambas vías están verificadas de extremo a extremo.

Dos formas de conectarse

n8n puede comunicarse con CrawlForge mediante dos protocolos. Elija el que corresponda a dónde se ejecuta su n8n.

Nodo MCP Client

Conexión nativa por Model Context Protocol sobre Streamable HTTP. n8n descubre las 28 herramientas automáticamente y muestra los parámetros de cada herramienta como campos de formulario. Requiere un endpoint del servidor MCP de CrawlForge alojado por usted (un solo comando npx).

MCP nativo

Nodo HTTP Request

Llamadas REST simples a crawlforge.dev — cada herramienta es un endpoint POST. No hay nada que alojar; funciona tanto en n8n Cloud como en instalaciones autoalojadas.

REST API

Opción 1: nodo MCP Client

n8n incluye un nodo MCP Client integrado (más un subnodo MCP Client Tool para flujos de trabajo con AI Agent). Habla el transporte Streamable HTTP de MCP — el mismo transporte que el servidor MCP de CrawlForge expone en modo HTTP. Esta guía se verificó de extremo a extremo en n8n 2.1.3: el nodo se conecta, lista las 28 herramientas y las ejecuta.

Inicie el servidor MCP de CrawlForge en modo HTTP

El paquete npm se ejecuta sobre stdio de forma predeterminada; el flag --http lo cambia a Streamable HTTP. Su API key cumple una doble función: autentica el servidor ante CrawlForge y es el token Bearer que n8n debe presentar.

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

Añada el nodo MCP Client y conéctese

Server Transport: HTTP Streamable (el valor predeterminado)
MCP Endpoint URL: http://localhost:10000/mcp — o http://host.docker.internal:10000/mcp cuando n8n se ejecuta en Docker en la misma máquina
Authentication: Bearer Auth — cree una credencial cuyo token sea la misma API key de CrawlForge con la que se inició el servidor

Elija una herramienta y ejecútela

Abra el menú desplegable Tool — n8n se conecta al servidor y lista las 28 herramientas de CrawlForge. Seleccione una (p. ej. fetch_url) y, con Input Mode: Manual, n8n muestra los parámetros de la herramienta como campos de formulario. Haga clic en Execute step para ejecutarla; el resultado de la herramienta aparece como la salida del nodo, listo para conectarse a cualquier nodo posterior.

¿n8n en Docker? Un n8n en contenedor no puede alcanzar localhost en su máquina anfitriona. Use http://host.docker.internal:10000/mcp como URL del endpoint en su lugar.

Flujos de trabajo con AI Agent: La misma conexión funciona desde el subnodo MCP Client Tool adjunto a un nodo AI Agent — su agente entonces llama a las herramientas de CrawlForge de forma autónoma. Use Tools to Include para limitar cuáles de las 28 herramientas puede llamar el agente y mantener el gasto de credits predecible.

Opción 2: nodo HTTP Request

Cada herramienta de CrawlForge es también un endpoint REST en https://www.crawlforge.dev/api/v1/tools/<tool_name>. No necesita ningún servidor propio, por lo que es la opción correcta para n8n Cloud (que no puede alcanzar un endpoint MCP en localhost). Añada un nodo HTTP Request y configúrelo:

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

La guía de automatización de flujos de trabajo con n8n construye un pipeline de producción completo sobre este patrón — credenciales reutilizables, un monitor de precios programado, manejo de errores y notificaciones de Slack. Los parámetros de las herramientas y las formas de respuesta están en la referencia de la API.

¿Qué opción debería usar?

	Nodo MCP Client	Nodo HTTP Request
Funciona en n8n Cloud	Solo con un servidor MCP alojado públicamente	Sí
Ejecuta su propio servidor	Sí — un solo comando `npx`	No
Descubrimiento de herramientas	Automático — las 28 herramientas listadas en el nodo	Manual — un endpoint por herramienta
Entrada de parámetros	Generada a partir del esquema de la herramienta	Cuerpo JSON escrito a mano
Uso de herramientas por AI Agent	Sí, vía el subnodo MCP Client Tool	No

Alojar el endpoint MCP públicamente: Para usar el nodo MCP Client desde n8n Cloud, aloje el servidor en una URL pública — el repositorio crawlforge-mcp-server incluye un Dockerfile y un blueprint de Render que lo ejecutan en modo HTTP.

Costos en credits

Ambos métodos de conexión facturan los mismos costos de credits por herramienta contra su API key — por ejemplo, fetch_url cuesta 1 credit, extract_content cuesta 2 y search_web cuesta 5. La tabla completa está en la referencia de la API; los 1,000 credits únicos del plan Free son más que suficientes para construir y probar flujos de trabajo.

Solución de problemas

Síntoma	Solución
401 Unauthorized desde el nodo MCP Client	La credencial Bearer debe coincidir exactamente con la `CRAWLFORGE_API_KEY` con la que se inició el servidor — se comparan como cadenas.
Connection refused / no se pudo conectar	El servidor no se está ejecutando en modo HTTP, o n8n se ejecuta en Docker y el endpoint dice `localhost` — use `host.docker.internal`.
El menú desplegable Tool permanece vacío	Compruebe que Server Transport sea HTTP Streamable y que la ruta del endpoint termine en `/mcp`. Verifique que el servidor esté sano: `curl http://localhost:10000/health`.
402 Payment Required al ejecutar una herramienta	La cuenta asociada a la API key se quedó sin credits — revise el uso en el panel.

Comience a automatizar con n8n

Regístrese gratis y obtenga 1,000 credits — sin tarjeta de crédito. Luego siga la guía de flujos de trabajo para construir su primer pipeline de scraping.

Obtenga su API key gratis Guía de flujos de trabajo con 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" }

Nodo MCP Client

Nodo HTTP Request

Funciona en n8n Cloud

Solo con un servidor MCP alojado públicamente

Sí

Ejecuta su propio servidor

Sí — un solo comando npx

Descubrimiento de herramientas

Automático — las 28 herramientas listadas en el nodo

Manual — un endpoint por herramienta

Entrada de parámetros

Generada a partir del esquema de la herramienta

Cuerpo JSON escrito a mano

Uso de herramientas por AI Agent

Sí, vía el subnodo MCP Client Tool

Síntoma

Solución

401 Unauthorized desde el nodo MCP Client

La credencial Bearer debe coincidir exactamente con la CRAWLFORGE_API_KEY con la que se inició el servidor — se comparan como cadenas.

Connection refused / no se pudo conectar

El servidor no se está ejecutando en modo HTTP, o n8n se ejecuta en Docker y el endpoint dice localhost — use host.docker.internal.

El menú desplegable Tool permanece vacío

Compruebe que Server Transport sea *HTTP Streamable* y que la ruta del endpoint termine en /mcp. Verifique que el servidor esté sano: curl http://localhost:10000/health.

402 Payment Required al ejecutar una herramienta

La cuenta asociada a la API key se quedó sin credits — revise el uso en el panel.