Introduction - Firecrawl Docs

Get started#

Set up Firecrawl MCP

See all setup options

Run this in your terminal to add Firecrawl as a remote MCP server in Codex.

codex mcp add firecrawl --url https://mcp.firecrawl.dev/v2/mcp-oauth && codex mcp login firecrawl

Then enter /mcp in Codex and confirm firecrawl is connected.

Run this in your terminal to add Firecrawl as a remote MCP server in Claude Code.

claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

Then enter /mcp in Claude Code and complete the browser sign-in.

Install the hosted MCP server in one click, or copy the configuration below.

Add to Cursor

mcp.json

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
    }
  }
}

Open Cursor Settings, select MCP, and complete the Firecrawl sign-in.

Add this remote server configuration to your global or project config. OpenCode opens Firecrawl in your browser on first use.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "firecrawl": {
      "type": "remote",
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth",
      "enabled": true
    }
  }
}

Build directly with the API#

Scrape your first page now. No account or API key is required for this request.

cURL

# No API key needed to get started — add -H "Authorization: Bearer $FIRECRAWL_API_KEY" for higher rate limits:curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \  -H "Content-Type: application/json" \  -d '{    "url": "https://firecrawl.dev",    "formats": ["markdown", "html"]  }'

Add an API key when you need higher limits. See the Python SDK, Node SDK, or API reference to build it into your application.

Other ways to get started#

Install the Firecrawl CLI#

One command installs the Firecrawl CLI, authenticates in your browser, and adds skills to every detected coding agent.

npx -y firecrawl-cli@latest init --all --browser

Note

Restart your coding agent after setup so it can discover the new skills. See CLI for the full setup.

Set up with an agent#

Provide your agent with this Firecrawl setup prompt, or see all MCP setup options.

Note

For AI agents: Use llms.txt for an index of the documentation, or llms-full.txt for the full text.

Build and test directly#

Get your API key

Create a free account for direct API access and higher limits

Try it in the Playground

Test Firecrawl in the browser without writing code

What can Firecrawl do?#

Search the web and get full page content from results

Scrape

Extract content from any URL as markdown, HTML, or structured JSON

Interact

Continue working with any scraped page: click, fill forms, extract dynamic content

Why Firecrawl?#

LLM-ready output: Clean markdown, structured JSON, screenshots, and more.
Handles the hard stuff: Proxies, anti-bot, JavaScript rendering, and dynamic content.
Reliable: Built for production with high uptime and consistent results.
Fast: Results in seconds, optimized for high throughput.
MCP Server: Connect Firecrawl to any AI tool via the Model Context Protocol.

Bounty: 5,000 credit reward for solid feedback on Firecrawl

To qualify, complete a high-signal interview (thoughtful, concrete use cases, etc) with our Firecrawl Feedback Assistant. Only takes a few minutes, can be stopped at any time, and is both human/agent-friendly (just paste the link into your agentic harness!). New to Firecrawl? Your take still counts.

Start the interview

Include your email to be eligible. Interviews are reviewed for quality at the end of each week.

Search#

Search the web and get full page content from results in one call. See the Search feature docs for all options.

Response

SDKs will return the data object directly. cURL will return the complete payload.

JSON

{  "success": true,  "data": {    "web": [      {        "url": "https://www.firecrawl.dev/",        "title": "Firecrawl - The Web Data API for AI",        "description": "The web crawling, scraping, and search API for AI. Built for scale. Firecrawl delivers the entire internet to AI agents and builders.",        "position": 1      },      {        "url": "https://github.com/firecrawl/firecrawl",        "title": "mendableai/firecrawl: Turn entire websites into LLM-ready ... - GitHub",        "description": "Firecrawl is an API service that takes a URL, crawls it, and converts it into clean markdown or structured data.",        "position": 2      },      ...    ],    "images": [      {        "title": "Quickstart | Firecrawl",        "imageUrl": "https://mintlify.s3.us-west-1.amazonaws.com/firecrawl/logo/logo.png",        "imageWidth": 5814,        "imageHeight": 1200,        "url": "https://docs.firecrawl.dev/",        "position": 1      },      ...    ],    "news": [      {        "title": "Y Combinator startup Firecrawl is ready to pay $1M to hire three AI agents as employees",        "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-firecrawl-is-ready-to-pay-1m-to-hire-three-ai-agents-as-employees/",        "snippet": "It's now placed three new ads on YC's job board for “AI agents only” and has set aside a $1 million budget total to make it happen.",        "date": "3 months ago",        "position": 1      },      ...    ]  }}

Scrape#

Scrape any URL and get its content in markdown, HTML, or other formats. See the Scrape feature docs for all options.

Response

SDKs will return the data object directly. cURL will return the payload exactly as shown below.

{  "success": true,  "data" : {    "markdown": "Launch Week I is here! [See our Day 2 Release 🚀](https://www.firecrawl.dev/blog/launch-week-i-day-2-doubled-rate-limits)[💥 Get 2 months free...",    "html": "<!DOCTYPE html><html lang=\"en\" class=\"light\" style=\"color-scheme: light;\"><body class=\"__variable_36bd41 __variable_d7dc5d font-inter ...",    "metadata": {      "title": "Home - Firecrawl",      "description": "Firecrawl crawls and converts any website into clean markdown.",      "language": "en",      "keywords": "Firecrawl,Markdown,Data,Mendable,Langchain",      "robots": "follow, index",      "ogTitle": "Firecrawl",      "ogDescription": "Turn any website into LLM-ready data.",      "ogUrl": "https://www.firecrawl.dev/",      "ogImage": "https://www.firecrawl.dev/og.png?123",      "ogLocaleAlternate": [],      "ogSiteName": "Firecrawl",      "sourceURL": "https://firecrawl.dev",      "statusCode": 200,      "contentType": "text/html"    }  }}

Interact#

Scrape a page, then keep working with it: click buttons, fill forms, extract dynamic content, or navigate deeper. Describe what you want in plain English or write code for full control. See the Interact feature docs for all options.

Response

{  "success": true,  "cdpUrl": "wss://browser.firecrawl.dev/...",  "liveViewUrl": "https://liveview.firecrawl.dev/...",  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",  "output": "The iPhone 16 Pro Max (256GB) is priced at $1,199.00.",  "exitCode": 0,  "killed": false}