MCP Guides
Firecrawl MCP: Web Content Extraction
Turn any web page into clean, structured markdown that the agent can work with. Firecrawl strips away navigation, ads, and boilerplate so Autohand gets just the content it needs.
What Firecrawl does
Firecrawl MCP converts web pages into clean markdown. Give it a URL and it returns the page content without navigation bars, cookie banners, sidebars, or advertising. This is useful when the agent needs to read a specific documentation page, analyze a competitor's API, or extract structured data from a web resource.
Firecrawl handles JavaScript-rendered pages, so it works with single-page applications and dynamically loaded content that basic HTTP fetches would miss.
Setup
Firecrawl MCP uses the stdio transport. Get an API key from firecrawl.dev (free tier available).
# Add Firecrawl MCP
autohand mcp add firecrawl npx -y firecrawl-mcp
# Set your API key
export FIRECRAWL_API_KEY="your-firecrawl-api-key"
# Verify the connection
autohand mcp list
Or configure it in ~/.autohand/config.json:
{
"mcp": {
"servers": [
{
"name": "firecrawl",
"transport": "stdio",
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": "your-firecrawl-api-key"
},
"autoConnect": true
}
]
}
}
Usage examples
Read a documentation page
# Point the agent at a specific doc page
autohand --prompt "Read https://docs.stripe.com/payments/accept-a-payment and implement a payment form using their latest API"
# Firecrawl extracts the Stripe docs as markdown, the agent uses it to write code
Extract API reference details
# Pull in a full API reference
autohand --prompt "Read the Cloudflare Workers API docs at https://developers.cloudflare.com/workers/runtime-apis/ and create a KV-backed REST API"
# Gets the full reference, not just what the model remembers from training
Analyze a GitHub README
# Read a project's README for context
autohand --prompt "Read https://github.com/drizzle-team/drizzle-orm and set up Drizzle with our existing PostgreSQL database"
Crawl multiple pages
# Firecrawl can crawl linked pages from a starting URL
autohand --prompt "Crawl the Hono.js documentation starting from https://hono.dev/docs/ and build a REST API with authentication middleware"
Firecrawl vs basic fetch
Autohand has a built-in fetch_url tool. Here is when to use Firecrawl instead:
| Feature | Built-in fetch | Firecrawl MCP |
|---|---|---|
| JavaScript rendering | No | Yes |
| Clean markdown output | Raw HTML | Structured markdown |
| Multi-page crawling | No | Yes |
| Boilerplate removal | No | Yes |
| Rate limiting | Manual | Built-in |
| Cost | Free | Free tier + paid plans |
Use the built-in fetch for simple static pages. Use Firecrawl when you need clean output from complex sites or need to crawl multiple linked pages.
Tips
- Firecrawl's free tier gives you 500 pages per month. For heavy documentation crawling, consider their paid plans.
- When crawling, set a depth limit to avoid pulling in hundreds of pages. The agent is smart enough to stop when it has enough context.
- Pair Firecrawl with Brave Search MCP: search to find the right page, then Firecrawl to read it in full.
- Firecrawl respects robots.txt and handles rate limiting automatically.