FastAPI - Firecrawl Docs

Prérequis#

Python 3.8+
Une clé API Firecrawl — obtenez-en une gratuitement

Configuration#

pip install fastapi uvicorn firecrawl-py

Ajoutez votre clé API à .env :

FIRECRAWL_API_KEY=fc-YOUR-API-KEY

Créez l’API#

Créez main.py:

import osfrom fastapi import FastAPIfrom pydantic import BaseModelfrom firecrawl import Firecrawlapp = FastAPI()firecrawl = Firecrawl(api_key=os.environ["FIRECRAWL_API_KEY"])class SearchRequest(BaseModel):    query: str    limit: int = 5class ScrapeRequest(BaseModel):    url: strclass InteractRequest(BaseModel):    scrape_id: str    prompt: str@app.post("/search")async def search(req: SearchRequest):    results = firecrawl.search(req.query, limit=req.limit)    return [{"title": r.title, "url": r.url} for r in results.web]@app.post("/scrape")async def scrape(req: ScrapeRequest):    result = firecrawl.scrape(req.url)    return {"markdown": result.markdown, "metadata": result.metadata}@app.post("/interact/start")async def interact_start(req: ScrapeRequest):    result = firecrawl.scrape(req.url, formats=["markdown"])    return {"scrape_id": result.metadata.scrape_id}@app.post("/interact")async def interact(req: InteractRequest):    response = firecrawl.interact(req.scrape_id, prompt=req.prompt)    return {"output": response.output}@app.post("/interact/stop")async def interact_stop(req: InteractRequest):    firecrawl.stop_interaction(req.scrape_id)    return {"status": "stopped"}

Lancez-le#

uvicorn main:app --reload

Essayez-le#

# Rechercher sur le webcurl -X POST http://localhost:8000/search \  -H "Content-Type: application/json" \  -d '{"query": "firecrawl web scraping", "limit": 5}'# Scraper une pagecurl -X POST http://localhost:8000/scrape \  -H "Content-Type: application/json" \  -d '{"url": "https://example.com"}'# Démarrer une session interactive, puis envoyer des promptscurl -X POST http://localhost:8000/interact/start \  -H "Content-Type: application/json" \  -d '{"url": "https://www.amazon.com"}'

FastAPI génère automatiquement une documentation interactive à http://localhost:8000/docs.

Variante asynchrone#

Pour une meilleure concurrence en cas de forte charge, utilisez AsyncFirecrawl :

from firecrawl import AsyncFirecrawlasync_firecrawl = AsyncFirecrawl(api_key=os.environ["FIRECRAWL_API_KEY"])@app.post("/scrape-async")async def scrape_async(req: ScrapeRequest):    result = await async_firecrawl.scrape(req.url)    return {"markdown": result.markdown}

Prochaines étapes#

Documentation Scrape

Toutes les options de scrape, y compris les formats, les actions et les proxies

Documentation Search

Recherchez sur le Web et obtenez le contenu complet des pages

Documentation Interact

Cliquez, remplissez des formulaires et extrayez du contenu dynamique

Référence du SDK Python

Référence complète du SDK, avec crawl, cartographie, async, etc.