feishu-fetch-doc

Original：🇺🇸 English
Translated

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

2installs
Sourcelarksuite/openclaw-lark
Added on

NPX Install

npx skill4agent add larksuite/openclaw-lark feishu-fetch-doc

Tags

Translated version includes tags in frontmatter
feishu-doc-fetchlark-doc-processingwiki-token-parsemedia-file-downloadfeishu-tool-integration

SKILL.md Content

View Translation Comparison →

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/Z1FjxxxxxxxxxxxxxxxxxxxtnAc
      或 
      Z1FjxxxxxxxxxxxxxxxxxxxtnAc

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_*
系列