用途:获取飞书云文档内容,返回 Lark-flavored Markdown 格式文本。
主要能力:支持直接传文档 URL 或 token(doc_id 必填),系统会自动从 URL 提取 token;也支持知识库(wiki)URL 或 token。
媒体处理:文档中的图片、文件、画板不会直接返回内容,需通过 feishu_doc_media(action: download)单独获取。返回的 Markdown 中媒体以 HTML 标签形式出现,例如图片 <image token="..."/>、文件 <view type="1"><file token="..." name="..."/></view>、画板 <whiteboard token="..."/>。使用步骤为:先从标签中提取 token 属性值,再调用 feishu_doc_media 下载,参数包括 action: download、resource_token、resource_type: media、output_path。
Wiki 处理策略:知识库链接(/wiki/TOKEN)背后可能是云文档、电子表格、多维表格等不同类型,不能直接假设为云文档。需先调用 feishu_wiki_space_node(action: get)解析 wiki token,从返回 node 中获取 obj_type 和 obj_token,再按类型调用对应工具:docx 用 feishu_mcp_fetch_doc(doc_id=obj_token);sheet 用 feishu_sheet(spreadsheet_token=obj_token);bitable 用 feishu_bitable_* 系列(app_token=obj_token);其他类型则告知用户暂不支持。
工具组合:获取文档文本用 feishu_mcp_fetch_doc;下载图片/文件/画板用 feishu_doc_media;解析 wiki token 类型用 feishu_wiki_space_node;读写电子表格用 feishu_sheet;操作多维表格用 feishu_bitable_* 系列。
限制:媒体内容需额外调用工具获取;wiki 链接需先解析类型;其他文档类型暂不支持。