管理 Notion 工作区 — 搜索页面、读取内容、在数据库中创建页面、追加块以及列出数据库。直接通过 urllib 调用 Notion REST API。
概念- 工作空间 Skill是一项面向实际任务的技能,主要用于从 CLI 管理您的字号工作空间, 或者作为可导入的 Python 模块;Setup. 设置您的字号集成符号: 或者脚本中嵌入的默认符号为 u。
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
通过命令行(CLI)或作为可导入的 Python 模块来管理您的 Notion workspace。
设置您的 Notion 集成令牌:
export NOTION_TOKEN=ntn_...
若未设置,则将使用脚本中内置的默认令牌。
请确保您的 Notion 集成已获得目标页面/数据库的访问权限。
在 Notion 中:打开一个页面 → 点击「Share」→ 「Invite your integration」邀请该集成。
python3 scripts/notion.py search "project notes" python3 scripts/notion.py search "budget" --type database
# 仅元数据 python3 scripts/notion.py read PAGE_ID # 包含区块内容(blocks) python3 scripts/notion.py read PAGE_ID --blocks
python3 scripts/notion.py create DATABASE_ID --title "New Page Title"
# 指定额外属性(properties)
python3 scripts/notion.py create DATABASE_ID --title "Task" --props '{"Status": {"select": {"name": "In Progress"}}}'
python3 scripts/notion.py append PAGE_ID --text "New paragraph content"
python3 scripts/notion.py databases
from scripts.notion import search, read_page_content, create_page, append_blocks, list_databases
# 搜索
results = search("meeting notes")
for item in results["results"]:
print(item["id"], item["object"])
# 读取页面及其区块内容
data = read_page_content("PAGE_ID")
print(data["page"])
print(data["blocks"])
# 创建页面
page = create_page("DATABASE_ID", "My New Page")
print(page["url"])
# 追加文本
append_blocks("PAGE_ID", "This is a new paragraph.")
# 列出数据库
dbs = list_databases()
| 文件 | 用途 |
|---|---|
scripts/notion.py |
CLI 工具 + 可导入模块 |
references/notion-api.md |
Notion API 快速参考文档 |
urllib(无需安装任何 SDK)2022-06-28相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习
最新文章