Birdnet

Query BirdNET-Go bird detections. View recent birds, search by species, get detection details.

Security Scan

The skill's code and instructions are consistent with its stated purpose (querying a BirdNET-Go instance), request only curl/jq, read a local config file for the server URL, and do not ask for unrelated credentials or install arbitrary software.

Purpose & Capability

Name/description match the behavior: the script queries BirdNET-Go API endpoints. Required binaries (curl, jq) are appropriate and no unrelated credentials, files, or services are requested.

Instruction Scope

SKILL.md and scripts/birdnet.sh limit actions to reading a single config file (~/.clawdbot/credentials/birdnet/config.json) for the API URL and performing read-only GET requests against that API. There are no instructions to read unrelated files, modify system settings, or transmit data to third-party endpoints.

Install Mechanism

No install spec — instruction-only with a small helper script. Nothing is downloaded or extracted by the skill itself.

Credentials

The skill requires no environment variables or credentials. It reads a single well-scoped config path in the user's home directory; this is proportional to its purpose.

Persistence & Privilege

always is false and the skill does not request persistent platform privileges or modify other skills or system-wide settings. It only reads a user config file and makes network requests to the configured URL.

Assessment

This skill appears to do only what it says: query a BirdNET-Go server on the configured URL. Before installing, verify the config file's URL points to a trusted local device (the default 192.168.1.50 is a LAN address). If you set the URL to a public/unknown host, that host will receive your queries and any returned data — only use endpoints you trust. Review the included scripts if you want to confirm there are no additional network calls or writes, and ensure curl/jq are available on the system.

BirdNET-Go

Query your BirdNET-Go bird sound identification system.

Setup

Create ~/.clawdbot/credentials/birdnet/config.json:

{
  "url": "http://192.168.1.50:783"
}

No API key needed for local access.

Commands

List recent detections

bash scripts/birdnet.sh recent [limit]

Shows the most recent bird detections with confidence scores.

Search detections by species

bash scripts/birdnet.sh search "Common Raven"

Search for detections of a specific bird species.

Get detection details

bash scripts/birdnet.sh detection <id>

Get full details about a specific detection including weather data.

Get species info

bash scripts/birdnet.sh species "Corvus corax"

Get information about a species including rarity score and taxonomy.

Today's summary

bash scripts/birdnet.sh today

Summary of today's bird detections.

Output Format

Recent detections show:

• Common name (Scientific name)
• Confidence score (0.0-1.0)
• Date and time
• Verification status

API Endpoints Used

• GET /api/v2/detections - List detections
• GET /api/v2/detections/:id - Get detection details
• GET /api/v2/species - Get species information