firecrawl/firecrawl-dashboard-reporting

Que fait firecrawl-dashboard-reporting ?

Récupérez des métriques à partir de tableaux de bord analytiques et d'outils web internes avec le navigateur Firecrawl. Utilisez cette compétence lorsque l'utilisateur a besoin de rapports de tableau de bord, de synthèses de métriques multi-plateformes, d'extraction d'analyses authentifiées, de rapports par plage de dates ou de métriques structurées provenant de tableaux de bord web.

Fonctionnement

La compétence utilise l'API Firecrawl pour lancer un navigateur sans tête, naviguer vers l'URL du tableau de bord, et extraire les données affichées. Elle gère l'authentification si nécessaire (via des identifiants, cookies ou jetons), et peut parcourir plusieurs pages pour collecter des données historiques.

Utilisation

# Exemple : extraire des métriques d'un tableau de bord public
curl -X POST https://api.firecrawl.dev/v1/scrape \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer VOTRE_CLE_API' \
  -d '{
    "url": "https://exemple.com/tableau-de-bord",
    "formats": ["json"],
    "waitFor": 5000,
    "actions": [
      {"type": "click", "selector": "#bouton-rapport"},
      {"type": "wait", "milliseconds": 2000}
    ]
  }'

Plateformes supportées

• Google Analytics 4
• Mixpanel
• Amplitude
• Tableaux de bord internes (authentification personnalisée)
• Outils BI comme Metabase, Superset

Configuration

1. Obtenez une clé API Firecrawl depuis firecrawl.dev
2. Définissez la variable d'environnement FIRECRAWL_API_KEY
3. Utilisez l'URL du tableau de bord cible comme paramètre d'entrée

Options avancées

• waitFor : temps d'attente en millisecondes pour le chargement complet du tableau de bord
• actions : séquence d'actions (clic, attente, saisie) pour interagir avec les éléments dynamiques
• cookies : tableau de cookies pour les sessions authentifiées
• extractRules : sélecteurs CSS ou XPath personnalisés pour extraire des métriques spécifiques

Exemple d'extraction structurée

{
  "visiteurs_actifs": 15342,
  "taux_conversion": 3.24,
  "revenu_journalier": 12500.75,
  "pages_vues": 98765,
  "periode": {
    "debut": "2024-01-01",
    "fin": "2024-01-31"
  }
}

Dépannage

• Erreur 401 : vérifiez que FIRECRAWL_API_KEY est correctement définie
• Données manquantes : augmentez la valeur waitFor pour laisser le temps au tableau de bord de s'afficher
• Problèmes d'authentification : fournissez explicitement les cookies ou utilisez l'authentification par formulaire