Communityライティング&編集github.com

msageha/skills

Claude Code / Codex / Antigravity 用の Agent Skills 集

skills とは?

このスキルは、TP-Link Deco BE85 メッシュWi-Fiルーターのローカル管理APIを、FastAPIラッパーを通じてエージェント(Claude Code, Codex, Antigravity)から操作できるようにします。エージェントは、ルーターのダッシュボード情報取得、接続クライアント一覧、Wi-Fi設定(SSID/パスワード変更、バンドごとのON/OFF)、再起動など、主要な管理操作をREST APIで実行できます。認証はサーバー側で管理されているため、各リクエストに認証ヘッダーは不要です。ただし、書き込み操作(Wi-Fi切り替えや再起動)はネットワークに一時的な影響を与えるため、ユーザーへの確認が必須です。エラーハンドリングも充実しており、ルーター認証失敗(401)、ルーター内部エラー(502)、到達不能(504)などに対応しています。

対応✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add msageha/skills

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Deco BE85

Base URL: https://deco.msageha.net/api (TP-Link Deco BE85 ローカルAPI の FastAPI ラッパー)。このインスタンスへのリクエストには認証ヘッダー/クッキーは不要 — サーバーが保存された認証情報を使ってルーターにログインします。

重要なポイント

  • ルーターへのログインは遅延実行されます:起動後またはアイドル後の最初の呼び出しでログインがトリガーされ、その呼び出しは遅くなります。期限切れのセッションは自動的に再ログインされ、リトライされます。
  • リクエストはサーバー側のロック(単一ルーターセッション)によって直列化されます。エンドポイントは順番に呼び出してください。並列リクエストは行わないでください。
  • band は band2_4 / band5_1 / band6、network は host / guest です。
  • GET /wireless は ssid/password を Base64 エンコードして返します。書き込みエンドポイントは平文で受け付けます(サーバーがエンコードします)。
  • 書き込み操作の前にユーザーに確認してください:Wi-Fi の切り替え/設定変更はそのバンドのクライアントを一時的に切断します。POST /reboot(confirm: true が必要)はネットワーク全体を数分間ダウンさせます。POST /raw を読み取り以外の operation で使うとルーターの任意の設定を変更できます。
  • エラー:401 ルーター認証失敗、502 ルーター側エラー(detail + error_code)、504 ルーター到達不能、400/422 リクエスト検証エラー。

コア操作

タスクエンドポイント
概要(WAN/CPU/メモリ/ノード & クライアント数)GET /dashboard
Deco ユニット(メッシュノード)GET /devices
接続中のクライアントGET /clients?online_only=true
ブロックされたクライアントGET /clients/blocked
Wi-Fi 設定(全バンド、ホスト/ゲスト)GET /wireless
バンドごとの Wi-Fi ON/OFFPOST /wireless
SSID/パスワード/チャンネル等の変更POST /wireless/config
WAN / インターネット / LAN / IPv6 状態GET /network/wan、GET /network/internet、GET /network/lan、GET /network/ipv6
CPU / メモリ使用率GET /network/performance
Deco ユニットの再起動(破壊的操作)POST /reboot
その他の Deco エンドポイント(脱出用)POST /raw
サーバーヘルスチェック / 明示的ログインGET /health、POST /login、POST /logout

完全なリクエスト/レスポンススキーマおよび実行可能な curl の例は、references/api-reference.md および references/commands.md を参照してください。

関連スキル