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_docdoc_id = obj_tokensheet``feishu_sheetspreadsheet_token = obj_tokenbitable``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_* 系列