ZLZLGe/feishu-automation

feishu-automation は何をしますか？

飛書ドキュメント、添付ファイル、Webhook通知のためのCodexスキルおよびMCPツール

概要

このスキルは、飛書（Feishu）のAPIを利用して、ドキュメントの作成、編集、添付ファイルのアップロード、Webhookによるメッセージ送信を可能にします。Codex（例：Claude Code）やMCP対応のAIエージェント（例：Claude Desktop）で使用できます。

ツール一覧

1. ドキュメント作成

• ツール名: create_document
• 説明: 指定したフォルダに新しい飛書ドキュメントを作成します。
• パラメータ:
  • title (必須): ドキュメントのタイトル
  • content (任意): ドキュメントの本文（Markdown形式）
  • folder_id (任意): 作成先のフォルダID（指定しない場合はルートフォルダ）

2. 添付ファイルのアップロード

• ツール名: upload_attachment
• 説明: 飛書にファイルを添付します（例：画像、PDF）。
• パラメータ:
  • file_path (必須): アップロードするファイルのパス
  • file_type (必須): ファイルのMIMEタイプ

3. Webhook通知

• ツール名: send_webhook
• 説明: カスタムWebhook URLにメッセージを送信します。
• パラメータ:
  • url (必須): Webhook URL
  • payload (必須): 送信するJSONペイロード

設定

使用前に以下の環境変数を設定してください：

• FEISHU_APP_ID: 飛書アプリのID
• FEISHU_APP_SECRET: 飛書アプリのシークレット
• FEISHU_WEBHOOK_URL (任意): デフォルトのWebhook URL

使用例

例1: 新しいドキュメントを作成する

create_document(
    title="週次レポート",
    content="# 週次レポート\n\n今週の進捗:\n- タスクA完了\n- タスクB進行中",
    folder_id="fld_xxxx"
)

例2: エラーレポートをWebhookで送信する

send_webhook(
    url=os.environ["FEISHU_WEBHOOK_URL"],
    payload={"msg_type": "text", "content": {"text": "エラーが発生しました: タイムアウト"}}
)

注意事項

• APIレート制限に注意してください。
• 機密情報は環境変数で管理してください。
• ドキュメントのcontentは最大10,000文字までです。