mcpField
F
feishu-wiki

feishu-wiki

github.com/alextangson生産性6467 回インストール31 週間前に更新
リポジトリ

feishu-wiki について

feishu-wikiは、Wiki v2 APIを通じてFeishuのナレッジスペースとページノードを管理するスキルです。スペースの作成・照会に加え、ドキュメントなどに関連付けたノードの作成、取得、移動に対応します。

主な機能

  1. 01ナレッジスペースの作成と一覧取得
  2. 02スペース詳細の取得
  3. 03Wikiページノードの作成
  4. 04ノードの取得と移動
  5. 05既存ドキュメントとのノード連携

活用シーン

  1. 01Feishuのナレッジスペースを作成
  2. 02ドキュメントに紐づくWikiページを作成
  3. 03ページの配置場所を変更
  4. 04ナレッジスペース内のノードを確認

インストール

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

$npx skills add https://github.com/alextangson/feishu_skills --skill feishu-wiki

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

詳細

Feishu ナレッジベース

Wiki v2 API を使用して、ナレッジスペースとページノードを管理します。

Base URL: https://open.feishu.cn/open-apis/wiki/v2

認証と Token の取得

feishu_skills のルートディレクトリから共有スクリプトを実行します。

TOKEN="$(./scripts/get_feishu_token.sh)"

リクエストヘッダーには一律で Authorization: Bearer ${TOKEN} を使用します。

業務 API から無効なトークン、期限切れ、または 401 が返された場合は、強制的に更新してから元のリクエストを一度だけ再試行します。

TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"

環境変数:

  • FEISHU_APP_ID
  • FEISHU_APP_SECRET

ローカルキャッシュ: ./.feishu_token_cache.json（有効期限内であればそのまま再利用し、デフォルトでは期限の 5 分前に更新します）

ナレッジスペース

APIエンドポイント説明
スペースを作成POST /spaces{"name":"知识库名称"}
一覧を取得GET /spaces-
詳細を取得GET /spaces/{space_id}-

⚠️ 権限の付与：スペースを作成した後、ボットにはデフォルトで管理権限がありません。以下を推奨します。

  1. ボットを含むグループを作成する
  2. ナレッジベースの【設定】で、そのグループを「管理者」に追加する
  3. ボットはグループの権限で操作できるようになります

ページノード

APIエンドポイント説明
ノードを作成POST /spaces/{space_id}/nodesWiki ページを作成します
ノードを取得GET /spaces/{space_id}/nodes/{node_token}-
ノードを移動POST /spaces/{space_id}/nodes/{node_token}/move-

ノードの作成:

{
  "obj_type": "docx",
  "parent_node_token": "root",
  "node_type": "origin",
  "origin_node_token": "doxcnXXX",
  "title": "页面标题"
}

obj_type: doc / sheet / mindnote / bitable / file / docx

ベストプラクティス

  1. グループへの権限付与（権限の問題を解決）
  2. 先にドキュメントを作成してから関連付ける（origin_node_token）
  3. ナレッジを蓄積する用途に適しています

コメント

Markdown 対応