Avvio rapido

This guide covers every Firecrawl feature:
- Iniziare — 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
- — Trova risposte sul web con l'intelligenza artificiale — 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 necessario: 5 minuti per ogni servizio
In questa guida troverete anche: Consigli professionali | Errori comuni | Risoluzione dei problemi | Prezzi | Alternative
Perché fidarsi di questa guida
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
Prima di utilizzare qualsiasi funzionalità, completa questa configurazione iniziale.
Ci vogliono circa 3 minuti.
Prima di iniziare, guarda questa breve panoramica:
Ora analizziamo passo passo ciascuna fase.
Passaggio 1: crea il tuo account
Go to the Firecrawl website at https://www.firecrawl.dev.
Click “Sign Up” to open a firecrawl account on the free plan.
Inserisci il tuo indirizzo email e crea una password.
✓ Punto di controllo: Controlla il tuo posta in arrivo per ricevere un'e-mail di conferma.
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 sicurezza.
Ecco come si presenta la dashboard:

✓ Punto di controllo: 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.
✅ Fatto: 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.
Ecco come usarlo passo dopo passo.
Ora analizziamo ogni passaggio.
Passaggio 1: Ottieni la tua chiave 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.
Ecco come si presenta:

✓ Punto di controllo: 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 testo, stripped of junk html tags.
✅ Risultato: You turned one of the web pages into structured web data with a single api.
💡 Consiglio da professionista: 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.
Ecco come usarlo passo dopo passo.
Ora analizziamo ogni passaggio.
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.
Ecco come si presenta:

✓ Punto di controllo: You should see scraped pages from across the site building into web data.
Passaggio 3: Esportare i risultati
Collect every page as markdown or structured json for your data pipelines.
✅ Risultato: You captured an entire site, even complex websites with dynamic content.
💡 Consiglio da professionista: Firecrawl uses batch processing and concurrent browsers, so large crawl operations stay fast.
How to Use Firecrawl Search Engine
Ricerca 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.
Ecco come usarlo passo dopo passo.
Ora analizziamo ogni passaggio.
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.
Passaggio 2: Scegliere il formato di output
Ask for markdown format or structured json for each result.
Every result arrives as clean data, not noisy raw html.
Ecco come si presenta:

✓ Punto di controllo: You should see ranked web pages returned as structured web data.
Step 3: Pipe Into Your App
Feed the structured data into assistenti IA or ai workflows.
✅ Risultato: You added live web content to your ai applications in a single api call.
💡 Consiglio da professionista: 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.
Ecco come usarlo passo dopo passo.
Ora analizziamo ogni passaggio.
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.
Ecco come si presenta:

✓ Punto di controllo: 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.
✅ Risultato: You mapped the whole site, ready for targeted web scraping.
💡 Consiglio da professionista: Map first on dynamic websites and web apps to avoid wasting credits on pages you do not need.
How to Use Firecrawl Extractor
Estrarre lets you extract structured data from any page using natural language prompts.
Extract uses ai powered parsing to pull exactly the fields you describe.
Ecco come usarlo passo dopo passo.
Ora analizziamo ogni passaggio.
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.
Ecco come si presenta:

✓ Punto di controllo: 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.
✅ Risultato: You replaced fragile scrapers with one extract call and less data cleaning.
💡 Consiglio da professionista: 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.
Scorciatoie da tastiera
| Azione | Scorciatoia |
|---|---|
| Run scrape in playground | Ctrl + Invio |
| Copy api key | Ctrl + C |
| Open docs | Ctrl + K |
| Switch output format | Tab |
Funzionalità nascoste che la maggior parte delle persone non nota
- 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
❌ Sbagliato: Pasting your api key directly into shared code or a public repo.
✅ A destra: Load the key from an environment variable so it stays private.
Mistake #2: Crawling before mapping
❌ Sbagliato: Crawling entire websites blindly and burning credits on junk pages.
✅ A destra: Run url discovery with map first, then crawl only the pages you need.
Mistake #3: Parsing raw html yourself
❌ Sbagliato: Writing brittle rules to clean raw html and strip html tags by hand.
✅ A destra: 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.
Aggiustare: 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.
Aggiustare: 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.
Aggiustare: Slow batch operations or upgrade for more concurrent browsers.
📌 Nota: If none of these fix your issue, contact Firecrawl support.
Cos'è 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.
Guarda questa breve panoramica:
Include le seguenti caratteristiche principali:
- Raschiare: Extract data from single web pages as markdown format or structured json.
- Strisciare: Crawl entire websites and follow links without a sitemap.
- Ricerca: Search the web and return clean data from news websites and review sites.
- Mappa: 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.
Per una recensione completa, consulta la nostra Firecrawl review.

Prezzi per il percorso a piedi
Here’s what Firecrawl costs in 2026:
| Piano | Prezzo | Ideale per |
|---|---|---|
| Gratuito | Gratuito | Testing scrape and crawl on a few pages |
| Hobby | $ 16/mese | Solo developers and small data pipelines |
| Standard | $83/mese | Teams running regular web crawling jobs |
| Crescita | $ 333/mese | High-volume market research and monitoring |
Prova gratuita: Yes — the free plan lets you scrape a limited number of pages.
Garanzia di rimborso: No formal guarantee, but you can downgrade anytime.

💰 Miglior rapporto qualità-prezzo: Standard — best balance of credits and concurrent browsers for most teams.
Firecrawl contro alternative
How does Firecrawl compare? Here’s the competitive landscape:
| Attrezzo | Ideale per | Prezzo | Valutazione |
|---|---|---|---|
| Firecrawl | AI-ready clean data | 16 dollari al mese | ⭐ 3,5 |
| Apify | Prebuilt actors | $49/mese | ⭐ 4,5 |
| Dati brillanti | Proxy scale | $ Custom | ⭐ 4.6 |
| Crawl4AI | Codice sorgente aperto | Gratuito | ⭐ 4.4 |
| Scrapy | Python control | Gratuito | ⭐ 4,5 |
| ScrapeGraphAI | LLM graph scraping | $20/mese | ⭐ 4.3 |
Scelte rapide:
- Il migliore in assoluto: Firecrawl — cleanest llm ready data from a single api.
- Miglior budget: Crawl4AI — free and open source for hands-on data scientists.
- Ideale per principianti: Firecrawl — natural language prompts hide the hard parts.
- Best for proxy scale: Bright Data — huge proxy pool for complex websites.
🎯 Firecrawl Alternatives
Cerchi alternative a Firecrawl? Ecco le migliori opzioni:
- 🚀 Apify: Marketplace of prebuilt actors for web scraping, good when you want ready-made scrapers over a single api.
- 🏢 Dati brillanti: 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.
- 🔧 Scarso: 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.
Per l'elenco completo, consultare il nostro Firecrawl alternatives guida.
⚔️ Confronto tra Firecrawl
Ecco come Firecrawl si confronta con ciascun concorrente:
- Firecrawl contro Apify: Firecrawl wins on clean, llm ready output; Apify wins on its library of prebuilt scrapers.
- Firecrawl contro Bright Data: Bright Data wins on proxy scale; Firecrawl wins on simpler structured data extraction.
- Firecrawl contro Crawl4AI: Crawl4AI wins on price and self-hosting; Firecrawl wins on managed rate limits and reliability.
- Firecrawl contro Scrapy: Scrapy wins on low-level control; Firecrawl wins on speed and zero proxy setup.
- Firecrawl contro 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
- ✅ API di supporto
- ✅ Map
- ✅ Extract
Passo successivo: Scegli una funzionalità e provala subito.
Most people start with Scrape.
Ci vogliono meno di 5 minuti.
Domande frequenti
A cosa serve 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.
È possibile utilizzare 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.













