Agent Skills › nexu-io/nexu › feishu-fetch-doc

feishu-fetch-doc

GitHub

获取飞书云文档Markdown内容，支持URL或Token输入。新增Wiki链接类型解析策略，自动识别并路由至对应工具处理文档、表格等多类型资源。

nexu-skills/skills/feishu-fetch-doc/SKILL.md nexu-io/nexu

Trigger Scenarios

用户请求读取飞书云文档内容用户提供飞书知识库链接需解析具体文档类型

Install

npx skills add nexu-io/nexu --skill feishu-fetch-doc -g -y

More Options

Non-standard path

npx skills add https://github.com/nexu-io/nexu/tree/main/nexu-skills/skills/feishu-fetch-doc -g -y

Use without installing

npx skills use nexu-io/nexu@feishu-fetch-doc

指定 Agent (Claude Code)

npx skills add nexu-io/nexu --skill feishu-fetch-doc -a claude-code -g -y

安装 repo 全部 skill

npx skills add nexu-io/nexu --all -g -y

预览 repo 内 skill

npx skills add nexu-io/nexu --list

SKILL.md

Frontmatter

{
    "tag": "file-knowledge",
    "icon": "FileSearch",
    "name": "feishu-fetch-doc",
    "prompt": "Help me read Feishu documents",
    "source": "official",
    "examples": [
        "帮我读取这个飞书文档的内容",
        "获取知识库中这篇文档的内容",
        "帮我查看这个文档链接里写了什么"
    ],
    "requires": {
        "plugins": [
            "@larksuite\/openclaw-lark"
        ]
    },
    "description": "获取飞书云文档内容。返回文档的 Markdown 内容，支持处理文档中的图片、文件和画板（需配合 feishu_doc_media 工具）。\n"
}

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

Wiki URL 处理策略

知识库链接（/wiki/TOKEN）背后可能是云文档、电子表格、多维表格等不同类型的文档。当不确定类型时, 不能直接假设是云文档，必须先查询实际类型。

处理流程

先调用 feishu_wiki_space_node（action: get）解析 wiki token：
```
{ "action": "get", "token": "wiki_token_here" }
```
从返回的 node 中获取 obj_type（实际文档类型）和 obj_token（实际文档 token）
根据 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

调用 feishu_wiki_space_node（action: get, token: ABC123）
返回 obj_type: "docx", obj_token: "doxcnXYZ789"
调用 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_*` 系列