mcpField
F
feishu-docx

feishu-docx

github.com/leemyswDocuments57299 installsUpdated 33w ago
Repository

About feishu-docx

feishu-docx is a command-line tool for exporting Feishu/Lark cloud documents to Markdown, including content intended for AI analysis. It handles documents, spreadsheets, bitable tables, and wiki nodes, and can download images alongside exports.

Key features

  1. 01Export cloud documents to Markdown
  2. 02Support sheets and bitable tables
  3. 03Resolve and export wiki nodes
  4. 04Download document images
  5. 05Print content to stdout

Use cases

  1. 01Prepare Feishu content for AI Agent analysis
  2. 02Convert spreadsheets into Markdown tables
  3. 03Export wiki pages for further processing

Install

Copy the command and run it in a terminal.

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

After installing, type/feishu-docxin Claude Code to confirm it loaded.

Details

From the project README

Feishu Docx Exporter

Export Feishu/Lark cloud documents to Markdown format for AI analysis.

Instructions

Setup (One-time)
  1. Install the tool:
pip install feishu-docx
  1. Configure Feishu app credentials:
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET
# or use environment variables
  1. Authorize with OAuth (opens browser):
feishu-docx auth
Export Documents

Export any Feishu document URL to Markdown:

feishu-docx export "<FEISHU_URL>" -o ./output

The exported Markdown file will be saved with the document's title as filename.

Supported Document Types
  • docx: Feishu cloud documents → Markdown with images
  • sheet: Spreadsheets → Markdown tables
  • bitable: Multidimensional tables → Markdown tables
  • wiki: Knowledge base nodes → Auto-resolved and exported

Examples

Export a wiki page
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -o ./docs
Export a document with custom filename
feishu-docx export "https://xxx.feishu.cn/docx/XYZ789" -o ./docs -n meeting_notes
Export spreadsheet as Markdown table
feishu-docx export "https://xxx.feishu.cn/sheets/DEF456" --table md
Read content directly (recommended for 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
Read content without saving to file (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)

Command Reference

CommandDescription
feishu-docx export <URL>Export document to Markdown
feishu-docx authOAuth authorization
feishu-docx config setSet credentials
feishu-docx config showShow current config
feishu-docx config clearClear token cache

Tips

  • Images are automatically downloaded to a folder named after the document
  • Use --table md for Markdown tables instead of HTML
  • Token is cached and auto-refreshed, no need to re-authorize
  • For Lark (overseas), add --lark flag

Comments

Markdown supported