n8n-nodes-firecrawl 🔥

This is an n8n community node. It lets you use Firecrawl in your n8n workflows.

> 🔥 Turn entire websites into LLM-ready markdown or structured data. Scrape, crawl and extract with a single API.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
AI Agent Tool Usage
Credentials
Compatibility
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

The Firecrawl node supports the following operations:

$3

- Search and optionally scrape search results

$3

- Input a website and get all the website urls

$3

- Scrapes a URL and get its content in LLM-ready format (markdown, structured data via LLM Extract, screenshot, html)

$3

- Scrapes all the URLs of a web page and return content in LLM-ready format

$3

- Start a batch job to scrape multiple URLs at once

$3

- Get the status/result of a batch scrape job by ID

$3

- Retrieve errors for a batch scrape job by ID

$3

- List all currently active crawl jobs for your team

$3

- Preview crawl parameters generated from a natural-language prompt

$3

- Cancel a running crawl job by ID

$3

- Retrieve errors for a crawl job by ID

$3

- Check the current status of a crawl job

$3

- Get structured data from single page, multiple pages or entire websites with AI

$3

- Get the current status of an extraction job

$3

- Get remaining and plan tokens for the authenticated team

$3

- Get remaining and plan credits for the authenticated team

$3

- Get historical credit usage for your team

$3

- Get historical token usage for your team

$3

- Get your team's current queue load (waiting, active, max concurrency)

AI Agent Tool Usage

This node can be used as a tool with n8n's AI Agent node, allowing AI agents to scrape, crawl, and extract data from websites dynamically.

$3

- n8n version 1.79.0 or higher is required for AI tool support
- Set the environment variable N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true to enable community nodes as AI tools

$3

``yaml
version: '3'
services:
n8n:
image: n8nio/n8n
environment:
- N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
ports:
- "5678:5678"
volumes:
- ~/.n8n:/home/node/.n8n
`

$3

1. Add the AI Agent node to your workflow
2. Connect the Firecrawl node as a tool input to the AI Agent
3. The AI agent can now dynamically decide when and how to use Firecrawl operations

$3

When using Firecrawl as an AI tool, you can let the AI agent decide parameter values dynamically using the $fromAI() function. Click the "Let the model define this parameter" button next to any field to enable this feature.

Example expressions:
`javascript
// Let AI decide the URL to scrape
{{ $fromAI("url", "The URL to scrape", "string") }}

// Let AI decide the search query
{{ $fromAI("query", "Search query for finding relevant pages", "string") }}

// Let AI decide whether to include subdomains
{{ $fromAI("includeSubdomains", "Whether to include subdomains", "boolean", false) }}
`

$3

1. Use clear operation names: The AI agent uses operation descriptions to decide when to use each tool
2. Provide context in prompts: When using the Extract operation, provide clear prompts to guide data extraction
3. Set reasonable limits: Configure default limits to prevent excessive API usage
4. Use the Map operation first: For unknown sites, use Map to discover URLs before scraping

Credentials

To use the Firecrawl node, you need to:

1. Sign up for a Firecrawl account at https://firecrawl.dev
2. Get your API key from the Firecrawl dashboard
3. In n8n, add your Firecrawl API key to the node's credentials

> [!CAUTION]
> The API key should be kept secure and never shared publicly

Compatibility

- Minimum n8n version: 1.79.0 (required for AI tool support)
- Tested against n8n versions: 1.79.0+
- Node.js version: 18 or higher

> Note: If you don't need AI tool support, earlier versions of n8n may work, but 1.79.0+ is recommended.

Resources

* n8n community nodes documentation
* Firecrawl Documentation
* Firecrawl API Reference

Version history

$3


- AI Agent Tool Support: Node can now be used as a tool with n8n's AI Agent node
- Added usableAsTool: true to enable tool mode
- Enhanced all field descriptions for better AI context understanding
- Supports $fromAI() function for dynamic parameter values
- Updated minimum n8n version requirement to 1.79.0
- Improved operation descriptions for clearer AI agent decision making

$3

- Add support for additional Firecrawl endpoints:
- Batch Scrape (start/status/errors)
- Crawl Active
- Crawl Params Preview
- Cancel Crawl
- Get Crawl Errors
- Team Token Usage
- Team Credit Usage
- Historical Credit Usage
- Historical Token Usage
- Team Queue Status
- Wire new operations into the node and align with Firecrawl API v2

$3

- API version updated to /v2
- Unified sitemap configuration parameters in Map operation
- Replaced ignoreSitemap and sitemapOnly with unified sitemap parameter
- sitemap` parameter now accepts: "include" (default), "only", or "skip"

$3

- Add additional fields property for custom data in Firecrawl API nodes

$3

- Add integration parameter in all endpoint calls

$3

- Support for Search operation

$3

- Initial release
- Support for all basic Firecrawl operations:
- Map URLs
- Scrape URL
- Crawl Website
- Get Crawl Status
- Extract Data
- Get Extract Status
- Basic error handling and response processing
- Support for custom body options

More information

Refer to our documentation on creating nodes for detailed information on building your own nodes.

License

MIT