Claude用 WeChat チャネルプラグイン

Tool

概要

claude-plugin-weixin は、Anthropic の Claude Code(claude-code)向けに作られた WeChat(微信)チャネルプラグインです。WeChat iLink Bot API を利用して HTTP の長期ポーリング(long-poll)でメッセージを受け取り、ターミナル上から直接返信できます。外部に公開する webhook を用意する必要がないため、ローカルや制限されたネットワーク環境でも比較的容易に導入可能です。TypeScript ベースで Bun ランタイムを前提としており、Claude のプラグインマーケット経由でインストールして使います。(約300字)

GitHub

リポジトリの統計情報

  • スター数: 24
  • フォーク数: 0
  • ウォッチャー数: 24
  • コミット数: 6
  • ファイル数: 9
  • メインの言語: TypeScript

主な特徴

  • WeChat iLink Bot API を用いた HTTP 長期ポーリングで実装(Webhook 非依存)
  • Claude Code と直接連携できるプラグイン形式(マーケットプレイス経由で導入)
  • Bun ランタイム向けの高速な実行環境と TypeScript による型付き実装
  • ローカル端末での受信・返信に重点を置いたシンプルなアーキテクチャ

技術的なポイント

このプラグインは WeChat の iLink Bot API を HTTP long-polling で扱う点が最も特徴的です。long-poll によってサーバー側からの即時通知を受け取る代わりにクライアントが継続的にリクエストを投げて更新を取得します。login-poll.ts のようなファイルは、セッションの確立、QR ログインの監視、ポーリングループ、再接続戦略(タイムアウト・バックオフ)を担う設計になっていると想定できます。.mcp.json は Claude のマーケットプレイス向け manifest で、プラグインのエンドポイントや権限・メタ情報を定義する役割です。.claude-plugin ディレクトリはパッケージングやプラグインメタデータ格納に用いられる構成です。Bun を選んでいるのは高速な起動とネイティブの fetch/JS 実行特性を活かすためで、TypeScript をそのまま実行・ビルドできる利点があります。設計上は WeChat のメッセージ形式を Claude のプラグイン API に適合させる変換ロジック(テキスト、画像、イベント)、非同期処理とエラーハンドリング、レート制限や接続の安定化、認証情報(トークン/クッキー)の安全な保管が重要になります。Webhook を使わないため外部公開のコストやセキュリティ面での利点がある一方、常時ポーリングによる接続維持の実装や長期運用時のリコネクション処理、WeChat 側の接続制約に注意が必要です。(約700字)

プロジェクトの構成

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

  • .claude-plugin: dir
  • .gitignore: file
  • .mcp.json: file
  • README.md: file
  • login-poll.ts: file

…他 4 ファイル

(上記はリポジトリの主要構成を抜粋したものです。login-poll.ts がポーリングとログインロジック、.mcp.json がマーケットプレイス向けメタ情報、.claude-plugin がパッケージ情報を担う想定です)

使いどころと注意点

  • ローカルや開発用途で WeChat メッセージを Claude から操作したいときに有用です。
  • 公開Webhookを用意できない環境での連携手段として有効ですが、常時ポーリングは接続の安定化とリソース管理が課題になります。
  • Bun ランタイム依存なので、環境構築(Bun のインストール)と Node.js との違いに留意してください。
  • 認証情報の管理(QRログイン後のセッション保存や暗号化)は自前で対処する必要がある点に注意してください。

まとめ

短時間でWeChatとClaudeをつなげる実用的なローカル向けプラグインです。(約50字)

リポジトリ情報:

READMEの抜粋:

claude-channel-weixin

WeChat (微信) channel plugin for Claude Code — receive and reply to WeChat messages directly in your terminal.

Uses the WeChat iLink Bot API with HTTP long-poll. No public webhook needed.

Prerequisites

Install

# Add the marketplace (one-time)
claude plugin marketplace add m1heng/claude-plugins

# Install the plugin
claude plugin inst...