CommunityRédaction et éditiongithub.com

Deco BE85 Agent Skill

Compétences d'agent pour contrôler un routeur TP-Link Deco BE85 via une API FastAPI locale.

Qu'est-ce que Deco BE85 Agent Skill ?

Cette compétence permet à un agent AI (Claude Code, Cursor, Codex, etc.) d'interagir avec un routeur maillé TP-Link Deco BE85 via une API FastAPI locale. L'API sert d'intermédiaire : le serveur se connecte au routeur avec des identifiants stockés, évitant à l'agent de gérer l'authentification directe. Les opérations incluent la récupération de l'état du réseau (WAN, CPU, mémoire, clients connectés), la configuration Wi-Fi (activation/désactivation, changement de SSID/mot de passe/canal), et le redémarrage des unités Deco. La compétence est utile pour automatiser la gestion réseau, le dépannage à distance, ou l'intégration dans des workflows DevOps. Elle nécessite une confirmation utilisateur avant toute action destructive (comme le redémarrage ou la modification des paramètres Wi-Fi) et impose des appels séquentiels pour éviter les conflits de session. L'API est documentée avec des schémas de requête/réponse et des exemples curl prêts à l'emploi.

Compatible avec✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add msageha/skills

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Deco BE85

Base URL : https://deco.msageha.net/api (wrapper FastAPI autour de l'API locale du TP-Link Deco BE85). Les requêtes vers cette instance ne nécessitent aucun en-tête/cookie d'authentification — le serveur se connecte lui-même au routeur avec des identifiants stockés.

Points clés

  • La connexion au routeur est paresseuse : le premier appel après le démarrage ou une période d'inactivité déclenche la connexion et est plus lent. Les sessions expirées sont reconnectées et réessayées automatiquement.
  • Les requêtes sont sérialisées derrière un verrou côté serveur (session unique du routeur). Appelez les points d'accès de manière séquentielle ; n'envoyez pas de requêtes parallèles.
  • band correspond à band2_4 / band5_1 / band6 ; network correspond à host / guest.
  • GET /wireless renvoie ssid/password encodés en base64 ; les points d'accès d'écriture les acceptent en texte brut (le serveur les encode).
  • Confirmez avec l'utilisateur avant toute écriture : les bascules/configurations Wi-Fi déconnectent brièvement les clients sur cette bande, POST /reboot (nécessite confirm: true) met tout le réseau hors service pendant plusieurs minutes, et POST /raw avec une operation autre que lecture peut modifier des paramètres arbitraires du routeur.
  • Erreurs : 401 échec d'authentification du routeur, 502 erreur côté routeur (detail + error_code), 504 routeur injoignable, 400/422 validation de la requête.

Opérations principales

TâchePoint d'accès
Aperçu (WAN/CPU/mémoire/nœuds et clients)GET /dashboard
Unités Deco (nœuds maillés)GET /devices
Clients connectésGET /clients?online_only=true
Clients bloquésGET /clients/blocked
Paramètres Wi-Fi (toutes bandes, hôte/invité)GET /wireless
Wi-Fi ON/OFF par bandePOST /wireless
Changer SSID/mot de passe/canal etc.POST /wireless/config
Statut WAN / internet / LAN / IPv6GET /network/wan, /network/internet, /network/lan, /network/ipv6
Utilisation CPU / mémoireGET /network/performance
Redémarrer les unités Deco (destructeur)POST /reboot
Tout autre point d'accès Deco (échappatoire)POST /raw
Santé du serveur / connexion expliciteGET /health, POST /login, POST /logout

Schémas de requête/réponse complets et exemples curl prêts à l'emploi : voir references/api-reference.md et references/commands.md.

Skills associés