skill-unifi/README.md

skill-unifi

Skill local read-only de Claude Code para diagnosticar el UDM Pro del beneficio Rio Frio (192.168.87.5) vía la Integration API oficial de UniFi Network y la Classic API (cookie + CSRF).

Mirror público del directorio local ~/.claude/skills/unifi/ en la PC del usuario humano. Existe para que el usuario pueda auditar lo que el bot hace contra el UDM. Clonar y correr en otra máquina no funciona out-of-the-box — requiere API key del UDM en .env (no incluido) y estar en la LAN del beneficio (192.168.87.0/24).

Doc principal

Ver SKILL.md — diseño, modelo de seguridad (read-only por rol del bot + script guard), flujos típicos de diagnóstico.

Cheat sheet en endpoints.md y mapa de MACs/IPs → equipos en topology.md.

Estructura

.
├── SKILL.md             ← docs canónicas
├── endpoints.md         ← cheat sheet Integration + Classic API
├── topology.md          ← mapa MAC/IP → equipo/facility
├── .env.example
├── .gitignore
├── README.md            ← este archivo
└── scripts/
    ├── query.sh         ← wrapper Integration API (X-API-KEY)
    └── query-classic.sh ← wrapper Classic API (cookie + CSRF, cache 25 min)

Lo que NO está en este repo

• .env (API key del UDM)
• .cache/ (cookies de session de la Classic API)

Dependencias

• curl
• jq (recomendado) o python para filtrar JSON
• LAN del beneficio (192.168.87.0/24) para alcanzar 192.168.87.5