Intégration API Notion

Ce qu'elle fait

Cette compétence fournit des exemples pratiques et des instructions pour utiliser l'API Notion dans des flux de travail d'agents ou des scripts d'automatisation. Elle documente la configuration (stockage local de la clé API), les requêtes curl courantes pour la recherche, la récupération de pages/blocs, la création de pages dans des bases de données, l'interrogation de sources de données, la mise à jour du contenu et la suppression/restauration de blocs. Elle résume également les formats de types de propriétés Notion et les notes d'API pertinentes pour les intégrations.

Quand l'utiliser

Utilisez cette compétence lorsqu'un agent doit s'intégrer à Notion : synchronisation de contenu, automatisation de la création de pages, interrogation de bases de données ou gestion programmatique des blocs. Convient aux agents capables d'exécuter des commandes shell ou d'émettre des requêtes HTTP pour le compte d'un utilisateur. Utile lors d'automatisations alimentant une documentation, des suivis de tâches ou des bases de connaissances.

Ce qui est inclus

• Scripts : aucun script packagé, mais le fichier SKILL.md inclut de nombreux exemples curl et des étapes de configuration.
• Références : aucune référence incluse dans le fichier de compétence, mais le dépôt semble être un large registre avec des ressources supplémentaires.
• Instructions : modèles d'utilisation de l'API clairs, exemples de charges utiles curl, tableau des types de propriétés et conseils sur les limites de débit.

Agents compatibles

S'adresse aux agents capables d'exécuter des requêtes curl/HTTP et de lire/écrire des fichiers ; compatible avec Claude Code, Cursor, les exécuteurs de style Agent Zero et les infrastructures d'agents avec accès au shell.