Feishu Docx Exporter

Feishu/Lark クラウドドキュメントを Markdown にエクスポートして、AI での分析、編集、自動化を実現します。

セットアップ（1 回限り）

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

トークンは自動的にリフレッシュされます。ユーザーの操作は不要です。

オプション：ブラウザベースのエクスポート

export-browser には Playwright と Chromium ランタイムが必要です：

pip install playwright
playwright install chromium

ドキュメントのエクスポート

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

エクスポートされた Markdown ファイルは、ドキュメントのタイトルをファイル名として保存されます。

ドキュメントがパブリックまたは現在のブラウザセッションでのみ読み込み可能な場合は、以下を優先してください：

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

または既存の Playwright セッションを再利用します：

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

対応ドキュメント形式

• docx: Feishu クラウドドキュメント → 画像付き Markdown
• sheet: スプレッドシート → Markdown テーブル
• bitable: 多次元テーブル → Markdown テーブル
• wiki: ナレッジベースノード → 自動解決およびエクスポート
• パブリック/ブラウザで読み込み可能なドキュメント: ローカル画像と添付ファイル付きのブラウザベースのエクスポート

コマンドリファレンス

コマンド	説明
feishu-docx export <URL>	ドキュメントを Markdown にエクスポート
feishu-docx export-browser <URL>	実ブラウザセッションでローカルアセット付きでエクスポート
feishu-docx export-wechat <URL>	WeChat 記事を Markdown にエクスポート
feishu-docx create <TITLE>	新規ドキュメント作成
feishu-docx create --url <URL>	WeChat 記事からドキュメント作成
feishu-docx write <URL>	ドキュメントにコンテンツを追記
feishu-docx update <URL>	特定ブロックを更新
feishu-docx drive ls	アプリまたは個人クラウドスペースのファイルを一覧表示
feishu-docx drive perm-show <TOKEN>	パブリック権限を表示
feishu-docx drive perm-members <TOKEN>	権限メンバーを一覧表示
feishu-docx drive clear	ダブル確認付きでファイルをクリア
feishu-docx export-wiki-space <URL>	Wiki スペース全体をバッチエクスポート
feishu-docx export-workspace-schema <ID>	bitable データベーススキーマをエクスポート
feishu-docx auth	OAuth 認可
feishu-docx config set	認証情報を設定
feishu-docx config show	現在の設定を表示
feishu-docx config clear	トークンキャッシュをクリア
feishu-docx tui	インタラクティブ TUI インターフェース

例

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

パブリックまたはブラウザで読み込み可能なドキュメントを実ブラウザセッションでエクスポート

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

コンテンツを直接読み込む（AI Agent に推奨）

# ファイルに保存する代わりに、コンテンツを標準出力に出力
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" --stdout
# または短いフラグを使用
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -c

ブロック ID 付きでエクスポート（後で更新する場合）

# Markdown 出力に HTML コメントとしてブロック ID を含める
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" --with-block-ids
# または短いフラグを使用
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -b

Wiki スペース全体をバッチエクスポート

# Wiki スペース内のすべてのドキュメントをエクスポート（URL から space_id を自動抽出）
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./wiki_backup

# 深さの制限を指定
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./docs --max-depth 3

# 後で更新するためのブロック ID 付きでエクスポート
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./docs -b

データベーススキーマをエクスポート

# bitable/workspace データベーススキーマを Markdown としてエクスポート
feishu-docx export-workspace-schema <workspace_id>

# 出力ファイルを指定
feishu-docx export-workspace-schema <workspace_id> -o ./schema.md

ドキュメント編集（CLI）

ドキュメント作成

# 空白ドキュメントを作成
feishu-docx create "我的笔记"

# Markdown コンテンツ付きで作成
feishu-docx create "会议记录" -c "# 会议纪要\n\n- 议题一\n- 议题二"

# Markdown ファイルから作成
feishu-docx create "周报" -f ./weekly_report.md

# 特定フォルダに作成
feishu-docx create "笔记" --folder fldcnXXXXXX

# WeChat 記事 URL から作成
feishu-docx create --url "https://mp.weixin.qq.com/s/xxxxx"

フォルダトークンの取得方法:

1. ブラウザでターゲットフォルダを開く
2. URL からトークンを抽出：https://xxx.feishu.cn/drive/folder/fldcnXXXXXX
3. fldcnXXXXXX がフォルダトークン

既存ドキュメントにコンテンツを追記

# Markdown コンテンツを追記
feishu-docx write "https://xxx.feishu.cn/docx/xxx" -c "## 新章节\n\n内容"

# ファイルから追記
feishu-docx write "https://xxx.feishu.cn/docx/xxx" -f ./content.md

ドライブファイルを管理

# アプリクラウドスペースドキュメントを一覧表示
feishu-docx drive ls --auth-mode tenant --type docx

# 個人クラウドスペースドキュメントを一覧表示
feishu-docx drive ls --auth-mode oauth --type docx

# パブリック権限を表示
feishu-docx drive perm-show "https://xxx.feishu.cn/docx/ABC123"

# 権限メンバーを一覧表示
feishu-docx drive perm-members "https://xxx.feishu.cn/docx/ABC123"

# ダブル確認付きでファイルをクリア
feishu-docx drive clear --type docx

特定ブロックを更新

# ステップ 1：ブロック ID 付きでエクスポート
feishu-docx export "https://xxx.feishu.cn/docx/xxx" -b -o ./

# ステップ 2：HTML コメントからブロック ID を確認
# <!-- block:blk123abc -->
# # Heading
# <!-- /block -->

# ステップ 3：特定ブロックを更新
feishu-docx update "https://xxx.feishu.cn/docx/xxx" -b blk123abc -c "新内容"

AI Agent のためのヒント: 特定のセクションを更新する必要がある場合：

1. -b でエクスポートしてブロック ID を取得
2. HTML コメントからターゲットブロック ID を確認
3. そのブロック ID で feishu-docx update を使用

ヒント

• 画像と添付ファイルは、ローカルアセットが利用可能な場合、{doc_title}/ フォルダに自動ダウンロードされます
• パブリック共有リンクまたはブラウザで読み込み可能なドキュメントの場合は export-browser を優先してください
• コンテンツを直接出力するには --stdout または -c を使用（エージェントに推奨）
• 後で更新するために -b を使用してブロック ID 付きでエクスポート
• トークンは自動的にリフレッシュされ、再認可は不要です
• Lark（海外）の場合：--lark フラグを追加
• tenant_access_token はアプリクラウドスペースを管理し、user_access_token は個人クラウドスペースを管理します