在开发 DeepSeek Harness 智能体时,处理内容分发是常见需求。直接调用 Notion API 需要编写复杂的 JSON 构建逻辑,且需要处理 API Token 的存储与刷新。这个插件通过 MCP 服务器,把 Markdown 文本直接转换为 Notion API 接受的 JSON 格式,简化了集成流程。
插件定位¶
这是一个由 xby-skill 维护的 MCP 服务器插件,用于将 Markdown 内容转换为 Notion API 兼容格式。它主要面向内容管理和开发集成场景,旨在减少开发者编写转换逻辑的代码量。
核心功能¶
插件提供了两个核心工具:
set_xby_apikey:在聊天中设置 API 密钥。该密钥会自动持久化保存,重启 DSH 进程后依然有效。markdown_to_notion:将 Markdown 文本内容转换为 Notion 页面内容所需的 JSON 结构。
安装与启用¶
在终端中执行以下命令即可安装插件:
dsh plugin --profile web add github:xby_skill/xby-markdown-to-notion
安装完成后,重启 DSH 进程,插件即可加载使用。
典型用法¶
使用该插件前,需要先完成 API 密钥的获取。
- 获取密钥:前往 小笨羊官网 注册并获取 API 密钥。
- 设置密钥:在对话中调用
set_xby_apikey工具,传入你的 API 密钥。 - 执行转换:调用
markdown_to_notion工具,将准备好的 Markdown 文本作为参数传入。
适用场景与注意事项¶
该插件适合需要将 Markdown 文档快速同步到 Notion 系统的开发者或内容创作者。
注意事项:
* 插件以当前 DSH 进程的权限运行。在安装前,建议检查插件的源码仓库(GitHub)以确认其行为符合预期。
* 必须先在小笨羊官网完成注册并获取 API 密钥才能正常使用。
该插件提供了轻量级的转换能力,降低了集成 Notion 的门槛。更多细节可参考插件目录或 GitHub 仓库。