birdbuddy

ClawSkills 作者 clawskills v1.0.0

Query your Bird Buddy smart bird feeder - check status, battery, food level, and see recent bird visitors with species identification.

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install clawskills:clawskills~mogglemoss-birdbuddy

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/clawskills%3Aclawskills~mogglemoss-birdbuddy/file -o mogglemoss-birdbuddy.md

# Bird Buddy Skill

Query your Bird Buddy smart bird feeder. Check feeder status, see recent bird visitors with species names, and fetch sighting photos.

## Requirements
- `pybirdbuddy` Python package: `pip install pybirdbuddy`
- `BIRDBUDDY_EMAIL` and `BIRDBUDDY_PASSWORD` environment variables (email/password login only — Google SSO not supported)

## Commands

### Check feeder status (battery, food, signal)
```bash
python3 {skillDir}/run.py status
```

### Get recent bird sightings with species names
```bash
python3 {skillDir}/run.py recent [hours=24] [limit=5]
```

### Get raw postcard feed
```bash
python3 {skillDir}/run.py feed [hours=24]
```

### Get full details and photo URLs for a specific postcard
```bash
python3 {skillDir}/run.py sighting <postcard_id>
```

## Example agent interactions
- "What birds visited my feeder today?" → `recent 24 10`
- "How is my Bird Buddy doing?" → `status`
- "Show me photos from the last visit" → `recent 24 1` then `sighting <id>`
- "What was the last bird at my feeder?" → `recent 1 1`