Skip to content

Conversation

@chandrapratamar
Copy link
Contributor

@chandrapratamar chandrapratamar commented Nov 1, 2025

ScreenRecorderProject24_1.mp4

Summary

Adds Tool Node support to the Firecrawl n8n integration, enabling seamless compatibility with n8n's AI Agent system while maintaining full backward compatibility with existing workflows.

Fixes firecrawl/firecrawl#2340

Changes

Core Implementation

  • Added Tool Resource: New "Tool" resource option alongside existing "Default" resource
  • Tool Operation Properties: Created structured property definitions for all Firecrawl operations in toolSchemas.ts
  • Dual Resource Support: Users can now choose between:
    • Default Mode: Full-featured UI with all advanced options
    • Tool Mode: AI Agent optimized with simplified, structured parameters

Technical Details

  • Integrated tool operation properties into main properties array
  • Added resource-based routing for tool operations
  • Implemented custom execute handler for tool resource
  • Maintained existing Default resource functionality unchanged

Operations Supported in Tool Mode

  • Scrape URLs with AI-friendly formatting
  • Web Search with structured results
  • Extract data using natural language prompts
  • Map websites and discover URLs
  • Crawl websites systematically
  • Batch scrape multiple URLs
  • Monitor crawl/extract job status
  • Check team usage (tokens/credits)

Documentation

  • Added comprehensive AI Agent Integration section to README
  • Documented Tool Mode features and usage examples
  • Updated version history to v1.0.7
  • Included JSON configuration examples for AI workflows

Testing Environment

docker-compose.yml

services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n-clean-1
    ports:
      - "5678:5678"
    restart: unless-stopped
    environment:
      - GENERIC_TIMEZONE=Europe/Lisbon
      - N8N_LOG_LEVEL=info
      - N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
      - N8N_CUSTOM_EXTENSIONS=/home/tama/n8n-nodes-firecrawl-master/dist/nodes/Firecrawl
    volumes:
      - /home/tama/n8n-nodes-firecrawl-master/dist/nodes/Firecrawl:/home/tama/n8n-nodes-firecrawl-master/dist/nodes/Firecrawl

## Summary

Adds Tool Node support to the Firecrawl n8n integration, enabling seamless compatibility with n8n's AI Agent system while maintaining full backward compatibility with existing workflows.

## Changes

### Core Implementation
- **Added Tool Resource**: New "Tool" resource option alongside existing "Default" resource
- **Tool Operation Properties**: Created structured property definitions for all Firecrawl operations in `toolSchemas.ts`
- **Dual Resource Support**: Users can now choose between:
  - **Default Mode**: Full-featured UI with all advanced options
  - **Tool Mode**: AI Agent optimized with simplified, structured parameters

### Technical Details
- Integrated tool operation properties into main properties array
- Added resource-based routing for tool operations
- Implemented custom execute handler for tool resource
- Maintained existing Default resource functionality unchanged

### Operations Supported in Tool Mode
- Scrape URLs with AI-friendly formatting
- Web Search with structured results
- Extract data using natural language prompts
- Map websites and discover URLs
- Crawl websites systematically
- Batch scrape multiple URLs
- Monitor crawl/extract job status
- Check team usage (tokens/credits)

### Documentation
- Added comprehensive AI Agent Integration section to README
- Documented Tool Mode features and usage examples
- Updated version history to v1.0.7
- Included JSON configuration examples for AI workflows
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Firecrawl Tool Node Support for n8n (AI Agent Integration)

1 participant