firecrawl

Firecrawl Plugin for Claude Code

Turn any website into clean, LLM-ready markdown or structured data — directly from Claude Code.

This plugin adds the Firecrawl CLI as a skill to Claude Code, giving it the ability to scrape, search, crawl, and map the web.

Features

• Search - Web search with optional scraping of results (supports web, news, and image sources)
• Scrape - Extract clean markdown content from any webpage, with JavaScript rendering
• Map - Discover all URLs on a website
• Crawl - Extract content from entire websites
• Browser - Launch cloud browser sessions and execute Playwright code remotely

All operations include automatic JavaScript rendering, anti-bot handling, and proxy rotation.

Installation

1. Install the Plugin

In Claude Code, run /plugin and search for firecrawl, then select it to install.

2. Install the Firecrawl CLI

The plugin requires the Firecrawl CLI to be installed globally:

npm install -g firecrawl-cli

3. Authenticate

Run the following to authenticate via your browser:

firecrawl login --browser

Or authenticate with an API key directly:

firecrawl login --api-key "fc-YOUR-API-KEY"

You can also set the key as an environment variable (add to ~/.zshrc or ~/.bashrc for persistence):

export FIRECRAWL_API_KEY=fc-YOUR-API-KEY

Get your free API key at: https://firecrawl.dev/app/api-keys

4. Verify Setup

firecrawl --status

You should see your authentication status, concurrency limit, and remaining credits.

Usage

Once installed, Claude Code will automatically use Firecrawl for web tasks. Just ask naturally:

Search the web:

Search for "best practices for React testing" and compile the key recommendations

Scrape a page:

Scrape https://docs.firecrawl.dev/introduction and summarize the key points

Discover site structure:

Map all URLs on https://firecrawl.dev

Research a topic:

Research the latest developments in AI agents and give me a summary

CLI Commands

The plugin uses these Firecrawl CLI commands under the hood:

| Command | Description | |---------|-------------| | firecrawl search "query" | Search the web (supports --sources, --scrape, --tbs for time filters) | | firecrawl scrape <url> | Scrape a single page to markdown | | firecrawl map <url> | Discover all URLs on a site | | firecrawl browser launch/execute/list/close | Manage cloud browser sessions and execute Playwright code | | firecrawl --status | Check auth status, concurrency, and credits |

Output Files

Results are saved to a .firecrawl/ directory in your project to keep Claude Code's context window clean:

.firecrawl/search-react_server_components.json
.firecrawl/docs.github.com-actions-overview.md
.firecrawl/firecrawl.dev.md

Configuration

| Variable | Required | Description | |----------|----------|-------------| | FIRECRAWL_API_KEY | Yes (if not using firecrawl login) | Your Firecrawl API key | | FIRECRAWL_API_URL | No | Custom API endpoint (for self-hosted instances) |

Self-Hosted Deployment

Firecrawl can be self-hosted. Set FIRECRAWL_API_URL to point to your instance:

export FIRECRAWL_API_URL=https://your-firecrawl-instance.com

See the Firecrawl documentation for self-hosting instructions.

Resources

• Firecrawl Documentation
• Firecrawl CLI Repository
• API Reference
• Get API Key

License

This plugin is licensed under AGPL-3.0, consistent with Firecrawl's open-source license.

Support

• Firecrawl Discord
• GitHub Issues
• Email: hello@firecrawl.dev