- Fraîcheur → Ce contenu est-il récent ou s’agit-il d’une copie réutilisée à partir du cache de Firecrawl ? Contrôlée par
maxAge. - Activité → L’élément sous-jacent existe-t-il toujours et est-il encore actif ? Votre application le détermine à partir des éléments disponibles.
maxAge et fournit une liste de contrôle ainsi qu’un exemple détaillé pour les actions sensibles à la fraîcheur.
Comparaison rapide
Le compromis fraîcheur/latence (maxAge)
maxAge correspond à l’âge maximal, en millisecondes, d’une copie en cache que Firecrawl peut renvoyer au lieu de récupérer à nouveau la page.
- Omettre
maxAge: Firecrawl peut renvoyer du contenu récemment mis en cache. La durée par défaut est de 2 jours ; Firecrawl peut utiliser une durée différente pour certains sites. - Définir
maxAge: 0: Firecrawl ignore le cache pour cette requête et récupère la page. Vous échangez ainsi latence et fiabilité contre des données plus fraîches.
maxAge: 0 que pour les lectures où des données obsolètes entraîneraient une décision erronée ou coûteuse — cela ne change pas le coût de la page en crédits.
metadata.cacheState est renvoyé lorsque Firecrawl a pris en compte son cache pour la requête ; c’est donc un indicateur utile lors du réglage de maxAge. Il ne fait pas partie d’une réponse avec maxAge: 0, car cette requête ignore entièrement le cache.
Pour en savoir plus sur le fonctionnement du cache, les valeurs courantes de maxAge, les règles de correspondance des accès au cache et les options de requête qui contournent automatiquement le cache, consultez Scraping plus rapide.
Cas d’application de maxAge
Pour récupérer une version à jour d’une page trouvée via
/search, scrapez de nouveau cette URL avec /scrape et maxAge: 0.
La fraîcheur ne garantit pas l’activité
maxAge: 0, le résultat indique uniquement ce que la page a renvoyé lors de cette récupération. Une page peut renvoyer un code HTTP 200 avec du contenu tout en reflétant un état obsolète, indisponible ou modifié d’une autre manière.
Ainsi, ni le code d’état ni la présence de contenu ne permettent d’établir l’activité. L’activité est une conclusion que votre application tire d’éléments propres à chaque source.
Liste de contrôle pour les actions sensibles à la fraîcheur des données
- Utilisez
maxAge: 0pour la récupération finale afin que la réponse ne soit pas servie depuis le cache. - Ne considérez pas un code HTTP 200 ou un contenu non vide comme la preuve d’activité.
- Examinez le contenu rendu et les indices de redirection.
metadata.sourceURLest l’URL demandée ;metadata.urlest l’URL que le moteur indique pour la réponse. Lorsque les deux diffèrent, cela peut indiquer une redirection vers une autre ressource. Des valeurs identiques ne prouvent pas qu’aucune redirection n’a eu lieu. - Privilégiez les API ou les identifiants propres à la source lorsqu’ils sont disponibles : ils exposent souvent un état explicite qu’une page rendue masque.
- Considérez les indices non concluants comme
unknownet arrêtez-vous avant l’étape coûteuse ou irréversible, plutôt que de supposer que la ressource est active.
Exemple détaillé : collecter les éléments de preuve de la page actuelle
unknown.
Recommandations par scénario
Points clés
-
La fraîcheur et l’activité répondent à deux questions distinctes.
maxAgecontrôle la fraîcheur ; l’activité est une décision que vous prenez sur la base d’éléments probants. - Un code HTTP 200 assorti de contenu ne prouve pas que l’état représenté est à jour.
-
Pour les actions sensibles à la fraîcheur, utilisez
maxAge: 0et suivez la liste de vérification. Inspectez le contenu rendu, comparezmetadata.urlàmetadata.sourceURLafin de repérer d’éventuelles redirections, et privilégiez les API propres à la source. -
Traitez les éléments non concluants comme
unknown. Un scrape seul ne doit jamais faire passer un objet à l’étatactive; arrêtez-vous avant d’engager des étapes coûteuses ou irréversibles. - Firecrawl ne dispose pas de champ d’activité. Votre application effectue cette détermination selon ses propres critères métier.

