feishu-docx

Export, write, and manage Feishu/Lark cloud documents. Supports docx, sheets, bitable, wiki, WeChat article import/export, drive management, and browser-based export for public or browser-readable docs. Use this skill when you need to read, analyze, write, or manage content in a Feishu knowledge base.

install

source · Clone the upstream repo

git clone https://github.com/leemysw/feishu-docx

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/leemysw/feishu-docx "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.skills/feishu-docx" ~/.claude/skills/leemysw-feishu-docx-feishu-docx && rm -rf "$T"

manifest: .skills/feishu-docx/SKILL.md

source content

Feishu Docx Exporter

Export Feishu/Lark cloud documents to Markdown for AI analysis, writing, and automation.

Setup (One-time)

pip install feishu-docx
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

Token auto-refreshes. No user interaction required.

Optional: Browser-Based Export

export-browser

requires Playwright and a Chromium runtime:

pip install playwright
playwright install chromium

Export Documents

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

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

If the document is public or only readable in your current browser session, prefer:

feishu-docx export-browser "<FEISHU_OR_LARK_URL>" -o ./output

Or reuse an existing Playwright session:

feishu-docx export-browser "<FEISHU_OR_LARK_URL>" --storage-state ./storage_state.json

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
public/browser-readable docs: Browser-based export with local images and attachments

Command Reference

Command	Description
`feishu-docx export <URL>`	Export document to Markdown
`feishu-docx export-browser <URL>`	Export in a real browser session with local assets
`feishu-docx export-wechat <URL>`	Export WeChat article to Markdown
`feishu-docx create <TITLE>`	Create new document
`feishu-docx create --url <URL>`	Create document from WeChat article
`feishu-docx write <URL>`	Append content to document
`feishu-docx update <URL>`	Update specific block
`feishu-docx drive ls`	List app or personal cloud-space files
`feishu-docx drive perm-show <TOKEN>`	Show public permission
`feishu-docx drive perm-members <TOKEN>`	List permission members
`feishu-docx drive clear`	Clear files with double confirmation
`feishu-docx export-wiki-space <URL>`	Batch export entire wiki space
`feishu-docx export-workspace-schema <ID>`	Export bitable database schema
`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
`feishu-docx tui`	Interactive TUI interface

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 a public or browser-readable doc in a real browser session

feishu-docx export-browser "https://xxx.larkoffice.com/wiki/ABC123" -o ./browser_docs

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

Export with Block IDs (for later updates)

# Include block IDs as HTML comments in the Markdown output
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" --with-block-ids
# or use short flag
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -b

Batch Export Entire Wiki Space

# Export all documents in a wiki space (auto-extract space_id from URL)
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./wiki_backup

# Specify depth limit
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./docs --max-depth 3

# Export with Block IDs for later updates
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./docs -b

Export Database Schema

# Export bitable/workspace database schema as Markdown
feishu-docx export-workspace-schema <workspace_id>

# Specify output file
feishu-docx export-workspace-schema <workspace_id> -o ./schema.md

Write Documents (CLI)

Create Document

# Create empty document
feishu-docx create "我的笔记"

# Create with Markdown content
feishu-docx create "会议记录" -c "# 会议纪要\n\n- 议题一\n- 议题二"

# Create from Markdown file
feishu-docx create "周报" -f ./weekly_report.md

# Create in specific folder
feishu-docx create "笔记" --folder fldcnXXXXXX

# Create from a WeChat article URL
feishu-docx create --url "https://mp.weixin.qq.com/s/xxxxx"

如何获取 folder token:

在浏览器中打开目标文件夹

从 URL 中提取 token：

https://xxx.feishu.cn/drive/folder/fldcnXXXXXX

```
fldcnXXXXXX
```
就是 folder token

Append Content to Existing Document

# Append Markdown content
feishu-docx write "https://xxx.feishu.cn/docx/xxx" -c "## 新章节\n\n内容"

# Append from file
feishu-docx write "https://xxx.feishu.cn/docx/xxx" -f ./content.md

Manage Drive Files

# List app cloud-space documents
feishu-docx drive ls --auth-mode tenant --type docx

# List personal cloud-space documents
feishu-docx drive ls --auth-mode oauth --type docx

# Show public permission
feishu-docx drive perm-show "https://xxx.feishu.cn/docx/ABC123"

# List permission members
feishu-docx drive perm-members "https://xxx.feishu.cn/docx/ABC123"

# Clear files with double confirmation
feishu-docx drive clear --type docx

Update Specific Block

# Step 1: Export with Block IDs
feishu-docx export "https://xxx.feishu.cn/docx/xxx" -b -o ./

# Step 2: Find block ID from HTML comments
# <!-- block:blk123abc -->
# # Heading
# <!-- /block -->

# Step 3: Update the specific block
feishu-docx update "https://xxx.feishu.cn/docx/xxx" -b blk123abc -c "新内容"

Tip for AI Agents: When you need to update a specific section:
Export with
-b
to get block IDs
Find the target block ID from HTML comments
Use
feishu-docx update
with that block ID

Tips

Images and attachments auto-download to
```
{doc_title}/
```
folder when local assets are available
Prefer
```
export-browser
```
for public share links or browser-readable docs
Use
```
--stdout
```
or
```
-c
```
for direct content output (recommended for agents)
Use
```
-b
```
to export with block IDs for later updates
Token auto-refreshes, no re-auth needed
For Lark (overseas): add
```
--lark
```
flag
```
tenant_access_token
```
manages app cloud space,
```
user_access_token
```
manages personal cloud space