Craft.do笔记集成

技能简介

该技能提供Craft.do笔记应用的完整REST API接入能力，支持通过程序化方式管理文档、任务和文件夹结构。

能做什么

• 自动创建和更新任务到收件箱、每日笔记或归档
• 批量创建文档并写入Markdown内容
• 构建多级文件夹层级结构
• 将Obsidian笔记库完整迁移至Craft.do
• 读取和编辑现有文档的区块内容

使用说明

安装与配置

1. 从Craft.do设置中获取API密钥
2. 设置环境变量：export CRAFT_API_KEY="pdk_xxx" 和 export CRAFT_ENDPOINT="https://connect.craft.do/links/YOUR_LINK/api/v1"

基础调用示例

列出所有文件夹：

curl -H "Authorization: Bearer $CRAFT_API_KEY" "$CRAFT_ENDPOINT/folders"

创建文档：

curl -X POST -H "Authorization: Bearer $CRAFT_API_KEY" -H "Content-Type: application/json" -d '{"documents":[{"title":"新文档"}],"destination":{"folderId":"FOLDER_ID"}}' "$CRAFT_ENDPOINT/documents"

添加Markdown内容：

curl -X POST -H "Authorization: Bearer $CRAFT_API_KEY" -H "Content-Type: application/json" -d '{"blocks":[{"type":"text","markdown":"# 标题\n\n正文内容"}],"position":{"pageId":"DOCUMENT_ID","position":"end"}}' "$CRAFT_ENDPOINT/blocks"

创建任务：

curl -X POST -H "Authorization: Bearer $CRAFT_API_KEY" -H "Content-Type: application/json" -d '{"tasks":[{"markdown":"待办事项","location":{"type":"inbox"},"status":"active"}]}' "$CRAFT_ENDPOINT/tasks"

输入与输出

见下方输入与输出表格。

风险提示

• Collections（数据库表）暂无API支持，无法通过接口访问
• 任务只能创建和更新，无法删除
• 文档无法直接删除，仅能移动到未分类或回收站
• 搜索功能需要特定查询格式，当前版本未完全验证
• API密钥需妥善保管，避免泄露导致数据风险

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/atomtanstudio/craft-do/SKILL.md
来源类型：GitHub仓库