飛書讀取雲文件

👤 a3152557994-ship-it 📦 v1.0.0 ⭐ 4.3 ⬇️ 865 下載
📚 知識管理 免費

📖 技能介紹

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

獲取步驟

  1. 從 HTML 標籤中提取 token 屬性值
  2. 呼叫 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

Wiki URL 處理策略

知識庫連結(/wiki/TOKEN)背後可能是雲文件、電子表格、多維表格等不同型別的文件。當不確定型別時, 不能直接假設是雲文件,必須先查詢實際型別。

處理流程

  1. 先呼叫 feishu_wiki_space_node(action: get)解析 wiki token:
    { "action": "get", "token": "wiki_token_here" }
  2. 從返回的 node 中獲取 obj_type(實際文件型別)和 obj_token(實際文件 token)
  3. 根據 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

  1. 呼叫 feishu_wiki_space_node(action: get, token: ABC123)

    這個技能的最新版本可以在7w4.net小蔥技能站找到。

  2. 返回 obj_type: "docx", obj_token: "doxcnXYZ789"
  3. 呼叫 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_* 系列

🤖 AI 評測

這個 Skill 質量還不錯,文件結構清晰、說明詳細,能很好地幫助使用者理解如何使用飛書文件獲取功能。它對媒體檔案處理和 Wiki 連結解析的說明比較實用。不過內容相對基礎,缺少一些實用資訊比如使用限制、常見錯誤處理等,整體功能覆蓋範圍有限,對於複雜的文件處理需求可能不夠用。

📊 多維度評分

適應性4.4
規範性4
有效性4.4
可靠性4.2
可信度5

📁 包含檔案 (2 個)

📄 SKILL.md 2.9 KB
📄 _meta.json 134 B