# skill-unifi

Skill local read-only de [Claude Code](https://claude.com/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](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](endpoints.md)** y mapa de
MACs/IPs → equipos en **[topology.md](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`