gh-nathanvale-side-quest-marketplace-plugins-firecrawl/skills/firecrawl/SKILL.md

name, description

name	description
firecrawl	Web scraping, search, and data extraction using Firecrawl API. Use when users need to fetch web content, discover URLs on sites, search the web, or extract structured data from pages.

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

Task	Command
Scrape a page	/firecrawl:scrape <url>
Map a site	/firecrawl:map <url>
Search the web	/firecrawl:search <query>
Extract data	/firecrawl:extract <url> --prompt "..."

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.