Firecrawl Setup Guide

1. Get Your API Key

Go to firecrawl.dev/app/sign-up
Create a free account (500 credits/month included)
Navigate to API Keys in the dashboard
Copy your API key (starts with fc-)

2. Run the Installer

The installer handles everything automatically:

./extensions/firecrawl/install.sh

It will prompt for your API key and configure the MCP server.

3. Manual MCP Configuration

If the installer fails, add this to ~/.claude/settings.json manually:

{
  "mcpServers": {
    "firecrawl-mcp": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-your-api-key-here"
      }
    }
  }
}

4. Verify Installation

Start Claude Code and try:

/seo firecrawl map https://example.com

You should see a list of discovered URLs. If you get a "tool not available" error, restart Claude Code to reload MCP servers.

5. Understanding Credits

Operation	Credits Used
`crawl`	1 per page crawled
`scrape`	1 per page
`map`	0.5 per URL discovered
`search`	1 per result returned

Free tier: 500 credits/month resets on your billing date.

Tip: Use map first (cheap) to see how many pages a site has, then decide how many to crawl (more expensive).