Fasterize Sitemap
Le node Fasterize Sitemap envoie une liste JSON d'URL vers l'edge Fasterize afin de servir un sitemap dynamique sans modifier le site d'origine.
À quoi sert le node Fasterize Sitemap ?
Le node Fasterize Sitemap envoie un tableau JSON d’URL vers l’API Fasterize Sitemap afin qu’un nouveau sitemap.xml soit servi depuis l’edge — sans redéployer le site d’origine ni dépendre du CMS pour le régénérer. Chaque entrée doit contenir au moins un champ loc, accompagné des attributs habituels du sitemap (lastmod, changefreq, priority) si nécessaire.
Cas d’usage typiques :
- Pousser un sitemap rafraîchi à chaque publication de nouvelles pages produit ou article.
- Remplacer entièrement le sitemap après une migration ou une refonte de l’arborescence des URL.
- Faire un upsert uniquement des URL modifiées dans la dernière heure pour rester proche du temps réel.
- Piloter le sitemap depuis un workflow qui crawle l’origine ou interroge une base interne, plutôt qu’un export statique.
Configuration rapide
Connecter votre intégration Fasterize
Ouvrez les paramètres du node et sélectionnez votre intégration Fasterize. Si aucune n’est disponible, allez dans Settings > Integrations pour ajouter un token API Fasterize.
Fournir le payload des URL
Reliez un node amont qui produit un tableau JSON d’objets URL à l’entrée URLs Data (JSON). Forme minimale : [ { loc: https://example.com/page } ] ; ajoutez lastmod, changefreq ou priority si nécessaire.
Choisir le mode d’envoi
Dans Mode, choisissez Upsert pour fusionner les nouvelles URL avec le sitemap existant, ou Replace pour écraser tout le sitemap avec le payload.
Connecter la sortie
Reliez le port de sortie au node suivant. Le résultat est la réponse de l’API Fasterize sous forme de chaîne — exploitez-la avec un JSON Path Extractor pour lire les compteurs, ou avec un Email Sender pour notifier l’équipe.
Paramètres de configuration
Champs requis
integration_id integration required Intégration Fasterize — L’espace Fasterize vers lequel le sitemap est envoyé. Le token de l’intégration détermine quel site accéléré par Fasterize reçoit les URL.
urls_data string required URLs Data (JSON) — Un tableau JSON d’objets URL. Chaque entrée DOIT contenir un champ loc ; le node rejette l’appel si une entrée n’en contient pas. Champs optionnels par entrée : lastmod (date ISO), changefreq (always, hourly, daily, weekly, monthly, yearly, never), priority (0.0 à 1.0). Peut être branché sur un port d’entrée ou collé en littéral.
Champs optionnels
mode string default: upsert Mode — upsert fusionne le payload avec le sitemap existant (les URL absentes du payload sont conservées). replace écrase tout le sitemap avec le payload — tout ce qui manque disparaît.
Vous n’avez pas besoin de pré-sérialiser le payload. Si le node amont produit déjà un objet ou un tableau JSON (par exemple un JSON Path Extractor ou un LLM avec sortie structurée), le node le sérialise pour vous avant l’appel API.
Que renvoie le node ?
Le node renvoie la réponse du service Fasterize Sitemap sous forme de chaîne. En cas de succès, la réponse décrit les URL acceptées ; en cas d’échec, le node renvoie une erreur au format JSON.
output string La réponse de l’API Fasterize Sitemap, sérialisée en chaîne. Analysez-la avec un JSON Path Extractor ou un LLM pour extraire le nombre d’URL acceptées ou une éventuelle erreur par entrée.
Forme d’erreur si le payload est vide ou [] :
{ "error": "No URLs provided for sitemap" }Forme d’erreur si une entrée n’a pas de loc :
{ "error": "Each URL entry must have at least a 'loc' field" }Forme d’erreur en cas de JSON invalide :
{ "error": "Invalid JSON format for URLs data. Expected array of URL objects" }Forme d’erreur en cas d’échec de l’appel amont :
{ "error": "Failed to execute Fasterize Sitemap upload" }Exemples d’utilisation
Cas 1 : Upsert des pages fraîchement publiées
Une équipe contenu publie quelques articles chaque matin. Vous construisez un workflow qui interroge le CMS sur les dernières 24 heures et fait un upsert de ces URL dans le sitemap en production.
Configuration :
- Intégration Fasterize : Production
- Mode :
upsert - URLs Data (JSON) : branchée sur un JSON Path Extractor qui remet en forme la réponse du CMS.
Payload d’entrée :
[
{
"loc": "https://example.com/blog/checklist-seo-2025",
"lastmod": "2025-04-12",
"changefreq": "weekly",
"priority": 0.8
},
{
"loc": "https://example.com/blog/bonnes-pratiques-sitemap",
"lastmod": "2025-04-12",
"changefreq": "weekly",
"priority": 0.7
}
]En mode upsert, seules les URL listées sont touchées — toutes les autres URL déjà présentes dans le sitemap restent.
Cas 2 : Remplacer tout le sitemap après une migration
Vous avez restructuré l’arborescence des URL d’un site et voulez que les nouvelles URL soient les seules entrées servies par Fasterize.
Configuration :
- Mode :
replace - URLs Data (JSON) : la liste exhaustive des URL canoniques après migration.
[
{ "loc": "https://example.com/", "changefreq": "daily", "priority": 1.0 },
{ "loc": "https://example.com/produits/", "changefreq": "weekly", "priority": 0.9 },
{ "loc": "https://example.com/produits/widget-a", "lastmod": "2025-03-01", "priority": 0.8 },
{ "loc": "https://example.com/produits/widget-b", "lastmod": "2025-03-01", "priority": 0.8 }
]En mode replace, toute URL absente de ce payload disparaît du sitemap — assurez-vous que la liste est exhaustive avant d’exécuter le workflow.
Problèmes courants
Le node renvoie 'No URLs provided for sitemap'
Cause : L’entrée urls_data était vide, valait littéralement [], ou n’a pas atteint le node.
Solution : Vérifiez la connexion amont. Si le producteur est un LLM, ajoutez un node Find and Replace en amont pour retirer les balises Markdown qui laisseraient le payload vide après parsing.
Le node renvoie 'Each URL entry must have at least a loc field'
Cause : Au moins un élément du payload n’est pas un objet, ou il manque la clé loc.
Solution : Reformatez le payload en amont — généralement avec un JSON Path Extractor — pour que chaque entrée soit un objet plat avec loc réglé sur l’URL absolue. Filtrez ou corrigez toute entrée non conforme avant l’envoi.
Le node renvoie 'Invalid JSON format for URLs data'
Cause : La chaîne passée à urls_data n’est pas du JSON valide, ou ne se parse pas en tableau d’objets.
Solution : Validez la sortie amont. Si elle vient d’un LLM, faites-la passer par un Find and Replace pour retirer les backticks ou le texte parasite ; sinon, inspectez la valeur brute avec un node Text Output et corrigez le producteur.
Le mode Replace a effacé des URL que je voulais garder
Cause : replace écrase tout le sitemap, pas seulement les URL présentes dans le payload.
Solution : Passez en upsert pour ajouter ou rafraîchir des URL spécifiques tout en préservant le reste. Réservez replace aux migrations ou réinitialisations propres où le payload fait foi.
Bonnes pratiques
Validez le payload en amont. Un JSON Path Extractor ou une petite étape de validation avant ce node évite que tout le batch soit rejeté à cause d’un seul loc manquant.
Préférez upsert pour les mises à jour incrémentales. replace est destructif : toute URL absente du payload disparaît du sitemap. Réservez-le aux migrations ou refontes complètes où le payload fait autorité.
Comment s’intègre-t-il dans un workflow ?
Le node Fasterize Sitemap est typiquement la dernière étape d’un pipeline qui collecte des URL fraîches et les pousse vers l’edge.
graph LR
Source[CMS / DB / Crawler] --> Extract[JSON Path Extractor remet en forme les URL]
Extract --> Sitemap[Fasterize Sitemap envoie le payload]
Sitemap --> Notify[Email Sender notifie l'équipe]Nodes complémentaires
Poussez titres, meta descriptions et autres règles SEO à l’edge pour le même site Fasterize.
Remettez en forme une réponse CMS ou base de données en tableau d’URL attendu par ce node.
Retirez les balises Markdown et caractères parasites des sorties LLM avant l’envoi.
Notifiez l’équipe avec la réponse de l’API après chaque mise à jour du sitemap.