MCP Tools
Extraction web
Extrayez des pages rendues en JavaScript en markdown propre, listez les URL d'un site ou explorez un site de documentation entier. Propulsé par un navigateur headless.
Lisez des pages web qu'un fetch classique ne peut pas traiter. Tous les outils renvoient du markdown propre — aucun parsing HTML dans votre Skill.
Ce que vous pouvez faire
- Extraire une page — SPA rendues en JavaScript, pages protégées anti-bot, extraction du contenu principal.
- Cartographier un site — lister toutes les URL indexées d'un domaine, avec filtre optionnel par mot-clé.
- Explorer une section — extraire récursivement un site de documentation ou une section, page par page.
Limites (à lire d'abord)
- Préférez le fetch web intégré pour les pages simples. Les pages statiques, articles et documentations publiques fonctionnent très bien avec le fetch intégré et gratuit de l'agent. N'utilisez ces outils que si la page est rendue en JavaScript, bloque les fetchs classiques, ou si vous avez besoin d'une exploration en masse.
- Le
limitd'un crawl est le plafond de facturation. Un crawl est mesuré par sa limite de pages à la soumission — réglez-la selon la tâche (10 par défaut, max 50), sans la maximiser par habitude. - Les pages longues sont tronquées. Une extraction renvoie jusqu'à ~50k caractères ; un crawl terminé affiche les 3 premières pages (~10k caractères chacune) et liste le reste par URL. Pour lire une page listée en entier, extrayez-la individuellement — servie depuis le cache, rapide, au coût d'une page.
Outils
| Outil | Entrée | Renvoie |
|---|---|---|
firecrawl_scrape | url, only_main_content? | Titre, URL source, code de statut, corps en markdown |
firecrawl_map | url, search?, limit? | Liste des URL du site (100 par défaut, max 500) |
firecrawl_start_crawl | url, limit?, include_paths?, exclude_paths? | Un crawl_id immédiat — le crawl s'exécute en arrière-plan |
firecrawl_get_crawl_status | crawl_id | Progression pendant le crawl ; index des pages + premières pages une fois terminé |
firecrawl_start_crawl : limit va de 1 à 50 (10 par défaut) et sert aussi de plafond de facturation ; include_paths / exclude_paths acceptent des motifs comme ["/guide/*"].
Le crawl est asynchrone, en deux étapes
Comme la génération vidéo : soumettez le job (recevez un crawl_id), puis interrogez firecrawl_get_crawl_status toutes les quelques secondes jusqu'à completed. Un crawl de 10 pages se termine généralement en moins d'une minute.
L'utiliser dans une Skill
- Étudier un site de docs :
firecrawl_mapavec un mot-clésearchpour trouver les pages pertinentes →firecrawl_scrapesur les deux ou trois qui comptent. - Lire une section en masse :
firecrawl_start_crawlavecinclude_paths: ["/guide/*"]et unlimitbien dimensionné → interroger le statut → lire l'index et le contenu inline → extraire individuellement ce dont vous avez besoin en entier. - Une page que le fetch intégré ne peut pas lire :
firecrawl_scrapeavec l'URL — le navigateur headless rend le JavaScript et extrait le contenu principal.
