SKILL.md
feishu_mcp_fetch_doc
获取飞书云文档的 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"/>
获取步骤
- 从 HTML 标签中提取
token属性值 - 调用
feishu_doc_media下载:{ "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
- 直接传 URL:
Wiki URL 处理策略
知识库链接(/wiki/TOKEN)背后可能是云文档、电子表格、多维表格等不同类型的文档。当不确定类型时, 不能直接假设是云文档,必须先查询实际类型。
处理流程
- 先调用
feishu_wiki_space_node(action: get)解析 wiki token:{ "action": "get", "token": "wiki_token_here" } - 从返回的
node中获取 (实际文档类型)和 (实际文档 token)
