{"_id":"@casistack/n8n-nodes-firecrawl","name":"@casistack/n8n-nodes-firecrawl","dist-tags":{"latest":"2.1.0"},"versions":{"2.1.0":{"name":"@casistack/n8n-nodes-firecrawl","version":"2.1.0","description":"Firecrawl nodes for n8n (self-hosted fork) - scrape, crawl, map, search, and extract data from websites. Supports AI Agent tool usage.","keywords":["n8n-community-node-package"],"license":"MIT","homepage":"https://www.firecrawl.dev","author":{"name":"casistack"},"repository":{"type":"git","url":"git+https://github.com/casistack/n8n-nodes-firecrawl.git"},"main":"index.js","scripts":{"build":"tsc && gulp build:icons","dev":"tsc --watch","format":"prettier nodes credentials --write","lint":"eslint nodes credentials package.json","lintfix":"eslint nodes credentials package.json --fix","prepublishOnly":"npm run build && npm run lint -c .eslintrc.prepublish.js nodes credentials package.json"},"n8n":{"n8nNodesApiVersion":1,"credentials":["dist/credentials/FirecrawlApi.credentials.js"],"nodes":["dist/nodes/Firecrawl/Firecrawl.node.js"]},"devDependencies":{"@typescript-eslint/parser":"~5.45","eslint-plugin-n8n-nodes-base":"^1.11.0","gulp":"^4.0.2","n8n-workflow":"*","prettier":"^2.7.1","typescript":"~4.8.4"},"peerDependencies":{"n8n-workflow":">=1.79.0"},"publishConfig":{"access":"public"},"_id":"@casistack/n8n-nodes-firecrawl@2.1.0","gitHead":"ada9ea4154d39f3d29c489dbaddcf42fc8f5581a","bugs":{"url":"https://github.com/casistack/n8n-nodes-firecrawl/issues"},"_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-2xCDmd4cmObhtCwXtK2L1MsIhsxgldwGjMRnX7Fo3fpn+bMU9ugQNtS/Ax0ZKAUhPZJTwjMj/qGaOeOBQR6zHg==","shasum":"bfab1b82c98e90e07748910199c71aff87dcf441","tarball":"https://registry.npmjs.org/@casistack/n8n-nodes-firecrawl/-/n8n-nodes-firecrawl-2.1.0.tgz","fileCount":110,"unpackedSize":336601,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDfsAANqJbM9QMADJCHbwjcHuRHAbYlXnTj47xYyPvTmQIhAJrUOqmOqSD78NxnPBXB71DFCpxw4IDUUA80RNjXQnoa"}]},"_npmUser":{"name":"datpiff","email":"u_dawgy@yahoo.com"},"directories":{},"maintainers":[{"name":"datpiff","email":"u_dawgy@yahoo.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-firecrawl_2.1.0_1769962124375_0.8922256134842304"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-01T16:08:44.285Z","2.1.0":"2026-02-01T16:08:44.516Z","modified":"2026-02-01T16:08:44.829Z"},"maintainers":[{"name":"datpiff","email":"u_dawgy@yahoo.com"}],"description":"Firecrawl nodes for n8n (self-hosted fork) - scrape, crawl, map, search, and extract data from websites. Supports AI Agent tool usage.","homepage":"https://www.firecrawl.dev","keywords":["n8n-community-node-package"],"repository":{"type":"git","url":"git+https://github.com/casistack/n8n-nodes-firecrawl.git"},"author":{"name":"casistack"},"bugs":{"url":"https://github.com/casistack/n8n-nodes-firecrawl/issues"},"license":"MIT","readme":"# n8n-nodes-firecrawl 🔥\n\nThis is an n8n community node. It lets you use **[Firecrawl](https://firecrawl.dev)** in your n8n workflows.\n\n> 🔥 Turn entire websites into LLM-ready markdown or structured data. Scrape, crawl and extract with a single API.\n\n[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.\n\n[Installation](#installation)\n[Operations](#operations)\n[AI Agent Tool Usage](#ai-agent-tool-usage)\n[Credentials](#credentials)\n[Compatibility](#compatibility)\n[Resources](#resources)\n[Version history](#version-history)  \n\n## Installation\n\nFollow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.\n\n## Operations\n\nThe **Firecrawl** node supports the following operations:\n\n### Search\n- Search and optionally scrape search results\n\n### Map\n- Input a website and get all the website urls\n\n### Scrape\n- Scrapes a URL and get its content in LLM-ready format (markdown, structured data via LLM Extract, screenshot, html)\n\n### Crawl\n- Scrapes all the URLs of a web page and return content in LLM-ready format\n\n### Batch Scrape\n- Start a batch job to scrape multiple URLs at once\n\n### Batch Scrape Status\n- Get the status/result of a batch scrape job by ID\n\n### Batch Scrape Errors\n- Retrieve errors for a batch scrape job by ID\n\n### Crawl Active\n- List all currently active crawl jobs for your team\n\n### Crawl Params Preview\n- Preview crawl parameters generated from a natural-language prompt\n\n### Cancel Crawl\n- Cancel a running crawl job by ID\n\n### Get Crawl Errors\n- Retrieve errors for a crawl job by ID\n\n### Get Crawl Status\n- Check the current status of a crawl job\n\n### Extract Data\n- Get structured data from single page, multiple pages or entire websites with AI\n\n### Get Extract Status\n- Get the current status of an extraction job\n\n### Team Token Usage\n- Get remaining and plan tokens for the authenticated team\n\n### Team Credit Usage\n- Get remaining and plan credits for the authenticated team\n\n### Historical Credit Usage\n- Get historical credit usage for your team\n\n### Historical Token Usage\n- Get historical token usage for your team\n\n### Team Queue Status\n- Get your team's current queue load (waiting, active, max concurrency)\n\n## AI Agent Tool Usage\n\nThis 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.\n\n### Requirements\n\n- **n8n version 1.79.0 or higher** is required for AI tool support\n- Set the environment variable `N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true` to enable community nodes as AI tools\n\n### Docker Configuration\n\n```yaml\nversion: '3'\nservices:\n  n8n:\n    image: n8nio/n8n\n    environment:\n      - N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true\n    ports:\n      - \"5678:5678\"\n    volumes:\n      - ~/.n8n:/home/node/.n8n\n```\n\n### Using with AI Agents\n\n1. Add the **AI Agent** node to your workflow\n2. Connect the **Firecrawl** node as a tool input to the AI Agent\n3. The AI agent can now dynamically decide when and how to use Firecrawl operations\n\n### Dynamic Parameters with $fromAI()\n\nWhen 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.\n\nExample expressions:\n```javascript\n// Let AI decide the URL to scrape\n{{ $fromAI(\"url\", \"The URL to scrape\", \"string\") }}\n\n// Let AI decide the search query\n{{ $fromAI(\"query\", \"Search query for finding relevant pages\", \"string\") }}\n\n// Let AI decide whether to include subdomains\n{{ $fromAI(\"includeSubdomains\", \"Whether to include subdomains\", \"boolean\", false) }}\n```\n\n### Best Practices for AI Tool Usage\n\n1. **Use clear operation names**: The AI agent uses operation descriptions to decide when to use each tool\n2. **Provide context in prompts**: When using the Extract operation, provide clear prompts to guide data extraction\n3. **Set reasonable limits**: Configure default limits to prevent excessive API usage\n4. **Use the Map operation first**: For unknown sites, use Map to discover URLs before scraping\n\n## Credentials\n\nTo use the Firecrawl node, you need to:\n\n1. Sign up for a Firecrawl account at [https://firecrawl.dev](https://firecrawl.dev)\n2. Get your API key from the Firecrawl dashboard\n3. In n8n, add your Firecrawl API key to the node's credentials\n\n> [!CAUTION]  \n> The API key should be kept secure and never shared publicly\n\n## Compatibility\n\n- **Minimum n8n version: 1.79.0** (required for AI tool support)\n- Tested against n8n versions: 1.79.0+\n- Node.js version: 18 or higher\n\n> **Note**: If you don't need AI tool support, earlier versions of n8n may work, but 1.79.0+ is recommended.\n\n## Resources\n\n* [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)\n* [Firecrawl Documentation](https://firecrawl.dev/docs)\n* [Firecrawl API Reference](https://docs.firecrawl.dev/api-reference/introduction)\n\n## Version history\n\n### 1.1.0\n- **AI Agent Tool Support**: Node can now be used as a tool with n8n's AI Agent node\n  - Added `usableAsTool: true` to enable tool mode\n  - Enhanced all field descriptions for better AI context understanding\n  - Supports `$fromAI()` function for dynamic parameter values\n- Updated minimum n8n version requirement to 1.79.0\n- Improved operation descriptions for clearer AI agent decision making\n\n### 1.0.6\n- Add support for additional Firecrawl endpoints:\n  - Batch Scrape (start/status/errors)\n  - Crawl Active\n  - Crawl Params Preview\n  - Cancel Crawl \n  - Get Crawl Errors\n  - Team Token Usage\n  - Team Credit Usage\n  - Historical Credit Usage\n  - Historical Token Usage\n  - Team Queue Status\n- Wire new operations into the node and align with Firecrawl API v2\n\n### 1.0.5\n- API version updated to [/v2](https://docs.firecrawl.dev/migrate-to-v2)\n- Unified sitemap configuration parameters in Map operation\n- Replaced `ignoreSitemap` and `sitemapOnly` with unified `sitemap` parameter\n- `sitemap` parameter now accepts: \"include\" (default), \"only\", or \"skip\"\n\n### 1.0.4\n- Add additional fields property for custom data in Firecrawl API nodes\n\n### 1.0.2\n- Add integration parameter in all endpoint calls\n\n### 1.0.1\n- Support for Search operation\n\n### 1.0.0\n- Initial release\n- Support for all basic Firecrawl operations:\n  - Map URLs\n  - Scrape URL\n  - Crawl Website\n  - Get Crawl Status\n  - Extract Data\n  - Get Extract Status\n- Basic error handling and response processing\n- Support for custom body options\n\n## More information\n\nRefer to our [documentation on creating nodes](https://docs.n8n.io/integrations/creating-nodes/) for detailed information on building your own nodes.\n\n## License\n\n[MIT](https://github.com/n8n-io/n8n-nodes-starter/blob/master/LICENSE.md)\n","readmeFilename":"README.md","_rev":"1-8900e0e262ea154ad9c21d187c21d1e7"}