Fasterize Bulk SEO

Le node Fasterize Bulk SEO applique des recommandations SEO en masse sur un site accéléré par Fasterize en envoyant un jeu de règles JSON (ou CSV) à l'API Fasterize Bulk SEO.

À quoi sert le node Fasterize Bulk SEO ?

Le node Fasterize Bulk SEO envoie un lot de règles SEO à l’API Fasterize Bulk SEO afin que les modifications soient appliquées en edge, sans toucher au site d’origine. Vous fournissez un tableau JSON (ou un CSV) d’URL associées à des recommandations — titles, meta descriptions, canoniques, hreflang, schema.org, OpenGraph, balises de titre, réécritures HTML, etc. — et le node les téléverse en un seul appel.

Cas d’usage typiques :

• Appliquer en une seule passe des meta titles et descriptions générés par un LLM sur des centaines de pages produits.
• Déployer des correctifs canonical et hreflang sur un site international via la couche edge de Fasterize.
• Remplacer ou supprimer des fragments HTML hérités (balises obsolètes, scripts de tracking) sur de nombreuses URL d’un coup.
• Pousser à grande échelle du balisage schema.org, OpenGraph ou Twitter Card sans redéployer l’origine.

Configuration rapide

Paramètres de configuration

Champs obligatoires

Champs optionnels

Que produit le node en sortie ?

Le node produit une chaîne unique contenant la réponse renvoyée par le service Fasterize Bulk SEO. En cas de succès, la réponse décrit les règles acceptées ; en cas d’échec, le node renvoie une erreur au format JSON.

Forme de l’erreur lorsqu’aucun payload n’est fourni :

{ "error": "No JSON data provided for bulk SEO upload" }

Forme de l’erreur lorsque l’appel au service échoue :

{ "error": "Failed to execute Fasterize Bulk SEO upload" }

Exemples d’utilisation

Exemple 1 : Pousser des meta titles et descriptions générés par LLM

Vous avez utilisé un node LLM pour rédiger les meta tags SEO d’une liste de pages produits et souhaitez les appliquer via Fasterize sans toucher au CMS.

Configuration :

• Intégration Fasterize : Production
• Mode : upsert
• SEO Data (JSON) : branché sur la sortie du LLM

Payload d’entrée :

[
  {
    "url": "https://example.com/product/widget-a",
    "recommendations": [
      { "type": "title", "value": "Widget A — Premium Industrial Widget" },
      { "type": "meta-description", "value": "Discover Widget A, our flagship industrial widget built for durability." }
    ]
  },
  {
    "url": "https://example.com/product/widget-b",
    "recommendations": [
      { "type": "title", "value": "Widget B — Compact Workshop Widget" },
      { "type": "meta-description", "value": "Widget B fits any workbench while keeping the precision of our industrial range." }
    ]
  }
]

En mode upsert, seules les URL fournies sont modifiées ; les règles déjà configurées pour d’autres URL restent intactes.

Exemple 2 : Remplacer tout le jeu de règles pour un déploiement hreflang

Vous migrez le balisage international d’un site multi-pays et souhaitez que la nouvelle configuration hreflang soit la seule en vigueur dans le Bulk SEO.

Configuration :

• Mode : replace
• SEO Data (JSON) :

[
  {
    "url": "https://example.com/fr/",
    "recommendations": [
      { "type": "hreflang-default", "value": "fr" },
      { "type": "hreflang-country", "value": "fr-FR" },
      { "type": "hreflang-url", "value": "https://example.com/fr/" }
    ]
  },
  {
    "url": "https://example.com/en/",
    "recommendations": [
      { "type": "hreflang-default", "value": "en" },
      { "type": "hreflang-country", "value": "en-US" },
      { "type": "hreflang-url", "value": "https://example.com/en/" }
    ]
  }
]

En mode replace, toute URL absente du payload perd ses règles Bulk SEO précédentes — assurez-vous que le payload est exhaustif.

Problèmes courants

Le node renvoie 'No JSON data provided for bulk SEO upload'

Cause : L’entrée json_data était vide, valait un tableau vide [] ou n’a pas atteint le node.

Solution : Vérifiez la connexion amont qui alimente SEO Data (JSON). Si le producteur est un LLM, ajoutez un node Find and Replace en amont pour retirer les backticks ou les barrières Markdown qui rendraient le payload vide après parsing.

Le node renvoie 'Failed to execute Fasterize Bulk SEO upload'

Cause : L’API Fasterize a rejeté la requête — causes fréquentes : token d’intégration invalide ou révoqué, recommendation.type inconnu, URL mal formée.

Solution : Revérifiez l’intégration dans Settings > Integrations. Validez ensuite chaque type par rapport à la liste prise en charge documentée plus haut, et assurez-vous que chaque url est absolue et pointe vers le site accéléré par Fasterize.

Le mode replace a effacé des règles que je voulais conserver

Cause : replace écrase l’intégralité du jeu de règles, pas uniquement les URL présentes dans le payload.

Solution : Utilisez upsert pour ajouter ou mettre à jour des URL ciblées tout en préservant le reste. Réservez replace aux déploiements complets où le payload est exhaustif.

Les recommandations sont acceptées mais n'apparaissent pas sur le site

Cause : Fasterize met les pages en cache en edge, donc le HTML précédemment mis en cache peut continuer à être servi tant que le cache n’a pas expiré.

Solution : Déclenchez une invalidation du cache Fasterize sur les URL concernées après l’upload, ou attendez le TTL configuré avant de valider dans le navigateur.

Bonnes pratiques

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

Le node Fasterize Bulk SEO est généralement la dernière étape d’un pipeline de génération de contenu produisant des recommandations SEO structurées.

graph LR
    Source[Liste d'URL / CSV] --> LLM[LLM génère titles + descriptions]
    LLM --> FR[Find and Replace nettoie le Markdown]
    FR --> Bulk[Fasterize Bulk SEO envoie le payload]
    Bulk --> Notify[Email Sender notifie l'équipe]

Nodes associés