Notion Workspace_知识管理 skill-PHP中文网

Notion Workspace

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

管理 Notion 工作区 — 搜索页面、读取内容、在数据库中创建页面、追加块以及列出数据库。直接通过 urllib 调用 Notion REST API。

概念- 工作空间 Skill

功能概述

概念- 工作空间 Skill是一项面向实际任务的技能，主要用于从 CLI 管理您的字号工作空间, 或者作为可导入的 Python 模块；Setup. 设置您的字号集成符号: 或者脚本中嵌入的默认符号为 u。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

notion-workspace 技能

通过命令行（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

作为 Python 模块使用

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()