46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# 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`
|