Início rápido
This guide covers every Firecrawl feature:
- Começando — Create a firecrawl account and set your api key
- How to Use Scrape — Pull llm ready data from single web pages
- How to Use Crawl — Crawl entire websites and follow every link
- Como usar a pesquisa — Search the web for real time web data
- How to Use Map — Run url discovery across individual pages
- How to Use Extract — Extract structured data with natural language prompts
Tempo necessário: 5 minutos por filme
Neste guia também: Dicas profissionais | Erros comuns | Solução de problemas | Preços | Alternativas
Por que confiar neste guia?
I have used Firecrawl for over a year and tested every feature covered here.
This tutorial on how to use Firecrawl comes from real hands-on web scraping work.
Firecrawl is an ai powered web crawler that turns websites into clean, llm ready data.
But most users only scratch the surface of what this versatile tool can do.
This guide shows you how to use every major feature, step by step, with screenshots.
Firecrawl Tutorial
This complete Firecrawl tutorial walks you through every feature, from your first api key to advanced batch operations that make you a power user.
Firecrawl
Turn any website into clean, structured data with a single api. Firecrawl handles javascript rendering, rate limits, and url discovery so you get llm ready data fast. Start on the free plan — no credit card needed.
Getting Started with Firecrawl
Antes de usar qualquer recurso, conclua esta configuração única.
Leva cerca de 3 minutos.
Veja primeiro esta breve visão geral:
Agora vamos analisar cada etapa.
Passo 1: Crie sua conta
Go to the Firecrawl website at https://www.firecrawl.dev.
Click “Sign Up” to open a firecrawl account on the free plan.
Insira seu e-mail e crie uma senha.
✓ Ponto de verificação: Verifique o seu caixa de entrada para um e-mail de confirmação.
Step 2: Install and Set Your API Key
Run pip install firecrawl-py to add the api service to your project.
Copy your api key, then save it as an environment variable for segurança.
Eis como o painel de controle se parece:
✓ Ponto de verificação: You should see the main dashboard with your usage and api key.
Step 3: Make Your First Call
Import the FirecrawlApp class and create a firecrawl instance with your key.
Every request hits the base endpoint at https://api.firecrawl.dev/v2.
✅ Concluído: You’re ready to scrape, crawl, search, map, and extract data.
How to Use Firecrawl Scraper
Scrape lets you pull clean, llm ready data from a single page with one single api call.
Scrape mode targets individual pages and is ideal for extracting specific details fast.
Veja como usá-lo passo a passo.
Agora vamos analisar cada etapa.
Passo 1: Obtenha sua chave de API
Create a firecrawl account, then copy your api key from the dashboard.
Store it as an environment variable so your api key stays out of your raw code.
Step 2: Call the Scrape Endpoint
Pass a single url to the .scrape_url() method on your firecrawl instance.
You can request markdown format, raw html, or structured json as the output.
Eis como isso se parece:
✓ Ponto de verificação: You should see clean markdown for the current page, ready for ai applications.
Step 3: Read the Clean Output
Firecrawl returns clean data with readable texto, stripped of junk html tags.
✅ Resultado: You turned one of the web pages into structured web data with a single api.
💡 Dica profissional: Set the max_age parameter to cache results and skip re-scraping a page that has not changed.
How to Use Firecrawl Crawler
Crawl lets you crawl entire websites and follow links automatically without a sitemap.
Crawl mode lets you crawl websites across multiple pages and collect every reachable page.
Veja como usá-lo passo a passo.
Agora vamos analisar cada etapa.
Step 1: Point at a Root URL
Give the crawl endpoint a starting url such as https://example.com.
Firecrawl handles web crawling through links and follows pages on its own.
Step 2: Start the Crawl Job
Launch the crawl job and grab the returned job id to track progress.
Use the job id to poll status and pull crawled data as each page finishes.
Eis como isso se parece:
✓ Ponto de verificação: You should see scraped pages from across the site building into web data.
Etapa 3: Exportar os resultados
Collect every page as markdown or structured json for your data pipelines.
✅ Resultado: You captured an entire site, even complex websites with dynamic content.
💡 Dica profissional: Firecrawl uses batch processing and concurrent browsers, so large crawl operations stay fast.
How to Use Firecrawl Search Engine
Procurar lets you search the web and return clean results you can feed straight into ai agents.
Search lets you query the web and pull back real time web data as readable text.
Veja como usá-lo passo a passo.
Agora vamos analisar cada etapa.
Step 1: Send a Query
Call the search endpoint with a plain natural language query.
Firecrawl can search the web across news websites, job boards, and review sites.
Etapa 2: Escolha o formato de saída
Ask for markdown format or structured json for each result.
Every result arrives as clean data, not noisy raw html.
Eis como isso se parece:
✓ Ponto de verificação: You should see ranked web pages returned as structured web data.
Step 3: Pipe Into Your App
Feed the structured data into assistentes de IA or ai workflows.
✅ Resultado: You added live web content to your ai applications in a single api call.
💡 Dica profissional: Pair search with extract to gather news articles for market research or competitive intelligence.
How to Use Firecrawl Advanced Map
Map lets you run url discovery and turn one domain into a full map of individual pages.
Map mode retrieves every url on a site quickly for fast url discovery.
Veja como usá-lo passo a passo.
Agora vamos analisar cada etapa.
Step 1: Submit the Domain
Pass a single root url to the map endpoint.
Firecrawl returns every link without needing a sitemap.
Step 2: Review the URL List
Scan the returned individual pages before you scrape them.
Save the list to a csv file to plan your data extraction.
Eis como isso se parece:
✓ Ponto de verificação: You should see a full sitemap of web pages from one single url.
Step 3: Select What to Scrape
Pick the pages you want, then send them to scrape or crawl.
✅ Resultado: You mapped the whole site, ready for targeted web scraping.
💡 Dica profissional: Map first on dynamic websites and web apps to avoid wasting credits on pages you do not need.
How to Use Firecrawl Extractor
Extrair lets you extract structured data from any page using natural language prompts.
Extract uses ai powered parsing to pull exactly the fields you describe.
Veja como usá-lo passo a passo.
Agora vamos analisar cada etapa.
Step 1: Define a Schema
Write a Pydantic model with: from pydantic import BaseModel.
Schema based extraction tells Firecrawl which fields to return as structured json.
Step 2: Describe the Data
Add natural language prompts for fields a schema cannot capture.
This is how you extract data from web pages without writing parsing rules.
Eis como isso se parece:
✓ Ponto de verificação: You should see tidy structured data instead of messy html tags.
Step 3: Receive Structured JSON
Firecrawl returns clean structured json ready for training data.
✅ Resultado: You replaced fragile scrapers with one extract call and less data cleaning.
💡 Dica profissional: Use only_main_content, include_tags, and exclude_tags to keep the extracted web data focused.
Firecrawl Pro Tips and Shortcuts
After testing Firecrawl for over a year, here are my best tips for cleaner data extraction.
Atalhos de teclado
| Ação | Atalho |
|---|---|
| Run scrape in playground | Ctrl + Enter |
| Copy api key | Ctrl + C |
| Open docs | Ctrl + K |
| Switch output format | Aba |
Características ocultas que a maioria das pessoas não percebe
- max_age caching: Reuse recent crawled data for faster, cheaper repeat scraping.
- Browser actions: Click, scroll, and type to reach content behind javascript rendering.
- Async batching: Process thousands of urls with batch processing without blocking your web apps.
Firecrawl Common Mistakes to Avoid
Mistake #1: Hardcoding your API key
❌ Errado: Pasting your api key directly into shared code or a public repo.
✅ Direita: Load the key from an environment variable so it stays private.
Mistake #2: Crawling before mapping
❌ Errado: Crawling entire websites blindly and burning credits on junk pages.
✅ Direita: Run url discovery with map first, then crawl only the pages you need.
Mistake #3: Parsing raw html yourself
❌ Errado: Writing brittle rules to clean raw html and strip html tags by hand.
✅ Direita: Use schema based extraction to get clean structured json directly.
Firecrawl Troubleshooting
Problem: 401 unauthorized errors
Causa: Your api key is missing or not loaded from the environment variable.
Consertar: Re-export the key, then recreate your firecrawl instance and retry.
Problem: Timeout errors on complex websites
Causa: Heavy javascript rendering or dynamic content takes longer to load.
Consertar: Add a wait action so the current page finishes loading before capture.
Problem: Hitting rate limits
Causa: Too many requests at once on the free plan or a lower tier.
Consertar: Slow batch operations or upgrade for more concurrent browsers.
📌 Observação: If none of these fix your issue, contact Firecrawl support.
O que é Firecrawl?
Firecrawl is an ai powered web scraping tool that turns websites into clean, structured data.
Think of it as a web crawler that hands ai agents readable text instead of messy raw html.
Firecrawl was developed by Mendable.ai to reduce token waste for ai applications.
Veja esta breve visão geral:
Inclui estas características principais:
- Raspar: Extract data from single web pages as markdown format or structured json.
- Arrastar: Crawl entire websites and follow links without a sitemap.
- Procurar: Search the web and return clean data from news websites and review sites.
- Mapa: Fast url discovery that turns one domain into a full sitemap.
- Extract: Pull structured web data using natural language prompts and Pydantic schemas.
Firecrawl beats traditional web scraping by handling proxies, rate limits, and javascript rendering for you.
Unlike traditional tools that need Selenium, it serves data scientists and developers through one api service.
Para uma análise completa, consulte nosso artigo. Firecrawl review.
Preços do Firecrawl
Here’s what Firecrawl costs in 2026:
| Plano | Preço | Ideal para |
|---|---|---|
| Livre | Livre | Testing scrape and crawl on a few pages |
| Passatempo | US$ 16/mês | Solo developers and small data pipelines |
| Padrão | US$ 83/mês | Teams running regular web crawling jobs |
| Crescimento | $ 333/mês | High-volume market research and monitoring |
Teste grátis: Yes — the free plan lets you scrape a limited number of pages.
Garantia de reembolso: No formal guarantee, but you can downgrade anytime.
💰 Melhor custo-benefício: Standard — best balance of credits and concurrent browsers for most teams.
Firecrawl vs Alternativas
How does Firecrawl compare? Here’s the competitive landscape:
| Ferramenta | Ideal para | Preço | Avaliação |
|---|---|---|---|
| Firecrawl | AI-ready clean data | US$ 16/mês | ⭐ 3,5 |
| Apify | Prebuilt actors | US$ 49/mês | ⭐ 4,5 |
| Dados brilhantes | Proxy scale | $ Custom | ⭐ 4,6 |
| Crawl4AI | Código aberto | Livre | ⭐ 4,4 |
| Scrapy | Python control | Livre | ⭐ 4,5 |
| ScrapeGraphAI | LLM graph scraping | US$ 20/mês | ⭐ 4,3 |
Escolhas rápidas:
- Melhor no geral: Firecrawl — cleanest llm ready data from a single api.
- Melhor orçamento: Crawl4AI — free and open source for hands-on data scientists.
- Ideal para iniciantes: Firecrawl — natural language prompts hide the hard parts.
- Best for proxy scale: Bright Data — huge proxy pool for complex websites.
🎯 Firecrawl Alternatives
Procurando alternativas ao Firecrawl? Aqui estão as melhores opções:
- 🚀 Apify: Marketplace of prebuilt actors for web scraping, good when you want ready-made scrapers over a single api.
- 🏢 Dados brilhantes: Enterprise proxy network for huge crawl jobs and content monitoring at scale across dynamic websites.
- 💰 Crawl4AI: Free, open source crawler that outputs llm ready data, ideal for budget ai workflows and local runs.
- 🔧 Scrapy: Battle-tested Python framework giving developers full control over crawling, parsing, and data pipelines.
- 🧠 ScrapeGraphAI: Graph-based, ai powered extraction that maps page structure for schema based extraction of structured data.
Para ver a lista completa, consulte nosso Firecrawl alternatives guia.
⚔️ Comparação do Firecrawl
Veja como o Firecrawl se compara a cada concorrente:
- Firecrawl vs Apify: Firecrawl wins on clean, llm ready output; Apify wins on its library of prebuilt scrapers.
- Firecrawl vs Bright Data: Bright Data wins on proxy scale; Firecrawl wins on simpler structured data extraction.
- Firecrawl vs Crawl4AI: Crawl4AI wins on price and self-hosting; Firecrawl wins on managed rate limits and reliability.
- Firecrawl vs Scrapy: Scrapy wins on low-level control; Firecrawl wins on speed and zero proxy setup.
- Firecrawl vs ScrapeGraphAI: Both are ai powered; Firecrawl wins on crawl coverage, ScrapeGraphAI on graph logic.
Start Using Firecrawl Now
You learned how to use every major Firecrawl feature:
- ✅ Scrape
- ✅ Crawl
- ✅ Pesquisar
- ✅ Map
- ✅ Extract
Próximo passo: Escolha uma funcionalidade e experimente agora mesmo.
Most people start with Scrape.
Leva menos de 5 minutos.
Perguntas frequentes
Para que serve o Firecrawl?
Firecrawl is an ai powered web scraping tool. It turns web pages into clean, llm ready data for ai agents, rag systems, market research, and price monitoring.
É possível usar o Firecrawl gratuitamente?
Yes. The free plan lets you scrape a limited number of pages with your api key, so you can test scrape, crawl, and extract before paying.
How do I install Firecrawl?
Run pip install firecrawl-py, then set your api key as an environment variable and create a firecrawl instance to start your first single api call.
How is Firecrawl different from traditional scraping?
Traditional web scraping needs Selenium and manual proxy setup. Firecrawl handles javascript rendering, rate limits, and clean data automatically through one api service.
Can Firecrawl extract structured data?
Yes. Use natural language prompts or a Pydantic schema for schema based extraction, and Firecrawl returns structured json instead of raw html.
English 
Spanish 
Chinese 
German 
French 
Arabic 
Russian 
Portuguese 
Japanese 
Korean 
Italian 
Turkish 
Dutch 
Polish 
Indonesian 
Thai 
Vietnamese 