mcpField
F
feishu-doc-reader

feishu-doc-reader

github.com/zhangyongcunドキュメント0132 回インストール35 週間前に更新
リポジトリ

feishu-doc-reader について

feishu-doc-reader は、公式 Open API を使って Feishu と Lark の文書を抽出するコマンドラインスキルです。Wiki のリンクやトークンに対応し、利用するサービス地域を設定できます。

主な機能

  1. 01Docx を Markdown として抽出
  2. 02旧形式の Doc と Sheet を読み取り
  3. 03Wiki のリンクとトークンを解決
  4. 04文書の生ブロックを取得
  5. 05Feishu または Lark の API 接続を設定

活用シーン

  1. 01Feishu または Lark の Docx を抽出
  2. 02Sheet の表データを読み取り
  3. 03Wiki ページから元の文書を特定
  4. 04文書の生ブロックを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zhangyongcun/feishu-doc-reader --skill feishu-doc-reader

インストール後、Claude Code で/feishu-doc-readerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
.gitignore
CONTRIBUTING.md
requirements.txt
USAGE_EXAMPLES.md
INTEGRATION.md
test_optimization.py
reference/
feishu_config_sample.json
scripts/
get_blocks.sh
package_skill.py
get_feishu_doc_blocks.py
read_doc.sh
test_blocks_integration.py
test_auth.py
read_feishu_doc.py

詳細

Feishu/Lark ドキュメントリーダー

公式 Open API を使用して、Feishu（飞书）および Lark のドキュメントを読み取り、内容を抽出します。Feishu 中国版（open.feishu.cn）と Lark 国際版（open.larksuite.com）の両方に対応しています。

設定

認証情報の設定
  1. サンプルから ./reference/feishu_config.json を作成します。
{
  "app_id": "your_feishu_app_id",
  "app_secret": "your_feishu_app_secret",
  "api_base": "https://open.larksuite.com"
}

api_base を次のいずれかに設定します。

  • https://open.feishu.cn — Feishu 中国版
  • https://open.larksuite.com — Lark 国際版
  1. ファイルを保護します。
chmod 600 ./reference/feishu_config.json

または、環境変数 FEISHU_APP_ID、FEISHU_APP_SECRET、FEISHU_API_BASE を使用します。

使用方法

ドキュメントの読み取り

メインスクリプトは、Wiki URL、Wiki トークン、またはドキュメントトークンを受け取ります。

# Wiki URL (auto-extracts token and resolves to document)
python scripts/read_feishu_doc.py "https://tenant.larksuite.com/wiki/XYZ123"

# Wiki token (auto-resolves)
python scripts/read_feishu_doc.py "XYZ123"

# Document token (direct)
python scripts/read_feishu_doc.py "docx_AbCdEfGh"

# Simplified Markdown output
python scripts/read_feishu_doc.py "docx_AbCdEfGh" --format simple

# Read a spreadsheet
python scripts/read_feishu_doc.py "sheet_token" --type sheet
ドキュメントブロックの生データの取得
python scripts/get_feishu_doc_blocks.py "docx_AbCdEfGh"
シェルラッパー
./scripts/read_doc.sh "docx_token"
./scripts/get_blocks.sh "docx_token"
認証のテスト
python scripts/test_auth.py "app_id" "app_secret" "https://open.larksuite.com"

対応するドキュメントタイプ

  • Docx（新しいドキュメント）：表、見出し、コード、リストを含む完全な Markdown 抽出
  • Doc（旧形式）：基本的なメタデータとコンテンツ
  • Sheet：スプレッドシートデータの抽出
  • Wiki：Wiki API を使用して、実際のドキュメントタイプを自動的に解決

必要な API 権限

  • docx:document:readonly — ドキュメントの内容を読み取る
  • wiki:wiki:readonly — Wiki ページを読み取る（Wiki URL／トークンのサポートに必要）
  • sheets:spreadsheet:readonly — スプレッドシートを読み取る（任意）

エラー処理

  • 401：App ID／App Secret を確認してください
  • 403：API 権限を付与し、ドキュメントがアプリと共有されていることを確認してください
  • 404：ドキュメントトークンを確認してください
  • リージョンの誤り：Lark 国際版では open.larksuite.com を使用してください

セキュリティ

  • reference/feishu_config.json はコミットしないでください（.gitignore に登録済みです）
  • 認証情報ファイルには chmod 600 を使用してください
  • アクセストークンはメモリ内にのみキャッシュされます

コメント

Markdown 対応