Feishu(飞书)Webhook スキル

Tool

概要

Feishu Webhook Skill は、Claude Code(Claude の拡張スキル)から Feishu(飞书 / Lark)へメッセージを送信するための小さな Python 製スキルです。Webhook エンドポイントを用いてプレーンテキスト、リッチテキスト(post)、インタラクティブなカード、画像付きメッセージといった多様なフォーマットを送信できます。Claude Code のスキル構成に組み込むだけで自動通知やチャット連携、レポート配信などに使え、実装は軽量で拡張しやすくなっています。README と SKILL.md に導入手順や使用例が用意されているため導入も比較的簡単です。

GitHub

リポジトリの統計情報

  • スター数: 22
  • フォーク数: 1
  • ウォッチャー数: 22
  • コミット数: 3
  • ファイル数: 11
  • メインの言語: Python

主な特徴

  • Claude Code スキルとしてそのまま組み込める設計(SKILL.md を同梱)。
  • プレーンテキスト、post(リッチテキスト)、カード、画像メッセージなどのフォーマットに対応。
  • 軽量な Python 実装で依存が少なく、拡張やカスタマイズが容易。
  • README に導入手順があり、導入までのコマンドや使い方が簡潔に示されている。

技術的なポイント

本リポジトリは「Webhook に対する JSON ペイロード生成」と「HTTP 送信」の役割にフォーカスしたシンプルな実装方針を採っています。Feishu のカスタム webhook は受け取る JSON 形式が複数あるため、実装はメッセージタイプごとにペイロードを組み立てるモジュール化が行われている想定です(text、post、interactive card、image など)。Python を用いることで requests 等の標準的 HTTP クライアントライブラリで POST 発行が可能で、エラーハンドリング(HTTP ステータス、タイムアウト)、ログ出力のフック、再試行/バックオフの追加など運用面の拡張が容易です。

Claude Code スキルとしての配置は SKILL.md に定義され、スキル登録時に必要なメタ情報やエントリーポイントが示されるため、Claude 側から関数を呼び出してそのまま通知を投げるワークフローが構築できます。セキュリティ面では Webhook URL 自体が秘匿情報になるため、環境変数やシークレット管理を用いて外部ファイルに平文で置かない運用を推奨します。また、将来的に HMAC-SHA256 による署名が必要な場合は署名生成ロジックを送信前に挟むことで対応可能です。最後に、メッセージテンプレート化(テンプレートエンジンによる投稿内容生成)や、送信結果を Claude 側へ戻すコールバック連携のような拡張も取り組みやすい構造です。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • CONTRIBUTING.md: file
  • LICENSE: file
  • README.md: file
  • SKILL.md: file

…他 6 ファイル

まとめ

Claude と Feishu を手軽に連携できる、実用的で拡張しやすいスキルです。

リポジトリ情報:

READMEの抜粋:

Feishu Webhook Skill

A Claude Code skill for sending messages to Feishu (飞书/Lark) via Webhook.

Overview

This skill enables Claude Code to send various types of messages to Feishu, including:

  • Plain text messages
  • Rich text (post) messages
  • Interactive card messages
  • Messages with images

Installation

Add this skill to your Claude Code configuration:

# Clone the repository
git clone https://github.com/viktorxhzj/feishu-webhook-skill.git

# Add to your Claude Code skills ...