← Back to Skills Marketplace
556
Downloads
2
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install birdweather
Description
Query BirdWeather station data — species detections, trends, and comparisons from BirdNET-Pi and PUC bird song detection stations. Use when asked about bird...
README (SKILL.md)
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
# Station info (name, location, status, last detection)
scripts/birdweather.py station \x3Cstation_id>
# Species detected (default: today)
scripts/birdweather.py species \x3Cstation_id> --period day|week|month --limit 50
# Species for date range
scripts/birdweather.py species \x3Cstation_id> --from 2026-02-01 --to 2026-02-14
# Top species (compact, default: week)
scripts/birdweather.py top \x3Cstation_id> --period week --limit 10
# Recent individual detections
scripts/birdweather.py detections \x3Cstation_id> --limit 20
# Compare periods (shows new arrivals, departures, trends)
scripts/birdweather.py compare \x3Cstation_id> --this week --last month
# Any command with raw JSON output
scripts/birdweather.py --json species \x3Cstation_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
Usage Guidance
This skill appears to do exactly what it claims: call the public BirdWeather API and print results. If you plan to run it, consider running in a controlled environment (or inspect the script locally) because it does make outbound HTTPS requests to app.birdweather.com. Do not provide any credentials (none are needed). If you expected a hosted/official source or a homepage for the skill, ask the publisher for provenance; lack of a homepage means you should verify the origin before granting broad runtime privileges in sensitive environments.
Capability Analysis
Type: OpenClaw Skill
Name: birdweather
Version: 1.0.0
The skill bundle is benign. The `SKILL.md` provides clear, non-malicious instructions for querying BirdWeather station data. The `scripts/birdweather.py` script uses `urllib.request` to make HTTP GET requests exclusively to the hardcoded `https://app.birdweather.com/api/v1` endpoint, which is consistent with its stated purpose. There is no evidence of data exfiltration, malicious execution (e.g., shell injection, `eval`), persistence mechanisms, obfuscation, or prompt injection attempts against the agent. All network activity is confined to the legitimate BirdWeather API.
Capability Assessment
Purpose & Capability
Name/description state the skill fetches BirdWeather station data and the code/README only contact https://app.birdweather.com/api/v1 for public station/species/detection endpoints — nothing else is requested.
Instruction Scope
SKILL.md and the CLI only instruct running the included script with station IDs and optional period/limits. Neither the docs nor the code attempt to read local files, environment secrets, or send data to unexpected endpoints.
Install Mechanism
There is no install spec and the bundled Python script uses only the standard library (urllib). No external packages, downloads, or archive extraction are used.
Credentials
The skill declares no required environment variables or credentials and the code does not access any. It only makes network requests to the documented BirdWeather API, which is appropriate for the stated purpose.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system settings, and requires no persistent credentials or filesystem changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install birdweather - After installation, invoke the skill by name or use
/birdweather - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: station info, species lists, detections, period comparison, trend analysis. No API key required.
Metadata
Frequently Asked Questions
What is BirdWeather?
Query BirdWeather station data — species detections, trends, and comparisons from BirdNET-Pi and PUC bird song detection stations. Use when asked about bird... It is an AI Agent Skill for Claude Code / OpenClaw, with 556 downloads so far.
How do I install BirdWeather?
Run "/install birdweather" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is BirdWeather free?
Yes, BirdWeather is completely free (open-source). You can download, install and use it at no cost.
Which platforms does BirdWeather support?
BirdWeather is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created BirdWeather?
It is built and maintained by maxdraki (@maxdraki); the current version is v1.0.0.
More Skills