auckland-bin-schedule - SKILL.md Agent Skill

name: auckland-bin-schedule description: Query Auckland Council rubbish, recycling, and food scraps collection days for Auckland properties using the public collection-day website flow. Use when the task involves Auckland bin day, rubbish/recycling schedules, food scraps collection, address lookup, or property-id based collection checks. No account login required.

Auckland Bin Schedule

Goal

Query live Auckland Council household and commercial rubbish, recycling, and food scraps collection schedules through a small deterministic CLI with human-readable and JSON output.

Use this when

A user asks when Auckland bins go out
A user wants the next rubbish, recycling, or food scraps collection date for an Auckland address
A user needs to list matching Auckland Council properties for an address query
A workflow needs machine-readable Auckland Council collection schedule data

Do not use this for

Councils outside Auckland
Private collection schedules not shown on Auckland Council's page
Historical collection claims beyond the current dates shown by Council
Changing Council services, lodging requests, or account/property actions

Preferred workflow

Run scripts/cli.py with the exact address when known
Use --list if multiple units/properties may match or the first match looks wrong
Use --property-id when an Auckland Council property/rating id is already known
Use --json for agent chaining, comparisons, alerts, or structured reports
Summarise household collection first unless the user asks about commercial collection
Mention that public holidays can shift collection dates and the CLI reflects the current Council page

CLI

Run with:

python3 skills/auckland-bin-schedule/scripts/cli.py <address...> [flags]

Commands / flags

<address...> — Auckland property address to search, e.g. 12 Tawa Road Onehunga
--list — list matching properties only
--property-id <id> — fetch a known Auckland Council property/rating id directly
--limit <N> — address lookup result limit
--json — emit JSON

Examples:

python3 skills/auckland-bin-schedule/scripts/cli.py --list "12 Tawa Road Onehunga"
python3 skills/auckland-bin-schedule/scripts/cli.py "12 Tawa Road Onehunga"
python3 skills/auckland-bin-schedule/scripts/cli.py "12 Tawa Road Onehunga" --json
python3 skills/auckland-bin-schedule/scripts/cli.py --property-id 12343300679 --json

Resources

CLI entrypoint: scripts/cli.py
Live smoke test: scripts/smoke_test.py
API and stability notes: references/api-notes.md

Notes

No API key, username, password, cookie, or private credential is required
The CLI fetches the current public bearer token from Auckland Council's collection-day page at runtime
Treat dates as live current Council snapshots, not historical facts
Some properties show private service or property-manager messages instead of Council collection dates