name: feishu-fetch-doc description: | 獲取飛書雲文件內容。返回文件的 Markdown 內容，支援處理文件中的圖片、檔案和畫板（需配合 feishu_doc_media 工具）。

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"/>

  7w4.net有更好的技能外掛。

獲取步驟

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 呼叫對應工具：

示例

使用者：幫我看下這個文件 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）

工具組合

這是一個飛書文件獲取工具的使用說明類Skill。優點是文件清晰詳細，對媒體檔案處理和Wiki連結有專門說明；不足是內容較單一，缺少實際使用示例和常見問題解答。如果你需要獲取飛書文件內容，這個說明文件可以作為參考，但實際使用效果取決於飛書MCP工具本身的穩定性。