feishu-docx

Feishu Docx Exporter

Feishu/Lark のクラウドドキュメントを Markdown 形式にエクスポートして、AI 分析に利用できます。

手順

セットアップ（一度のみ）

1. ツールをインストールします。

pip install feishu-docx

2. Feishu アプリの認証情報を設定します。

feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET
# or use environment variables

3. OAuth で認証します（ブラウザーが開きます）。

feishu-docx auth

ドキュメントをエクスポートする

任意の Feishu ドキュメント URL を Markdown にエクスポートします。

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

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

対応するドキュメントの種類

• docx：Feishu クラウドドキュメント → 画像付き Markdown
• sheet：スプレッドシート → Markdown テーブル
• bitable：多次元テーブル → Markdown テーブル
• wiki：ナレッジベースのノード → 自動で解決してエクスポート

例

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 エージェントに推奨）

# 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 auth	OAuth 認証
feishu-docx config set	認証情報を設定
feishu-docx config show	現在の設定を表示
feishu-docx config clear	トークンキャッシュをクリア

ヒント

• 画像は、ドキュメント名のフォルダーに自動でダウンロードされます。
• HTML の代わりに Markdown テーブルを使用するには、--table md を指定します。
• トークンはキャッシュされ、自動更新されるため、再認証は不要です。
• Lark（海外版）の場合は、--lark フラグを追加します。