# Birdweather

> Query BirdWeather station data — species detections, trends, and comparisons from BirdNET-Pi and PUC bird song detection stations. Use when asked about bird sightings, bird song detections, local bird activity, BirdWeather stations, or wildlife audio monitoring. No API key required.

- Skill: `modbender/birdweather` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modbender/birdweather`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/birdweather/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/birdweather

---


# BirdWeather

CLI at `scripts/birdweather.py` for querying BirdWeather station data. No API key needed — all station data is public.

Find station IDs at https://app.birdweather.com/

## Commands

```bash
# Station info (name, location, status, last detection)
scripts/birdweather.py station <station_id>

# Species detected (default: today)
scripts/birdweather.py species <station_id> --period day|week|month --limit 50

# Species for date range
scripts/birdweather.py species <station_id> --from 2026-02-01 --to 2026-02-14

# Top species (compact, default: week)
scripts/birdweather.py top <station_id> --period week --limit 10

# Recent individual detections
scripts/birdweather.py detections <station_id> --limit 20

# Compare periods (shows new arrivals, departures, trends)
scripts/birdweather.py compare <station_id> --this week --last month

# Any command with raw JSON output
scripts/birdweather.py --json species <station_id> --period week
```

## Output

Species lists show detection count, common name, and scientific name:
```
    467  Eurasian Blue Tit (Cyanistes caeruleus)
    290  Eurasian Wren (Troglodytes troglodytes)
```

Compare shows arrivals, departures, and significant changes between periods.

## Notes

- Detection count ≠ bird count (one bird singing repeatedly = many detections)
- BirdNET AI classification can misidentify — unusual species may be false positives
- Stations go offline periodically — empty results may mean the station is down, not that there are no birds
- Period options: `day` (today), `week` (last 7 days), `month` (last 30 days)
- Stdlib only — no pip dependencies