Notion API CLI pour Openclaw

Un outil CLI Node.js portable conçu pour interagir avec l'API Notion pour la recherche, l'interrogation de bases de données et la gestion des pages d'espace de travail.

timenotspace
v1.1.0
Jan 28, 2026
5
6.7k
0

Installer & Télécharger

1. ClawHub CLI

Le moyen le plus rapide d'installer une compétence directement depuis le registre.

npx clawhub@latest install notion-api

2. Installation manuelle

Copiez le dossier de la compétence dans l'un de ces emplacements

Global
~/.openclaw/skills/
Espace de travail
<project>/skills/

Priorité : Espace de travail > Local > Intégré

3. Installation du prompt

Copiez ce prompt dans OpenClaw pour l'installer automatiquement.

Aide-moi à installer notion-api via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).

Vous préférez télécharger ?

Obtenez les fichiers bruts de la compétence dans une archive ZIP.

Qu'est-ce que Notion API CLI ?

La Notion API CLI est un utilitaire léger basé sur Node, conçu pour fournir aux agents d'IA et aux développeurs un moyen sécurisé d'interfacer avec les espaces de travail Notion. Contrairement à de nombreuses intégrations statiques, cette compétence met l'accent sur la portabilité et la sécurité en garantissant qu'aucun secret ou ID de base de données codé en dur n'est stocké dans le référentiel. En tant que composant de l'écosystème Openclaw Skills, il permet aux utilisateurs d'interagir dynamiquement avec leurs sources de données via une interface de ligne de commande propre.

En exploitant les jetons d'intégration, cet outil permet des opérations de haut niveau telles que des recherches dans tout l'espace de travail et des requêtes de base de données structurées. Il est particulièrement précieux pour les utilisateurs qui ont besoin de combler le fossé entre leur environnement de terminal local ou leurs agents de codage d'IA et leurs systèmes de gestion des connaissances basés sur Notion.

Cas d'utilisation de Notion API CLI

  • Automatisation de la création de nouvelles entrées de base de données à partir de scripts externes.
  • Exécution de recherches à l'échelle de l'espace de travail pour récupérer des ID de page ou du contenu spécifiques.
  • Récupération de données filtrées et triées à partir de bases de données Notion existantes pour analyse.
  • Intégration des données Notion dans des flux de travail d'IA multi-agents alimentés par Openclaw Skills.

Comment fonctionne Notion API CLI

  1. L'outil s'authentifie à l'aide d'un jeton d'intégration Notion fourni via des variables d'environnement ou un fichier de configuration local.
  2. Les utilisateurs invoquent la CLI via Node.js, en passant des commandes spécifiques comme search, query ou create-page.
  3. Le script envoie des requêtes structurées à l'API Notion, en respectant la version spécifiée de l'API (par défaut 2025-09-03).
  4. L'API Notion traite la demande et renvoie les données sous forme de JSON.
  5. La CLI affiche le JSON brut sur stdout, ce qui permet un chaînage facile ou une consommation par d'autres processus.

Configuration de Notion API CLI

Tout d'abord, fournissez un jeton d'intégration Notion en utilisant l'une des deux méthodes suivantes :

# Méthode 1 : Variable d'environnement
export NOTION_KEY='votre_jeton_d_integration'

# Méthode 2 : Fichier de configuration
echo "votre_jeton_d_integration" > ~/.config/notion/api_key

Assurez-vous que les pages ou bases de données spécifiques auxquelles vous souhaitez accéder sont partagées avec votre intégration dans l'interface utilisateur de Notion. Vous pouvez ensuite exécuter des commandes via Node.js :

node scripts/notion-api.mjs search "votre terme de recherche"

Schéma de données et taxonomie de Notion API CLI

La compétence gère les données en utilisant la structure JSON native de Notion. Les paramètres clés et leurs rôles incluent :

Paramètre Description
NOTION_KEY Le secret de l'API utilisé pour l'authentification.
DATA_SOURCE_ID L'UUID unique pour une base de données Notion.
page_size Contrôle le nombre de résultats renvoyés (par défaut 10).
body Une chaîne JSON brute pour une logique de filtrage et de tri avancée.
title-prop Spécifie le nom de la propriété 'title' dans une base de données cible.

Fonctionnalités avancées de Notion API CLI

  • Prise en charge des charges utiles JSON personnalisées pour permettre un filtrage et un tri complexes des bases de données.
  • Versionnage de l'API configurable via la variable d'environnement NOTION_VERSION pour assurer la compatibilité avec les futures mises à jour de Notion.
  • Intégration transparente avec d'autres Openclaw Skills pour construire des pipelines de données automatisés.
  • Modèle d'exécution sans état qui évite le codage en dur d'informations sensibles sur l'espace de travail.

SKILL.md


Chargement

Compétences Openclaw associées

En vedette*