mcpField
F
feishu-doc

feishu-doc

github.com/m1hengドキュメント4.2k1.9k 回インストール30 週間前に更新
リポジトリ

feishu-doc について

Feishuドキュメントを操作する`feishu_doc`ツールのガイドです。読み取り、作成、編集、ブロック管理、コメントに対応し、Markdown表には対応していません。

主な機能

  1. 01文書テキストと統計情報の読み取り
  2. 02内容の作成、置換、追記
  3. 03文書ブロックの読み取りと編集
  4. 04文書コメントの管理
  5. 05Markdownによる内容の書き込み

活用シーン

  1. 01Feishu文書と構造化ブロックの閲覧
  2. 02文書の作成と内容の記入
  3. 03文書内容の追記や置換
  4. 04文書コメントの確認や追加

MCP 対応

文書操作をアクション引数で行う単一ツール`feishu_doc`を説明するスキルです。MCPクライアントからFeishu文書の読み書き、ブロック管理、コメント操作に利用できます。

インストール

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

$npx skills add https://github.com/m1heng/clawdbot-feishu --skill feishu-doc

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

同梱ファイルreferences/block-types.md

詳細

Feishu Document ツール

コメント管理を含むすべてのドキュメント操作に対応する、アクションパラメーター付きの単一ツール feishu_doc です。

トークンの抽出

URL https://xxx.feishu.cn/docx/ABC123def の場合 → doc_token = ABC123def URL https://xxx.feishu.cn/docs/doccn123c の場合 → doc_token = doccn123c

アクション

ドキュメントを読む
{ "action": "read", "doc_token": "ABC123def" }

戻り値：タイトル、プレーンテキストのコンテンツ、ブロック統計。hint フィールドを確認してください。存在する場合は、list_blocks が必要な構造化コンテンツ（テーブル、画像）が含まれています。

ドキュメントを書き込む（すべて置換）
{ "action": "write", "doc_token": "ABC123def", "content": "# Title\n\nMarkdown content..." }

ドキュメント全体を Markdown コンテンツで置き換えます。見出し、リスト、コードブロック、引用、リンク、画像（![](url) で自動アップロード）、太字／斜体／取り消し線に対応しています。

制限事項： Markdown のテーブルには対応していません。

作成＋書き込み（アトミック、推奨）
{
  "action": "create_and_write",
  "title": "New Document",
  "content": "# Title\n\nMarkdown content..."
}

フォルダーを指定する場合：

{
  "action": "create_and_write",
  "title": "New Document",
  "content": "# Title\n\nMarkdown content...",
  "folder_token": "fldcnXXX"
}

1 回の呼び出しでドキュメントを作成し、コンテンツを書き込みます。create と write を個別に実行するより、こちらを優先してください。

コンテンツを追記
{ "action": "append", "doc_token": "ABC123def", "content": "Additional content" }

ドキュメントの末尾に Markdown を追記します。

ドキュメントを作成
{ "action": "create", "title": "New Document" }

フォルダーを指定する場合：

{ "action": "create", "title": "New Document", "folder_token": "fldcnXXX" }

空のドキュメントを作成します（タイトルのみ）。

ブロックを一覧表示
{ "action": "list_blocks", "doc_token": "ABC123def" }

テーブルや画像を含む、ブロックの完全なデータを返します。構造化コンテンツを読む場合に使用してください。

単一のブロックを取得
{ "action": "get_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }
ブロックのテキストを更新
{ "action": "update_block", "doc_token": "ABC123def", "block_id": "doxcnXXX", "content": "New text" }
ブロックを削除
{ "action": "delete_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }
コメントを一覧表示
{ "action": "list_comments", "doc_token": "ABC123def", "page_size": 50 }

ドキュメントのすべてのコメントを返します。ページネーションには page_token を使用してください。コメントには is_whole フィールドが含まれ、ドキュメント全体へのコメント（true）とブロック単位のコメント（false）を区別できます。

単一のコメントを取得
{ "action": "get_comment", "doc_token": "ABC123def", "comment_id": "comment_xxx" }
コメントを作成
{ "action": "create_comment", "doc_token": "ABC123def", "content": "Comment text" }
コメントへの返信を一覧表示
{ "action": "list_comment_replies", "doc_token": "ABC123def", "comment_id": "comment_xxx", "page_size": 50 }

page_size は正の整数を指定してください。省略した場合、ツールのデフォルト値は 50 です。

コメントの書き込み範囲

現在のツールで提供されている、ドキュメントに記載済みのコメント書き込みアクションは create_comment（全体コメントの作成）です。 返信を取得するには list_comment_replies を使用してください。現在の SDK の提供インターフェイスでは、返信を作成するエンドポイントは公開されていません。

読み取りワークフロー

  1. action: "read" から始めます。プレーンテキストと統計を取得します
  2. レスポンスで block_types を確認し、Table、Image、Code などのブロックを調べます
  3. 構造化コンテンツがある場合は、完全なデータを取得するために action: "list_blocks" を使用します

設定

channels:
  feishu:
    tools:
      doc: true  # default: true

注： feishu_wiki はこのツールに依存します。Wiki ページのコンテンツは feishu_doc を介して読み書きされます。

権限

必要な権限：docx:document、docx:document:readonly、docx:document.block:convert、drive:drive

コメント操作の場合：

  • コメントの読み取り：docx:document.comment:read
  • コメントの書き込み：docx:document.comment（create_comment 用、任意）

コメント

Markdown 対応