firecrawl

Firecrawl

Overview

Firecrawl is a powerful web scraping and search API. This plugin provides a token-efficient interface for Claude Code through slash commands.

When to Use This Skill

• Scraping: Fetch content from a single URL as markdown
• Mapping: Discover all URLs on a website
• Searching: Search the web and optionally scrape results
• Extracting: Pull structured data from pages using LLM

Quick Reference

Commands

Scrape - Get Page Content

Fetches and converts a web page to clean markdown.

/firecrawl:scrape https://example.com
/firecrawl:scrape https://example.com --format summary

Options:

• --format markdown|summary - Output format (default: markdown)

Best for:

• Reading documentation
• Fetching article content
• Getting page text for analysis

Map - Discover URLs

Finds all URLs on a website. Useful for understanding site structure.

/firecrawl:map https://example.com
/firecrawl:map https://example.com --limit 50

Options:

• --limit N - Maximum URLs to return (default: 100)

Best for:

• Understanding site structure
• Finding specific pages before scraping
• Discovering documentation sections

Search - Web Search

Searches the web and returns results with optional content scraping.

/firecrawl:search typescript tutorials
/firecrawl:search "react hooks guide" --limit 10

Options:

• --limit N - Maximum results (default: 5)

Supports search operators:

• "exact phrase" - Exact match
• -term - Exclude term
• site:example.com - Limit to domain
• intitle:word - Word in title

Best for:

• Finding information across the web
• Researching topics
• Finding documentation

Extract - Structured Data

Extracts specific data from pages using LLM prompts.

/firecrawl:extract https://example.com --prompt "Extract the main heading and description"
/firecrawl:extract https://example.com/product --prompt "Extract price and features" --schema '{"price": {"type": "number"}, "features": {"type": "array"}}'

Options:

• --prompt "text" - What to extract (required)
• --schema '{...}' - JSON Schema for structured output

Best for:

• Extracting specific data points
• Getting structured information
• Pulling prices, names, dates, etc.

Environment Setup

Requires FIRECRAWL_API_KEY environment variable.

Get your API key from: https://firecrawl.dev

Examples

Research a Topic

/firecrawl:search "best practices for TypeScript error handling" --limit 5

Read Documentation

/firecrawl:scrape https://docs.example.com/api/authentication

Map a Documentation Site

/firecrawl:map https://docs.example.com --limit 200

Extract Product Info

/firecrawl:extract https://store.example.com/product/123 --prompt "Extract product name, price, and availability"

Token Efficiency

This plugin is designed for minimal token consumption:

• Scrape: Returns clean markdown, truncated at 8000 chars
• Map: Shows up to 50 URLs with titles
• Search: Limits to 10 results with summaries
• Extract: Returns only requested data

Compare to the full MCP server which loads ~14k tokens just from tool definitions.

Error Handling

Common errors:

• API key required - Set FIRECRAWL_API_KEY
• Invalid URL - Check URL format
• Rate limited - Wait and retry (auto-handled)
• Site blocked - Some sites block scraping

Pricing Note

Firecrawl charges per operation:

• Scrape: 1 credit per page
• Map: 1 credit per call
• Search: 1 credit per result
• Extract: Varies by complexity

Check https://firecrawl.dev/pricing for current rates.