Introdução - Firecrawl Docs

Primeiros passos#

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
    }
  }
}

Desenvolva diretamente com a API#

Faça o scraping da sua primeira página agora. Não é necessário ter uma conta nem uma chave de API para esta solicitação.

cURL

# Nenhuma API key necessária para começar — adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para limites de taxa mais altos:curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \  -H "Content-Type: application/json" \  -d '{    "url": "https://firecrawl.dev",    "formats": ["markdown", "html"]  }'

Adicione uma chave de API quando precisar de limites maiores. Consulte o SDK Python, o SDK de Node ou a referência da API para integrá-la ao seu aplicativo.

Outras formas de começar#

Instale a CLI do Firecrawl#

Um único comando instala a CLI do Firecrawl, faz a autenticação no seu navegador e adiciona skills a todos os agentes de programação detectados.

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

Note

Reinicie o seu agente de programação após a configuração para que ele possa descobrir as novas skills. Consulte CLI para o guia completo de configuração.

Configure usando um agente#

Forneça ao seu agente este prompt de configuração do Firecrawl ou veja todas as opções de configuração do MCP.

Note

Para agentes de IA: Use llms.txt para obter um índice da documentação ou llms-full.txt para acessar o texto completo.

Crie e teste diretamente#

Obtenha sua chave de API

Crie uma conta gratuita para acesso direto à API e limites mais altos

Experimente no Playground

Teste o Firecrawl no navegador sem escrever código

O que o Firecrawl pode fazer?#

busca

Faça uma busca na web e obtenha o conteúdo completo da página a partir dos resultados

scraping

Extraia conteúdo de qualquer URL como markdown, HTML ou JSON estruturado

interagir

Continue trabalhando com qualquer página obtida por scraping: clique, preencha formulários e extraia conteúdo dinâmico

Por que Firecrawl?#

Resultado pronto para LLM: Markdown limpo, JSON estruturado, capturas de tela e muito mais.
Lida com o mais difícil: Proxies, anti-bot, renderização de JavaScript e conteúdo dinâmico.
Confiável: Projetado para produção, com alta disponibilidade e resultados consistentes.
Rápido: Resultados em segundos, otimizado para alto throughput.
MCP Server: Conecte o Firecrawl a qualquer ferramenta de IA via Model Context Protocol.

Recompensa: 5.000 créditos por feedback consistente sobre o Firecrawl

Para se qualificar, participe de uma entrevista com informações relevantes (casos de uso concretos e bem elaborados etc.) com nosso Assistente de Feedback do Firecrawl. Leva apenas alguns minutos, pode ser interrompida a qualquer momento e funciona bem para humanos e agentes (basta colar o link no seu ambiente de agentes!). Novo no Firecrawl? Sua opinião também conta.

Iniciar a entrevista

Inclua seu e-mail para se qualificar. As entrevistas são avaliadas quanto à qualidade ao fim de cada semana.

Busca#

Faça uma busca na web e obtenha o conteúdo completo da página a partir dos resultados em uma única chamada. Consulte a documentação do recurso de busca para ver todas as opções.

Resposta

Os SDKs retornarão diretamente o objeto de dados. O cURL retornará o payload completo.

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      },      ...    ]  }}

Scraping#

Faça scraping de qualquer URL e obtenha seu conteúdo em markdown, HTML ou outros formatos. Veja a documentação do recurso de scraping para ver todas as opções.

Resposta

Os SDKs retornarão o objeto de dados diretamente. O cURL retornará o payload exatamente como mostrado abaixo.

{  "success": true,  "data" : {    "markdown": "A Launch Week I chegou! [Confira nosso lançamento do Dia 2 🚀](https://www.firecrawl.dev/blog/launch-week-i-day-2-doubled-rate-limits)[💥 Ganhe 2 meses grátis...",    "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": "O Firecrawl rastreia e converte qualquer site em markdown limpo.",      "language": "en",      "keywords": "Firecrawl,Markdown,Dados,Mendable,Langchain",      "robots": "follow, index",      "ogTitle": "Firecrawl",      "ogDescription": "Transforme qualquer site em dados prontos para LLM.",      "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"    }  }}

Interagir#

Faça o scraping de uma página e depois continue trabalhando com ela: clique em botões, preencha formulários, extraia conteúdo dinâmico ou navegue mais a fundo. Descreva o que você quer em inglês simples ou escreva código para ter controle total. Consulte a documentação do recurso Interact para ver todas as opções.

Resposta

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}

Mais recursos#

Agente

Coleta autônoma de dados da web com IA

Interagir

Clique, preencha formulários e extraia conteúdo dinâmico

Webhooks

Entrega assíncrona de eventos

Browser Sandbox

Sessões de navegador gerenciadas para fluxos de trabalho interativos

Parse

Transforme PDFs, DOCX, XLSX, HTML e muito mais locais em Markdown ou JSON estruturado

Map

Descubra todas as URLs de um site

Crawl

Colete conteúdo de sites inteiros de forma recursiva

Recursos#

Referência da API

Documentação completa da API com exemplos interativos

SDKs

SDKs para Python, Node.js, CLI e da comunidade

Open Source

Hospede o Firecrawl na sua própria infraestrutura ou contribua com o projeto

Integrações

LangChain, LlamaIndex, OpenAI e mais