Que fait firecrawl-build-search ?
Intégrez Firecrawl /search dans votre code produit et vos workflows d'agents. Utilisez-le lorsqu'une application a besoin de découvrir avant d'extraire, lorsque la fonctionnalité commence par une requête plutôt qu'une URL, ou lorsque le système doit effectuer une recherche sur le web et, éventuellement, enrichir le contenu des résultats.
Vue d'ensemble
Cette compétence vous permet de déclencher une recherche web via l'API Firecrawl et d'obtenir soit une liste de résultats (URLs, titres, descriptions), soit des résultats enrichis avec le contenu complet de chaque page. C'est l'équivalent d'un moteur de recherche programmable, sans avoir à gérer les complexités du scraping ou de l'indexation.
Cas d'usage typiques
- Découverte de contenu : Trouver des articles, produits, ou pages web à partir d'une requête en langage naturel.
- Veille concurrentielle : Surveiller régulièrement les mentions d'une marque ou d'un sujet.
- Agents de recherche : Permettre à un agent IA de chercher des informations actualisées avant de répondre.
- Workflows ETL : Alimenter un pipeline de données avec des résultats de recherche web structurés.
Plateformes supportées
- Cloud (API Firecrawl hébergée)
- Self-hosted (instance Firecrawl locale ou privée)
Comment ça marche
- L'utilisateur ou l'agent fournit une requête (ex: "meilleures pratiques Rust 2025").
- La compétence appelle l'endpoint
/searchde Firecrawl avec cette requête. - Les résultats sont retournés sous forme de liste de résultats bruts (titre, URL, snippet).
- Si l'option
hydrateest activée, chaque résultat est enrichi avec son contenu textuel extrait.
Paramètres clés
| Paramètre | Type | Description |
|---|---|---|
query | string | La requête de recherche (obligatoire) |
hydrate | boolean | Si true, enrichit chaque résultat avec le contenu complet de la page |
limit | integer | Nombre maximum de résultats à retourner (défaut: 10) |
filter | object | Filtres facultatifs (domaines, dates, etc.) |
Exemple d'utilisation
# Appel simple à la compétence
resultat = search_web(query="framework web 2025", hydrate=False, limit=5)
# Les résultats sont déjà structurés
for item in resultat:
print(item["url"], item["title"])
Intégration avec un agent
const response = await agent.runTool('firecrawl-build-search', {
query: 'accessibility best practices 2025',
hydrate: true
});
// response contient une liste d'objets {url, title, content, ...}
Considérations
- Limites de débit : Respectez les quotas de l'API si vous utilisez le cloud.
- Coût : L'hydratation consomme plus de crédits que la recherche seule.
- Qualité des résultats : La qualité dépend du moteur sous-jacent ; testez avec des requêtes réelles.
Ressources
Note : Cette compétence est conçue pour être utilisée soit directement depuis votre code, soit comme outil dans un workflow d'agent IA.