notion

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)          # toutes les lignes (paginé)
rows = [notion.extract_page_properties(p) for p in pages]
# rows = [{"type de donnée": "...", "habilitations": [...], ...}, ...]

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)   # récursif, paginé
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.