手动管理 Notion 内容非常耗时。此技能使 Claude、Codex 和 Claude Code 能够通过官方 Notion API 对页面、数据库和块进行程序化读取、创建和更新，并配备完善的认证和错误处理功能。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“notion-api”。 Search Notion for "meeting notes"
预期结果:
找到 3 个匹配的页面：
| 标题 | ID | 最后编辑 |
|-------|-----|-------------|
| Q1 会议记录 | abc123 | 2024-01-15 |
| 团队站会记录 | def456 | 2024-01-14 |
| 项目启动会议记录 | ghi789 | 2024-01-10 |
正在使用“notion-api”。 Query tasks database for incomplete items
预期结果:
显示任务数据库中的 5 个未完成任务：
| 任务 | 负责人 | 截止日期 | 状态 |
|------|----------|----------|--------|
| 审查 PR #42 | @sarah | 1月20日 | 未开始 |
| 更新文档 | @alex | 1月22日 | 进行中 |
| 部署预发环境 | @jordan | 1月23日 | 未开始 |
正在使用“notion-api”。 Create page titled "Sprint Planning"
预期结果:
成功在 Sprint Notes 数据库中创建页面"Sprint Planning"。
页面 ID：xyz789abc
创建时间：2024-01-16T10:30:00.000Z
URL：https://notion.so/xyz789abc
安全审计
低风险This is a legitimate Notion API documentation skill that requires network access to interact with the Notion API. Static analysis flagged 802 potential issues, but all are false positives: backtick detection triggered by markdown code fences, URL detection from official API documentation, and environment variable patterns from authentication examples. The skill implements proper security practices including user confirmation for destructive operations and explicit instructions to never expose API tokens.
低风险问题 (2)
风险因素
质量评分
你能构建什么
从 Notion 构建知识库
自动将项目文档、会议记录或研究资料从 Notion 数据库同步到其他系统或格式中。
从 Notion 数据生成报告
使用特定过滤器查询 Notion 数据库，并将数据聚合为摘要、仪表板或自动化状态报告。
自动化 Notion 内容创建
基于外部触发器或定时工作流，创建结构化页面、更新属性或向现有页面添加块。
试试这些提示
Search Notion for pages containing "{query}" and show me the titles and IDs of the results.Create a new page in the {database_name} database with these properties: {property_values}. Use the Notion API to add this page.Query the {database_name} database and return all items where {filter_condition}. Format the results as a markdown table.Update the Notion page with ID {page_id} by adding a new section with the heading "{heading}" and content "{content}".最佳实践
- 在进行其他 API 调用之前，始终通过机器人用户端点测试来验证身份认证
- 收到 429 速率限制响应时，实现指数退避而不是立即重试
- 在执行任何破坏性操作（如删除或归档页面）之前，获取用户确认
避免
- 不要在日志、错误消息或响应中暴露 API 令牌——仅在 Authorization 请求头中使用它们
- 避免在未处理速率限制的情况下发出请求——这将导致操作失败
- 对于批量操作或数据库架构更改，不要跳过用户确认步骤
常见问题
如何开始使用此技能？
此技能可以用于任何 Notion 工作区吗？
如果超过速率限制会怎样？
我可以创建嵌套页面或块吗？
如何处理身份验证错误？
此技能使用哪个 Notion API 版本？
开发者详情
许可证
MIT
引用
main
文件结构