{"skill":{"slug":"fing","displayName":"Fing Local API","summary":"Query and troubleshoot Fing Local API monitoring agents for local network device inventory, presence, online/offline state, people/presence where supported,...","description":"---\nname: fing\ndescription: Query and troubleshoot Fing Local API monitoring agents for local network device inventory, presence, online/offline state, people/presence where supported, and read-only homelab network checks. Use when Fing Desktop, Fing Agent, or Fingbox local API data is needed.\n---\n\n# Fing Local API\n\nUse this skill for read-only Fing local monitoring data. Prefer summaries because device lists reveal private network inventory.\n\n## Helper\n\nUse the bundled helper:\n\n```bash\npython3 skills/fing/scripts/fing_helper.py --help\n```\n\nEnvironment defaults:\n\n- `FING_API_HOST` — Fing agent host/IP, default `localhost`.\n- `FING_API_PORT` — default `49090`.\n- `FING_API_SCHEME` — default `http`.\n- `FING_API_KEY` — API key.\n\nThe helper also loads `.env` from the current workspace directory.\n\nExamples:\n\n```bash\n# Compact health/device summary\npython3 skills/fing/scripts/fing_helper.py summary\n\n# Device inventory summary\npython3 skills/fing/scripts/fing_helper.py devices\n\n# Raw API wrapper for debugging\npython3 skills/fing/scripts/fing_helper.py devices --raw\n\n# People/presence, Fing Desktop only\npython3 skills/fing/scripts/fing_helper.py people\n```\n\n## Workflow\n\n1. Start with `summary` to verify API reachability and device counts.\n2. Use `devices` for inventory, online/offline checks, or finding unknown devices.\n3. Use `people` only when Fing Desktop is expected; Fing Agent/Fingbox may return 503 for this endpoint.\n4. For proactive checks, alert only on actionable changes: API unreachable, auth failure, unexpectedly low/no visible devices, or important device state changes if Igor has defined watch targets.\n\n## API reference\n\nRead `references/api-summary.md` when endpoint details, response fields, or error meanings matter.\n\n## Safety notes\n\n- Do not expose full MAC/IP/name inventories outside Igor's direct context.\n- Do not send detailed device lists proactively unless they indicate a real issue.\n- The documented API is local HTTP with API key in query string; avoid logging command lines or URLs containing the real key.\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":338,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1777616572765,"updatedAt":1778492818233},"latestVersion":{"version":"1.0.0","createdAt":1777616572765,"changelog":"Initial Fing Local API helper skill with read-only devices, people, and summary diagnostics.","license":"MIT-0"},"metadata":null,"owner":{"handle":"naamah75","userId":"s1791qv11vxyde88z5y6792k0d83kwav","displayName":"Yngvarr_75","image":"https://avatars.githubusercontent.com/u/34965103?v=4"},"moderation":null}