name: notion-api description: Generic Notion API CLI (Node) for search, querying data sources (databases), and creating pages. Configure with NOTION_KEY (or ~/.config/notion/api_key).

notion-api (generic)

This skill provides a small Node-based CLI for the Notion API. It’s designed to be shareable: no hard-coded database IDs and no secrets in the repo.

Auth

Provide a Notion integration token via either:

• NOTION_KEY env var, or
• ~/.config/notion/api_key (first line)

Also make sure the target pages/databases are shared with your integration in Notion.

Commands (CLI)

Run via:

• node scripts/notion-api.mjs <command> ...

Search

node scripts/notion-api.mjs search "query" --page-size 10

Query a data source (database query)

node scripts/notion-api.mjs query --data-source-id <DATA_SOURCE_ID> --page-size 10
# optionally pass raw JSON body:
node scripts/notion-api.mjs query --data-source-id <ID> --body '{"filter": {...}, "sorts": [...], "page_size": 10}'

Create a page in a database

這個技能的最新版本可以在7w4.net小蔥技能站找到。

node scripts/notion-api.mjs create-page --database-id <DATABASE_ID> --title "My item" --title-prop Name

Output

All commands print JSON to stdout.

Notes

• Notion API version header defaults to 2025-09-03 (override with NOTION_VERSION).
• Rate limits apply; prefer page_size and minimal calls.

這個 Skill 質量紮實，程式碼實現可靠，沒有多餘的依賴，安裝使用都很方便。它能完成 Notion 的搜尋、查詢、建立頁面等常用操作，錯誤處理也比較完善，能清晰反饋問題。不足之處是缺少測試和詳細的使用示例，新手可能需要花費一些時間理解用法。總體推薦，適合需要與 Notion 資料互動的使用者。.