Notion DB Query Skill

Notion APIのquery database/query data sourceでページを複数件取得する。

認証

使用方法

基本（最大50件取得）

python3 ${CLAUDE_PLUGIN_ROOT}/skills/notion-db/scripts/notion_db.py \
  --database-id "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --max-items 50

最新API（Data Source）を使う場合

python3 ${CLAUDE_PLUGIN_ROOT}/skills/notion-db/scripts/notion_db.py \
  --data-source-id "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --max-items 50

フィルター指定（JSON文字列）

python3 ${CLAUDE_PLUGIN_ROOT}/skills/notion-db/scripts/notion_db.py \
  --database-id "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --filter '{"property":"Status","status":{"equals":"Done"}}' \
  --max-items 100

フィルター指定（JSONファイル）

python3 ${CLAUDE_PLUGIN_ROOT}/skills/notion-db/scripts/notion_db.py \
  --database-id "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --filter-file ./filter.json \
  --sorts-file ./sorts.json

途中カーソルから再開

python3 ${CLAUDE_PLUGIN_ROOT}/skills/notion-db/scripts/notion_db.py \
  --database-id "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --start-cursor "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

出力

JSONを標準出力する。主なキー:

• count: 取得件数
• has_more: 続きがあるか
• next_cursor: 次ページ取得に使うカーソル
• target_type: database または data-source
• target_id: クエリ対象ID
• results: Notionページ配列

--compact を使うと id/url/created_time/last_edited_time/properties のみを返す。

参考

• 公式（Database）: https://developers.notion.com/reference/post-database-query
• 公式（Data Source）: https://developers.notion.com/reference/query-a-data-source
• フィルター例: references/filter_examples.md