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
CODEBLOCK0
Output
Species lists show detection count, common name, and scientific name:
CODEBLOCK1
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
BirdWeather
位于 scripts/birdweather.py 的命令行工具,用于查询 BirdWeather 站点数据。无需 API 密钥——所有站点数据均为公开数据。
在 https://app.birdweather.com/ 查找站点 ID。
命令
bash
站点信息(名称、位置、状态、最近检测记录)
scripts/birdweather.py station
检测到的物种(默认:今天)
scripts/birdweather.py species --period day|week|month --limit 50
指定日期范围内的物种
scripts/birdweather.py species --from 2026-02-01 --to 2026-02-14
热门物种(紧凑显示,默认:本周)
scripts/birdweather.py top --period week --limit 10
最近的单次检测记录
scripts/birdweather.py detections --limit 20
比较时间段(显示新出现、离开及趋势变化)
scripts/birdweather.py compare --this week --last month
任何命令均可添加原始 JSON 输出
scripts/birdweather.py --json species --period week
输出
物种列表显示检测次数、常用名和学名:
467 欧亚蓝山雀 (Cyanistes caeruleus)
290 鹪鹩 (Troglodytes troglodytes)
比较功能显示两个时间段之间的新出现物种、离开物种及显著变化。
说明
- - 检测次数 ≠ 鸟类数量(一只鸟反复鸣叫会产生多次检测记录)
- BirdNET AI 分类可能存在误判——不常见物种可能是误报
- 站点会定期离线——空结果可能表示站点离线,而非没有鸟类
- 时间段选项:day(今天)、week(最近7天)、month(最近30天)
- 仅使用标准库——无需 pip 依赖