CommunityEscrita e Ediçãogithub.com

Deco BE85

Conjunto de Skills de Agente para Claude Code, Codex e Antigravity.

O que é Deco BE85?

Este skill fornece ao agente IA acesso direto à API local do roteador TP-Link Deco BE85 através de um wrapper FastAPI hospedado em `https://deco.msageha.net/api`. Ele permite que o agente realize operações de monitoramento e configuração da rede, como visualizar painéis de WAN/CPU/memória, listar dispositivos e clientes conectados, gerenciar configurações de Wi-Fi (SSID, senha, canais, liga/desliga por banda), e até reiniciar os módulos Deco. O servidor gerencia a autenticação com o roteador de forma lazy – a primeira chamada pode ser mais lenta, e sessões expiradas são renovadas automaticamente. O agente deve sempre solicitar confirmação do usuário antes de executar ações destrutivas, como reinicialização da rede ou alteração de configurações de Wi-Fi, pois essas operações podem desconectar clientes temporariamente. O skill suporta plataformas Claude Code e Codex, e todas as requisições são serializadas para garantir uma única sessão ativa com o roteador.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add msageha/skills

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Deco BE85 faz?

URL Base: https://deco.msageha.net/api (wrapper FastAPI em torno da API local do TP-Link Deco BE85). Requisições a esta instância não precisam de cabeçalho/cookie de autenticação — o servidor faz login no roteador automaticamente com credenciais armazenadas.

Fatos importantes

  • O login no roteador é tardio: a primeira chamada após a inicialização/ociosidade o aciona e é mais lenta. Sessões expiradas são re-logadas e repetidas automaticamente.
  • Requisições são serializadas por um lock no lado do servidor (sessão única do roteador). Chame os endpoints sequencialmente; não dispare requisições em paralelo.
  • band é band2_4 / band5_1 / band6; network é host / guest.
  • GET /wireless retorna ssid/password codificados em base64; endpoints de escrita aceitam texto simples (o servidor os codifica).
  • Confirme com o usuário antes de qualquer escrita: alternâncias/alterações de configuração de Wi-Fi desconectam clientes naquela banda brevemente, POST /reboot (requer confirm: true) derruba toda a rede por minutos, e POST /raw com uma operation não-leitura pode alterar configurações arbitrárias do roteador.
  • Erros: 401 falha de autenticação do roteador, 502 erro no lado do roteador (detail + error_code), 504 roteador inalcançável, 400/422 validação de requisição.

Operações principais

TarefaEndpoint
Visão geral (WAN/CPU/mem/nós e contagens de clientes)GET /dashboard
Unidades Deco (nós de malha)GET /devices
Clientes conectadosGET /clients?online_only=true
Clientes bloqueadosGET /clients/blocked
Configurações de Wi-Fi (todas as bandas, host/guest)GET /wireless
Wi-Fi LIGA/DESLIGA por bandaPOST /wireless
Alterar SSID/senha/canal etc.POST /wireless/config
Status WAN / internet / LAN / IPv6GET /network/wan, /network/internet, /network/lan, /network/ipv6
Uso de CPU / memóriaGET /network/performance
Reinicializar unidades Deco (destrutivo)POST /reboot
Qualquer outro endpoint do Deco (saída de emergência)POST /raw
Status do servidor / login explícitoGET /health, POST /login, POST /logout

Esquemas completos de requisição/resposta e exemplos curl prontos para uso: veja references/api-reference.md e references/commands.md.

Habilidades Relacionadas