mcpField
F
feishu-docx

feishu-docx

github.com/leemysw文档处理57299 次安装33 周前更新
代码仓库

关于 feishu-docx

feishu-docx 是将 Feishu/Lark 云文档导出为 Markdown 的命令行工具,适用于需要把文档内容用于 AI 分析的场景。它支持文档、表格、多维表格和知识库节点,并可将图片一并下载。

主要功能

  1. 01导出云文档为 Markdown
  2. 02支持表格和多维表格
  3. 03解析并导出知识库节点
  4. 04下载文档中的图片
  5. 05内容可输出到标准输出

适用场景

  1. 01将 Feishu 文档内容交给 AI Agent 分析
  2. 02把电子表格转换为 Markdown 表格
  3. 03导出知识库页面供后续处理

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/leemysw/agent-kit --skill feishu-docx

安装后在 Claude Code 中输入/feishu-docx确认已加载。

详细介绍

飞书 Docx 导出器

将飞书/Lark 云文档导出为 Markdown 格式,以供 AI 分析。

使用说明

设置(仅需一次)
  1. 安装工具:
pip install feishu-docx
  1. 配置飞书应用凭据:
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET
# or use environment variables
  1. 使用 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 authOAuth 授权
feishu-docx config set设置凭据
feishu-docx config show显示当前配置
feishu-docx config clear清除令牌缓存

提示

  • 图片会自动下载到以文档命名的文件夹中
  • 使用 --table md 可将表格导出为 Markdown 格式,而非 HTML
  • 令牌会缓存并自动刷新,无需重新授权
  • 对于 Lark(海外版),请添加 --lark 标志

评论

支持 Markdown