CommunityRedacción y edicióngithub.com

msageha/skills

Colección de Skills para Agentes (Claude Code / Codex / Antigravity) que expone una API REST para gestionar routers TP-Link Deco BE85.

¿Qué es skills?

Este skill proporciona una API REST rápida (FastAPI) que envuelve la API local del router TP-Link Deco BE85, permitiendo a agentes de IA (Claude Code, Codex, Antigravity) monitorizar y configurar la red. La API maneja automáticamente la autenticación, sesiones expiradas y serialización de solicitudes, por lo que el agente solo debe realizar llamadas HTTP. Permite consultar el panel de control, listar nodos y clientes, cambiar ajustes Wi-Fi, reiniciar unidades o ejecutar operaciones raw. Es fundamental que el agente confirme con el usuario antes de cualquier operación de escritura, ya que cambios como desactivar Wi-Fi o reiniciar el router pueden causar desconexiones temporales. Soporta las bandas 2.4 GHz, 5 GHz y 6 GHz, y las redes host/guest.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Deco BE85

URL Base: https://deco.msageha.net/api (wrapper FastAPI alrededor de la API local del TP-Link Deco BE85). Las solicitudes a esta instancia no necesitan encabezados de autenticación ni cookies — el servidor inicia sesión en el router automáticamente con credenciales almacenadas.

Datos clave

  • El inicio de sesión en el router es perezoso: la primera llamada después del arranque/inactividad lo activa y es más lenta. Las sesiones expiradas se reinician y reintentan automáticamente.
  • Las solicitudes se serializan tras un bloqueo del lado del servidor (sesión única del router). Llama a los endpoints secuencialmente; no dispares solicitudes en paralelo.
  • band puede ser band2_4 / band5_1 / band6; network puede ser host / guest.
  • GET /wireless devuelve ssid/password codificados en base64; los endpoints de escritura los aceptan en texto plano (el servidor los codifica).
  • Confirma con el usuario antes de cualquier escritura: los cambios de Wi-Fi/alternar configuraciones desconectan brevemente los clientes en esa banda, POST /reboot (requiere confirm: true) deja toda la red fuera de servicio durante minutos, y POST /raw con una operation no de lectura puede cambiar ajustes arbitrarios del router.
  • Errores: 401 fallo de autenticación del router, 502 error del lado del router (detail + error_code), 504 router inalcanzable, 400/422 validación de solicitud.

Operaciones principales

TareaEndpoint
Resumen (conteo WAN/CPU/mem/nodo y cliente)GET /dashboard
Unidades Deco (nodos mesh)GET /devices
Clientes conectadosGET /clients?online_only=true
Clientes bloqueadosGET /clients/blocked
Ajustes Wi-Fi (todas las bandas, host/guest)GET /wireless
Wi-Fi ON/OFF por bandaPOST /wireless
Cambiar SSID/contraseña/canal etc.POST /wireless/config
Estado WAN / internet / LAN / IPv6GET /network/wan, /network/internet, /network/lan, /network/ipv6
Uso de CPU / memoriaGET /network/performance
Reiniciar unidades Deco (destructivo)POST /reboot
Cualquier otro endpoint Deco (escape)POST /raw
Salud del servidor / inicio de sesión explícitoGET /health, POST /login, POST /logout

Esquemas completos de solicitud/respuesta y ejemplos de curl listos para ejecutar: consulta references/api-reference.md y references/commands.md.

Skills relacionados