‹ 首页

feishu-fetch-doc

@qianleigood · 收录于 昨天 · 上游提交 1 个月前

获取飞书云文档内容。返回文档的 Markdown 内容,支持处理文档中的图片、文件和画板(需配合 feishu_doc_media 工具)。

适合你,如果需要从飞书文档中提取内容并转换为 Markdown 格式。

/ 通过 npx 安装 校验哈希
npx oh-my-skill add qianleigood/crawclaw/feishu-fetch-doc
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- qianleigood/crawclaw/feishu-fetch-doc
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify qianleigood/crawclaw/feishu-fetch-doc
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
30GitHub stars
~741上下文体积 · 单文件
索引托管

怎么用

商店整理自技能原文 · 版本 f27e175 · 表述以原文为准
它做什么

装上后,Claude 会读取飞书云文档并返回 Markdown 内容。文档中的图片、文件、画板会被标记为 HTML 标签,需要额外调用另一个工具才能下载。

什么时候触发

当用户提供飞书文档的 URL 或 token(如 docx 或 wiki 链接)时触发。

装好后可以这样说
按步骤操作可下载媒体文件。
技能原文 SKILL.md作者撰写 · MIT · f27e175

feishu_mcp_fetch_doc

获取飞书云文档的 Markdown 内容(Lark-flavored 格式)。

重要:图片、文件、画板的处理

文档中的图片、文件、画板需要通过 feishu_doc_media(action: download)工具单独获取!

识别格式

返回的 Markdown 中,媒体文件以 HTML 标签形式出现:

  • 图片

``html <image token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" width="1833" height="2491" align="center" /> ``

  • 文件

``html <view type="1"> <file token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" name="skills.zip" /> </view> ``

  • 画板: ```html <whiteboard token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" /> ```
获取步骤
  1. 从 HTML 标签中提取 token 属性值
  2. 调用 feishu_doc_media 下载: ```json { "action": "download", "resource_token": "提取的token", "resource_type": "media", "output_path": "/path/to/save/file" } ```
参数
  • doc_id(必填):支持直接传文档 URL 或 token
  • 直接传 URL:https://xxx.feishu.cn/docx/Z1FjxxxxxxxxxxxxxxxxxxxtnAc(系统自动提取 token)
  • 直接传 token:Z1FjxxxxxxxxxxxxxxxxxxxtnAc
  • 知识库 URL/token 也支持:https://xxx.feishu.cn/wiki/Z1FjxxxxxxxxxxxxxxxxxxxtnAcZ1FjxxxxxxxxxxxxxxxxxxxtnAc
Wiki URL 处理策略

知识库链接(/wiki/TOKEN)背后可能是云文档、电子表格、多维表格等不同类型的文档。当不确定类型时, 不能直接假设是云文档,必须先查询实际类型。

处理流程
  1. 先调用 feishu_wiki_space_node(action: get)解析 wiki token: ```json { "action": "get", "token": "wiki_token_here" } ```
  2. 从返回的 node 中获取 obj_type(实际文档类型)和 obj_token(实际文档 token)
  3. 根据 obj_type 调用对应工具

| obj_type | 工具 | 传参 | | --------- | ----------------------- | ----------------------------- | | docx | feishu_mcp_fetch_doc | doc_id = obj_token | | sheet | feishu_sheet | spreadsheet_token = obj_token | | bitable | feishu_bitable_* 系列 | app_token = obj_token | | 其他 | 告知用户暂不支持该类型 | — |

示例

用户:帮我看下这个文档 https://xxx.feishu.cn/wiki/ABC123

  1. 调用 feishu_wiki_space_node(action: get, token: ABC123)
  2. 返回 obj_type: "docx", obj_token: "doxcnXYZ789"
  3. 调用 feishu_mcp_fetch_doc(doc_id: doxcnXYZ789)
工具组合

| 需求 | 工具 | | -------------------- | --------------------------------------- | | 获取文档文本 | feishu_mcp_fetch_doc | | 下载图片/文件/画板 | feishu_doc_media(action: download) | | 解析 wiki token 类型 | feishu_wiki_space_node(action: get) | | 读写电子表格 | feishu_sheet | | 操作多维表格 | feishu_bitable_* 系列 |

按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。