feishu-drive

Feishu Drive ツール

クラウドストレージ操作用の単一のツール feishu_drive です。

トークンの抽出

URL https://xxx.feishu.cn/drive/folder/ABC123 から → folder_token = ABC123

アクション

フォルダーの内容を一覧表示

{ "action": "list" }

ルートディレクトリ（folder_token なし）。

{ "action": "list", "folder_token": "fldcnXXX" }

戻り値：トークン、名前、種類、URL、タイムスタンプを含むファイル。

ファイル情報の取得

{ "action": "info", "file_token": "ABC123", "type": "docx" }

ルートディレクトリ内のファイルを検索します。注：ファイルはルートにある必要があります。そうでない場合は、まず list を使ってフォルダーを参照してください。

type：doc、docx、sheet、bitable、folder、file、mindnote、shortcut

フォルダーの作成

{ "action": "create_folder", "name": "New Folder" }

親フォルダー内：

{ "action": "create_folder", "name": "New Folder", "folder_token": "fldcnXXX" }

ファイルの移動

{ "action": "move", "file_token": "ABC123", "type": "docx", "folder_token": "fldcnXXX" }

ファイルの削除

{ "action": "delete", "file_token": "ABC123", "type": "docx" }

ファイルの種類

種類	説明
doc	旧形式のドキュメント
docx	新形式のドキュメント
sheet	スプレッドシート
bitable	多次元テーブル
folder	フォルダー
file	アップロードされたファイル
mindnote	マインドマップ
shortcut	ショートカット

設定

channels:
  feishu:
    tools:
      drive: true  # default: true

権限

• drive:drive - フルアクセス（作成、移動、削除）
• drive:drive:readonly - 読み取り専用（一覧表示、情報取得）

既知の制限事項

• ボットにはルートフォルダーがありません：Feishu のボットは tenant_access_token を使用し、独自の「マイスペース」を持ちません。ルートフォルダーという概念はユーザーアカウントにのみ存在します。つまり、次のとおりです。
  • folder_token を指定せずに create_folder を実行すると失敗します（400 エラー）。
  • ボットは、共有されているファイル／フォルダーにのみアクセスできます。
  • 回避策：ユーザーがまず手動でフォルダーを作成してボットと共有すると、ボットはその中にサブフォルダーを作成できるようになります。