feishu-docx
Export Feishu/Lark cloud documents to Markdown. Supports docx, sheets, bitable, and wiki. Use this skill when you need to read, analyze, or reference content from Feishu knowledge base.
How do I install this agent skill?
npx skills add https://github.com/leemysw/agent-kit --skill feishu-docxIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates the conversion of Feishu/Lark documents into Markdown format using a third-party Python tool. The main security considerations are the installation of external code and the vulnerability to indirect prompt injection from external document content.
- Socketpass
No alerts
- Snykfail
Risk: HIGH · No issues
- Runlayerwarn
1/1 file flagged
What does this agent skill do?
Feishu Docx Exporter
Export Feishu/Lark cloud documents to Markdown format for AI analysis.
Instructions
Setup (One-time)
- Install the tool:
pip install feishu-docx
- Configure Feishu app credentials:
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET
# or use environment variables
- 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
| Command | Description |
|---|---|
feishu-docx export <URL> | Export document to Markdown |
feishu-docx auth | OAuth authorization |
feishu-docx config set | Set credentials |
feishu-docx config show | Show current config |
feishu-docx config clear | Clear token cache |
Tips
- Images are automatically downloaded to a folder named after the document
- Use
--table mdfor Markdown tables instead of HTML - Token is cached and auto-refreshed, no need to re-authorize
- For Lark (overseas), add
--larkflag
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/leemysw/agent-kit/feishu-docx">View feishu-docx on skillZs</a>