Oncrawl KPI Reader

Le node Oncrawl KPI Reader lit un ensemble fixe de KPI de crawl validés depuis un ou plusieurs crawls Oncrawl terminés, prêts pour l'analyse ou le reporting.

Que fait le node Oncrawl KPI Reader ?#

Le node Oncrawl KPI Reader lit un ensemble fixe d’indicateurs de santé de crawl depuis un ou plusieurs crawls Oncrawl terminés, et les renvoie dans une forme directement exploitable par un prompt LLM, un template ou un email.

Il ne vous demande aucune requête. La liste des KPI est fixe, les agrégations sont construites pour vous, et chaque KPI demandé est d’abord vérifié contre le schéma du crawl. C’est ce dernier point qui rend la sortie fiable : un KPI que le crawl ne peut pas produire est signalé dans unavailable_metrics avec sa raison, jamais renvoyé comme 0. Dans un rapport, un zéro et une absence n’ont pas du tout le même sens, et les confondre est exactement ainsi qu’un problème de crawl se lit comme un problème de trafic.

Pour tout ce qui sort de cette liste de KPI — une liste de pages filtrée, une distribution sur mesure, un export — utilisez le node Oncrawl Data Reader, qui accepte une requête OQL arbitraire.

Cas d’usage courants :

• Envoyer par email un résumé récurrent de la santé du crawl.
• Suivre dans le temps le nombre de pages totales, crawlées et indexables.
• Comparer les mêmes KPI sur les deux crawls les plus récents en une seule exécution.
• Obtenir une distribution des codes de statut sans écrire d’agrégation.
• Déclencher une alerte quand un KPI franchit un seuil.

Mise en place rapide#

KPI disponibles#

KPI	Ce qu’il mesure
Pages totales	Pages connues dans le crawl
Pages crawlées	Pages effectivement récupérées par le crawler
Pages indexables	Pages considérées comme indexables
Inrank moyen	Score moyen de popularité interne
Temps de chargement moyen	Temps de chargement moyen des pages
Distribution des codes de statut	Nombre de pages par code HTTP

Paramètres de configuration#

Champs obligatoires#

Champs optionnels#

Sortie#

{
  "selection": { "mode": "latest", "count": 1 },
  "crawls": [
    {
      "provenance": {
        "project_id": "p1",
        "crawl_id": "abc123",
        "crawl_ended_at": 1720003600000,
        "retrieved_at": "2026-10-20T14:00:00+00:00",
        "source": "Oncrawl API v2"
      },
      "metrics": {
        "total_pages": 12000,
        "fetched_pages": 11800,
        "avg_inrank": 4.5
      },
      "distributions": {
        "status_code": { "200": 11000, "404": 800 }
      },
      "unavailable_metrics": [],
      "raw_metadata": { "fields": [] }
    }
  ]
}

Résolution des problèmes#

Un KPI apparaît dans unavailable_metrics au lieu de metrics

Cause : Le schéma du crawl n’expose pas le champ dont ce KPI a besoin — généralement parce que la configuration du crawl ne l’a pas collecté.

Solution : L’entrée indique quel KPI et pourquoi. Activez la collecte correspondante dans les réglages du crawl Oncrawl, ou retirez ce KPI de la sélection.

Le crawl Oncrawl n'est pas terminé

Cause : Le crawl sélectionné est encore en cours ou a échoué.

Solution : Attendez sa fin, ou passez à Toujours utiliser les derniers crawls, qui ne lit que des crawls terminés.

Oncrawl a refusé le token comme non authentifié (401)

Cause : Le token est erroné ou révoqué. Un token valide qui n’a pas le droit d’effectuer l’action répond 403.

Solution : Créez un nouveau token via Settings > Tokens dans Oncrawl, puis reconnectez l’intégration.

Oncrawl a refusé la requête (403)

Cause : Oncrawl a reconnu le token mais refusé l’action. Le message reprend la raison donnée par Oncrawl :

• quota_error — le quota du compte ne permet pas la requête.
• no_active_subscription — le compte n’a pas d’abonnement actif.
• feature_not_available — l’offre n’inclut pas cette fonctionnalité, par exemple l’option API.
• sinon — il manque au token le scope projects:read, ou l’accès à ce projet.

Solution : Libérez ou augmentez le quota, renouvelez l’abonnement ou l’offre, ou régénérez le token avec le scope projects:read sur un compte qui voit le projet.

Limite de débit Oncrawl dépassée (429)

Cause : Oncrawl a répondu 429 à trois tentatives d’affilée. Le node relance une erreur 429 ou 5xx deux fois, à quelques secondes d’intervalle, avant d’abandonner. Oncrawl ne publie pas sa limite de débit.

Solution : Relancez plus tard, et évitez de lancer au même moment plusieurs workflows qui lisent Oncrawl.

Bonnes pratiques et pièges#

Comment s’intègre-t-il dans un workflow ?#

graph LR
    Resolver[Oncrawl Crawl Resolver] --> KPI[Oncrawl KPI Reader]
    KPI --> LLM[LLM<br/>résumer la santé du crawl]
    LLM --> Email[Email Sender]

Nodes associés#