feishu-fetch-doc

npx skills add nexu-io/nexu --skill feishu-fetch-doc --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# 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` 中