| name | notion |
| description | Lire et écrire dans Notion — interroger une base de données ou une page, et publier des rapports. À utiliser dès qu'une demande référence une page/base Notion (URL app.notion.com, ou ancien notion.so). |
Notion
Client unique pour l'API Notion : lib.notion (lecture + écriture). Ne pas réinventer de client httpx ad hoc.
Ne jamais WebFetch une URL Notion (app.notion.com, ou ancien notion.so) : l'app web est authentifiée et rendue en JS, on ne récupère qu'un écran de connexion. Toujours passer par l'API via lib.notion.
Lire une base de données
Une URL de base de données ressemble à https://app.notion.com/<workspace>/<db_id>?v=<view_id>. Extraire l'id (le ?v=... est l'id de vue, à ignorer), puis interroger :
from lib import notion
db_id = notion.db_id_from_url("https://app.notion.com/gip-inclusion/1455f321b60480f68fb4fbab8ad1a6e9?v=...")
pages = notion.query_database(db_id)
rows = [notion.extract_page_properties(p) for p in pages]
extract_page_properties aplatit chaque ligne en dict Python : title/rich_text → str, select → str, multi_select/relation/people → list, date → str ISO.
Lire le contenu d'une page
from lib import notion
blocks = notion.get_block_children(page_id)
text = "\n".join(notion.extract_block_text(b) for b in blocks)
Publier un rapport
from lib import notion
page_id, url = notion.publish_report(title="...", content=markdown, website="emplois")
Publie dans la base « Rapports publics » (NOTION_REPORTS_DB). Préférer le skill save_report pour le flux applicatif standard.
Prérequis d'accès (important)
NOTION_TOKEN est l'intégration de publication des rapports. Elle ne peut lire une page/base que si celle-ci lui a été partagée dans Notion (menu ⋯ → Connexions). Sinon l'API renvoie 404/object_not_found, quel que soit le code. Si une lecture échoue en 404, demander que la page soit partagée avec l'intégration.
