Obsidian

开发者集成：API / Skill / Web 端 / 浏览器插件

笔记同步助手 · ·Obsidian 教程
开发者APISkill集成教程

开发者集成

不少使用 AI 助理类工具的同学问”有没有 API 接口、能不能在我自己的 agent / harness 里接入笔记同步助手”。本文集中回答。

一、Note Sync Helper Skill（Clawhub）✅ 已上线

我们在 Clawhub 上发布了官方 Skill：

https://clawhub.ai/notesynchelper/notehelper

任何 Claude Code / Cursor / Codex 等支持 Clawhub Skill 的 harness 都可以一键安装这个 Skill。安装后，你的 AI agent 可以：

  • 保存文章：把标题、正文、摘要直接存进你的笔记库（与 Obsidian 等插件同一把密钥、同一个库）
  • 保存链接：只发一个 URL，将链接交给 DeepSeek、豆包、千问 等 AI 处理，整理为图文笔记（视频链接也可以，会整理成视频图文笔记）
  • 搜索文章：按关键词检索你已保存的内容
  • 配置密钥：写入 API Key，并验证与服务的连通性

适用场景：在你的 AI 写作流程、信息收集 agent、自动化 workflow 里，让 AI 帮你”把这个有趣的链接存到我的 Obsidian”。

鉴权用你的 API Key（与 Obsidian 插件里同一把密钥）。计费说明：通过 Skill 提交的普通链接每次扣 5 积分（按提交次数计；这一点与微信侧不同，微信发送普通链接剪藏不扣积分）；能识别为视频的链接免提交费，按视频时长计费（单条封顶 15 积分）。完整费率见 积分规则。

⚠️ 重要：调用接口务必显式设置 User-Agent，否则可能在边缘被拦截（HTTP 403 / error code: 1010）

我们的 API 域名开启了 Cloudflare 浏览器完整性检查（Browser Integrity Check），会拦截一批典型的自动化客户端 UA。如果你的 agent / 脚本用 Python urllib 的默认 UA（Python-urllib/3.x）这类字符串发请求，请求会在边缘节点直接被拒：HTTP 403，正文 error code: 1010，Server 头为 cloudflare。注意此时请求根本没有到达我们的服务端，密钥还没有被校验——所以这不是密钥错误，重新配置密钥解决不了。

规避方法很简单，二选一：

  • 直接用 Skill 文档里的 curl 示例（curl 的默认 UA 不在拦截名单内）；
  • 自己发 HTTP 请求时显式设置一个自定义 User-Agent，例如 notehelper-skill/1.1。任意正常字符串即可，不需要伪装成浏览器。

二、其他接入方式

形式当前状态说明
Web 端（在 bijitongbu.site 网页里直接收藏）❌ 暂无计划微信收藏链路已经很顺，独立 Web 端边际收益低，没排期
浏览器插件（Chrome / Edge）🧪 实验室版已可用手动安装的实验版本，见网页剪藏浏览器插件教程；Safari 暂不支持
REST API（你自己服务端调）❌ 不直接对外现阶段仅通过 Clawhub Skill 接入，不直接暴露 HTTP 接口
MCP Server🚧 评估中Skill 满足大多数需求；MCP 形式如果反馈强烈会做

如果你有 Skill 满足不了的特定场景（比如对接企业知识库、对接 RPA 流程），可以联系人工客服讨论。

三、与 Claude Code / Cursor / Codex 等的集成

直接用各 harness 自带的 Clawhub Skill 安装机制即可：

  • Claude Code：参考 Claude Code 文档里的”Add a skill”流程
  • Cursor / Codex：在 Clawhub 网站登录后点 “Install” 即可

绑定密钥时，填你在「笔记同步助手」服务号菜单里获取的 API Key 即可。

四、想做集成但不知道往哪个方向走？

加企业微信客服讨论：在「笔记同步助手」服务号回复”人工”，说明你的具体集成需求和场景，客服会帮你判断走 Skill 还是其它路径。

相关阅读