关于 feishu-docx
feishu-docx 是将 Feishu/Lark 云文档导出为 Markdown 的命令行工具,适用于需要把文档内容用于 AI 分析的场景。它支持文档、表格、多维表格和知识库节点,并可将图片一并下载。
主要功能
- 01导出云文档为 Markdown
- 02支持表格和多维表格
- 03解析并导出知识库节点
- 04下载文档中的图片
- 05内容可输出到标准输出
适用场景
- 01将 Feishu 文档内容交给 AI Agent 分析
- 02把电子表格转换为 Markdown 表格
- 03导出知识库页面供后续处理
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ leemysw/ agent-kit --skill feishu-docx安装后在 Claude Code 中输入/feishu-docx确认已加载。
详细介绍
飞书 Docx 导出器
将飞书/Lark 云文档导出为 Markdown 格式,以供 AI 分析。
使用说明
设置(仅需一次)
- 安装工具:
pip install feishu-docx
- 配置飞书应用凭据:
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET
# or use environment variables
- 使用 OAuth 授权(将打开浏览器):
feishu-docx auth
导出文档
将任意飞书文档 URL 导出为 Markdown:
feishu-docx export "<FEISHU_URL>" -o ./output
导出的 Markdown 文件将以文档标题作为文件名保存。
支持的文档类型
- docx:飞书云文档 → Markdown(含图片)
- sheet:电子表格 → Markdown 表格
- bitable:多维表格 → Markdown 表格
- wiki:知识库节点 → 自动解析并导出
示例
导出知识库页面
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -o ./docs
使用自定义文件名导出文档
feishu-docx export "https://xxx.feishu.cn/docx/XYZ789" -o ./docs -n meeting_notes
将电子表格导出为 Markdown 表格
feishu-docx export "https://xxx.feishu.cn/sheets/DEF456" --table md
直接读取内容(推荐用于 AI Agent)
# Output content to stdout instead of saving to file
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" --stdout
# or use short flag
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -c
读取内容但不保存到文件(Python)
from feishu_docx import FeishuExporter
exporter = FeishuExporter(app_id="xxx", app_secret="xxx")
content = exporter.export_content("https://xxx.feishu.cn/wiki/xxx")
print(content)
命令参考
| 命令 | 说明 |
|---|---|
feishu-docx export <URL> | 将文档导出为 Markdown |
feishu-docx auth | OAuth 授权 |
feishu-docx config set | 设置凭据 |
feishu-docx config show | 显示当前配置 |
feishu-docx config clear | 清除令牌缓存 |
提示
- 图片会自动下载到以文档命名的文件夹中
- 使用
--table md可将表格导出为 Markdown 格式,而非 HTML - 令牌会缓存并自动刷新,无需重新授权
- 对于 Lark(海外版),请添加
--lark标志
评论
支持 Markdown