Intégration Sanity
Publiez des contenus optimisés pour le SEO sur votre site propulsé par Sanity grâce à la Mutations API, pour une diffusion headless.
Sanity est un CMS headless moderne qui donne aux développeurs un contrôle total sur la structure et la diffusion des contenus. Il est apprécié avec les frontends Next.js, Gatsby et Nuxt, et se montre extrêmement puissant pour les sites axés sur le contenu.
GetRanked se connecte à la Mutations API de Sanity pour créer des documents dans votre dataset. Nous publions des contenus structurés conformes à votre schéma Sanity, notamment du texte enrichi au format Portable Text, des références vers d’autres documents et des champs personnalisés.
Comme Sanity est headless, c’est votre frontend qui décide de l’affichage des contenus. GetRanked se concentre sur la création des contenus, votre frontend Next.js ou Gatsby sur leur présentation. Cette séparation vous permet d’obtenir les meilleures performances SEO avec votre frontend sur mesure, pendant que GetRanked assure la production de contenus à grande échelle.
Ce dont vous aurez besoin
Project ID
L’ID de votre projet Sanity (disponible sur sanity.io/manage)
Dataset
Le nom du dataset (généralement 'production')
API Token
Un jeton d’écriture avec les droits Editor
Type de document
Le nom du type de schéma des articles de blog (p. ex. 'post')
Guide de configuration étape par étape
Connectez-vous à Sanity Manage
Rendez-vous sur sanity.io/manage et sélectionnez votre projet.
Récupérez votre Project ID et votre dataset
Votre Project ID s’affiche dans l’en-tête du projet. Le nom de votre dataset se trouve sous 'Datasets' (généralement 'production').
Créez un API Token
Allez dans API → Tokens → 'Add API Token'. Nommez-le 'GetRanked', définissez les droits sur 'Editor' et créez-le. Copiez immédiatement le jeton.
Notez le type de schéma de votre blog
Cherchez dans vos fichiers de schéma Sanity (généralement dans le dossier schemas/) le type de document utilisé pour les articles. Noms courants : 'post', 'article', 'blogPost'.
Établissez la connexion dans GetRanked
Saisissez votre Project ID, votre dataset, votre API Token et le type de document dans l’intégration Sanity de GetRanked.
Associez les champs et testez
Associez les champs de contenu aux champs de votre schéma Sanity (titre, slug, corps, extrait, etc.). Testez avec un document en brouillon.
Ce que GetRanked publie sur Sanity
- Documents suivant la structure des champs de votre schéma
- Texte enrichi au format Portable Text (block content)
- Champs slug avec des slugs générés automatiquement et compatibles avec les URL
- Références vers les documents de catégorie/tag
- Champs SEO (méta-titre, description) si votre schéma les inclut
- État brouillon ou publié selon la configuration
Conseils pour de meilleurs résultats
Ajoutez des champs SEO (metaTitle, metaDescription) à votre schéma de blog si ce n’est pas déjà fait.
Vérifiez que votre frontend affiche correctement le Portable Text pour le SEO (titres, liens, etc.).
Utilisez les requêtes GROQ de Sanity sur votre frontend pour construire le maillage interne et les articles connexes.
Configurez un webhook dans Sanity pour relancer la génération du frontend lorsque GetRanked publie de nouveaux contenus.
Prêt à bien classer votre site Sanity ?
Commencez dès aujourd’hui à publier sur Sanity des contenus générés par IA et optimisés pour le SEO. Aucune carte bancaire requise.