Introduction | Firecrawl

Pour les agents IA : Utilisez llms.txt pour obtenir un index complet de toute la documentation.

Pour commencer

Installer le CLI Firecrawl

Une seule commande installe le CLI Firecrawl, vous authentifie dans votre Browser et ajoute des skills à chaque agent de codage détecté.

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

Redémarrez votre agent de codage après la configuration afin qu’il puisse découvrir les nouveaux skills. Consultez Skills + CLI pour la configuration complète.

Configurer avec un agent

Fournissez à votre agent ce prompt de configuration Firecrawl.

Créez et testez directement

Obtenez votre clé d'API

Créez un compte gratuit pour un accès direct à l’API et des limites plus élevées

Essayez-le dans le Playground

Testez Firecrawl dans le navigateur sans écrire de code

Que peut faire Firecrawl ?

Recherche

Rechercher sur le web et obtenir le contenu complet des pages à partir des résultats

Scrape

Extraire le contenu de n’importe quelle URL en markdown, HTML ou JSON structuré

Interact

Continuer à travailler avec n’importe quelle page scrapée : cliquer, remplir des formulaires, extraire du contenu dynamique

Pourquoi Firecrawl ?

Sortie prête pour les LLM : Markdown propre, JSON structuré, captures d’écran, et plus encore.
Gère les aspects complexes : proxys, protections anti-bot, rendu JavaScript et contenu dynamique.
Fiable : conçu pour la production, avec une haute disponibilité et des résultats constants.
Rapide : des résultats en quelques secondes, optimisé pour un débit élevé.
MCP Server : connectez Firecrawl à n’importe quel outil d’IA via le Model Context Protocol.

Recherche

Effectuez une recherche sur le web et obtenez le contenu complet des pages à partir des résultats en un seul appel. Consultez la documentation de la fonctionnalité de recherche pour toutes les options.

from firecrawl import Firecrawl

firecrawl = Firecrawl(
  # Aucune clé API requise pour démarrer — ajoutez-en une pour des limites de débit plus élevées :
  # api_key="fc-YOUR-API-KEY",
)

results = firecrawl.search(
    query="firecrawl",
    limit=3,
)
print(results)

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({
  // Aucune clé API requise pour démarrer — ajoutez-en une pour des limites de débit plus élevées :
  // apiKey: "fc-YOUR-API-KEY",
});

const results = await firecrawl.search('firecrawl', {
  limit: 3,
  scrapeOptions: { formats: ['markdown'] }
});
console.log(results);

# Aucune clé API requise pour démarrer — ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour des limites de débit plus élevées :
curl -s -X POST "https://api.firecrawl.dev/v2/search" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "firecrawl",
    "limit": 3
  }'

# Rechercher sur le web
firecrawl search "firecrawl web scraping" --limit 5 --pretty

Réponse

Les SDK renverront directement l’objet data. cURL renverra la charge utile complète.

JSON

{
  "success": true,
  "data": {
    "web": [
      {
        "url": "https://www.firecrawl.dev/",
        "title": "Firecrawl - L'API de données web pour l'IA",
        "description": "L'API d'exploration, de scraping et de recherche pour l'IA. Conçue pour passer à l'échelle. Firecrawl met l'ensemble du web à la portée des agents et développeurs d'IA.",
        "position": 1
      },
      {
        "url": "https://github.com/firecrawl/firecrawl",
        "title": "mendableai/firecrawl : Transformez des sites entiers en contenus prêts pour les LLM… - GitHub",
        "description": "Firecrawl est un service d'API qui prend une URL, l'explore et la convertit en Markdown propre ou en données structurées.",
        "position": 2
      },
      ...
    ],
    "images": [
      {
        "title": "Guide de démarrage rapide | 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": "La startup de Y Combinator Firecrawl est prête à payer 1 M$ pour embaucher trois agents IA comme employés",
        "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-firecrawl-is-ready-to-pay-1m-to-hire-three-ai-agents-as-employees/",
        "snippet": "Elle a désormais publié trois nouvelles annonces sur le job board de YC pour « agents IA uniquement » et a réservé un budget total de 1 million de dollars pour y parvenir.",
        "date": "il y a 3 mois",
        "position": 1
      },
      ...
    ]
  }
}

Scrape

Extrayez n’importe quelle URL et obtenez son contenu en markdown, HTML ou d’autres formats. Consultez la documentation de la fonctionnalité Scrape pour toutes les options.

from firecrawl import Firecrawl

firecrawl = Firecrawl(
  # Aucune clé API requise pour démarrer — ajoutez-en une pour des limites de débit plus élevées :
  # api_key="fc-YOUR-API-KEY",
)

# Extraire le contenu d'un site :
doc = firecrawl.scrape("https://firecrawl.dev", formats=["markdown", "html"])
print(doc)

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({
  // Aucune clé API requise pour démarrer — ajoutez-en une pour des limites de débit plus élevées :
  // apiKey: "fc-YOUR-API-KEY",
});

// Récupérer le contenu d'un site :
const doc = await firecrawl.scrape('https://firecrawl.dev', { formats: ['markdown', 'html'] });
console.log(doc);

# Aucune clé API requise pour démarrer — ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour des limites de débit plus élevées :
curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://firecrawl.dev",
    "formats": ["markdown", "html"]
  }'

# Scrape a URL and get markdown
firecrawl https://firecrawl.dev

# Avec plusieurs formats (renvoie du JSON)
firecrawl https://firecrawl.dev --format markdown,html,links --pretty

Réponse

Les SDK vont renvoyer directement l’objet data. cURL renverra la charge utile exactement comme indiqué ci-dessous.

{
  "success": true,
  "data" : {
    "markdown": "Launch Week I est là ! [Découvrez notre sortie du Jour 2 🚀](https://www.firecrawl.dev/blog/launch-week-i-day-2-doubled-rate-limits)[💥 2 mois offerts...",
    "html": "<!DOCTYPE html><html lang=\"en\" class=\"light\" style=\"color-scheme: light;\"><body class=\"__variable_36bd41 __variable_d7dc5d font-inter ...",
    "metadata": {
      "title": "Accueil - Firecrawl",
      "description": "Firecrawl explore et convertit n'importe quel site web en markdown propre.",
      "language": "en",
      "keywords": "Firecrawl,Markdown,Données,Mendable,Langchain",
      "robots": "follow, index",
      "ogTitle": "Firecrawl",
      "ogDescription": "Transformez n'importe quel site web en données prêtes pour les 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"
    }
  }
}

Interact

Scrapez une page, puis continuez à travailler avec elle : cliquez sur des boutons, remplissez des formulaires, extrayez du contenu dynamique ou naviguez plus en profondeur. Décrivez ce que vous voulez en anglais courant ou écrivez du code pour un contrôle total. Consultez la documentation de la fonctionnalité Interact pour toutes les options.

from firecrawl import Firecrawl

app = Firecrawl(
  # Aucune clé API requise pour démarrer — ajoutez-en une pour des limites de débit plus élevées :
  # api_key="fc-YOUR-API-KEY",
)

# 1. Scraper la page d'accueil d'Amazon
result = app.scrape("https://www.amazon.com", formats=["markdown"])
scrape_id = result.metadata.scrape_id

# 2. Interagir — rechercher un produit et obtenir son prix
app.interact(scrape_id, prompt="Search for iPhone 16 Pro Max")
response = app.interact(scrape_id, prompt="Click on the first result and tell me the price")
print(response.output)

# 3. Arrêter la session
app.stop_interaction(scrape_id)

import { Firecrawl } from 'firecrawl';

const app = new Firecrawl({
  // Aucune clé API requise pour démarrer — ajoutez-en une pour des limites de débit plus élevées :
  // apiKey: 'fc-YOUR-API-KEY',
});

// 1. Scraper la page d'accueil d'Amazon
const result = await app.scrape('https://www.amazon.com', { formats: ['markdown'] });
const scrapeId = result.metadata?.scrapeId;

// 2. Interagir — rechercher un produit et obtenir son prix
await app.interact(scrapeId, { prompt: 'Search for iPhone 16 Pro Max' });
const response = await app.interact(scrapeId, { prompt: 'Click on the first result and tell me the price' });
console.log(response.output);

// 3. Arrêter la session
await app.stopInteraction(scrapeId);

# 1. Scraper la page d'accueil d'Amazon
# Aucune API key requise pour démarrer — ajoutez -H "Authorization: Bearer $FIRECRAWL_API_KEY" pour des limites de débit plus élevées :
RESPONSE=$(curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.amazon.com", "formats": ["markdown"]}')

SCRAPE_ID=$(echo $RESPONSE | jq -r '.data.metadata.scrapeId')

# 2. Interagir — rechercher un produit et obtenir son prix
curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Search for iPhone 16 Pro Max"}'

curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Click on the first result and tell me the price"}'

# 3. Arrêter la session
curl -s -X DELETE "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact"

# 1. Scrape la page d'accueil d'Amazon (l'ID de scrape est sauvegardé automatiquement)
firecrawl scrape https://www.amazon.com

# 2. Interagir — rechercher un produit et obtenir son prix
firecrawl interact "Search for iPhone 16 Pro Max"
firecrawl interact "Click on the first result and tell me the price"

# 3. Arrêter la session
firecrawl interact stop

Réponse

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
}

Plus de fonctionnalités

Agent

Collecter automatiquement des données web grâce à l’IA

Interact

Cliquer, remplir des formulaires, extraire du contenu dynamique

Webhooks

Envoi asynchrone d’événements

Browser Sandbox

Gérer des sessions de navigateur pour des workflows interactifs

Map

Découvrir toutes les URL d’un site web

Crawl

Collecter récursivement le contenu de sites entiers

Ressources

Référence de l’API

Documentation complète de l’API avec des exemples interactifs

SDKs

SDKs Python, Node.js, CLI et communautaires

Open Source

Hébergez Firecrawl vous-même ou contribuez au projet

Intégrations

LangChain, LlamaIndex, OpenAI et plus encore

​Pour commencer

​Installer le CLI Firecrawl

​Configurer avec un agent

​Créez et testez directement

Obtenez votre clé d'API

Essayez-le dans le Playground

​Que peut faire Firecrawl ?

Recherche

Scrape

Interact

​Pourquoi Firecrawl ?

​Recherche

​Scrape

​Interact

​Plus de fonctionnalités

Agent

Interact

Webhooks

Browser Sandbox

Map

Crawl

​Ressources

Référence de l’API

SDKs

Open Source

Intégrations

Pour commencer

Installer le CLI Firecrawl

Configurer avec un agent

Créez et testez directement

Que peut faire Firecrawl ?

Pourquoi Firecrawl ?

Recherche

Scrape

Interact

Plus de fonctionnalités

Ressources