fing

by naamah75

Install this Skill

curl -fsSL -o fing.zip https://skill.seembox.com/api/v1/skills/fing/download && unzip fing.zip

SKILL.md About

---
name: fing
description: 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.
---

# Fing Local API

Use this skill for read-only Fing local monitoring data. Prefer summaries because device lists reveal private network inventory.

## Helper

Use the bundled helper:

```bash
python3 skills/fing/scripts/fing_helper.py --help
```

Environment defaults:

- `FING_API_HOST` — Fing agent host/IP, default `localhost`.
- `FING_API_PORT` — default `49090`.
- `FING_API_SCHEME` — default `http`.
- `FING_API_KEY` — API key.

The helper also loads `.env` from the current workspace directory.

Examples:

```bash
# Compact health/device summary
python3 skills/fing/scripts/fing_helper.py summary

# Device inventory summary
python3 skills/fing/scripts/fing_helper.py devices

# Raw API wrapper for debugging
python3 skills/fing/scripts/fing_helper.py devices --raw

# People/presence, Fing Desktop only
python3 skills/fing/scripts/fing_helper.py people
```

## Workflow

1. Start with `summary` to verify API reachability and device counts.
2. Use `devices` for inventory, online/offline checks, or finding unknown devices.
3. Use `people` only when Fing Desktop is expected; Fing Agent/Fingbox may return 503 for this endpoint.
4. 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.

## API reference

Read `references/api-summary.md` when endpoint details, response fields, or error meanings matter.

## Safety notes

- Do not expose full MAC/IP/name inventories outside Igor's direct context.
- Do not send detailed device lists proactively unless they indicate a real issue.
- The documented API is local HTTP with API key in query string; avoid logging command lines or URLs containing the real key.

_meta.json Metadata

{
  "ownerId": "kn7bdjsxkxxq711we6f0g0ykws81tdnk",
  "publishedAt": 1777616572765,
  "slug": "fing",
  "version": "1.0.0"
}