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.