获取飞书云文档的 Markdown 内容(Lark-flavored 格式)。
文档中的图片、文件、画板需要通过 feishu_doc_media(action: download)工具单独获取!
返回的 Markdown 中,媒体文件以 HTML 标签形式出现:
图片:
<image token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" width="1833" height="2491" align="center"/>
文件:
<view type="1">
<file token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" name="skills.zip"/>
</view>
画板:
<whiteboard token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc"/>
token 属性值feishu_doc_media 下载:
{
"action": "download",
"resource_token": "提取的token",
"resource_type": "media",
"output_path": "/path/to/save/file"
}
doc_id(必填):支持直接传文档 URL 或 token
https://xxx.feishu.cn/docx/Z1FjxxxxxxxxxxxxxxxxxxxtnAc(系统自动提取 token)Z1FjxxxxxxxxxxxxxxxxxxxtnAc
https://xxx.feishu.cn/wiki/Z1FjxxxxxxxxxxxxxxxxxxxtnAc 或 Z1FjxxxxxxxxxxxxxxxxxxxtnAc
知识库链接(/wiki/TOKEN)背后可能是云文档、电子表格、多维表格等不同类型的文档。当不确定类型时, 不能直接假设是云文档,必须先查询实际类型。
feishu_wiki_space_node(action: get)解析 wiki token:
{ "action": "get", "token": "wiki_token_here" }
node 中获取 obj_type(实际文档类型)和 obj_token(实际文档 token)
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
feishu_wiki_space_node(action: get, token: ABC123)obj_type: "docx", obj_token: "doxcnXYZ789"
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_* 系列 |