Skip to content
Agentmart
Submit a tool

christchurch-bin-schedule

Query Christchurch City Council kerbside collection schedules (rubbish, recycling, organics).

Skill by thecolab-ai

IndexedMIT★ 34
Write a review

Chalk Labs

Need help deploying christchurch-bin-schedule?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/thecolab-ai-christchurch-bin-schedule

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Query Christchurch City Council kerbside collection schedules (rubbish, recycling, organics). Use when the task involves Christchurch bin days, kerbside collection for a Christchurch address, or CCC three-bin schedules. Supports address search (name → RatingUnitID) or direct RatingUnitID lookup. No account required.

Use cases: productivity

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md and code. Checked Nov 1, 2026.

Tools
No tools found
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Network hosts it talks to 3

  • ccc.govt.nz · found in code
  • codeload.github.com · found in install command
  • opendata.ccc.govt.nz · found in code

Files it touches

  • ~/.claude/skills/christchurch-bin-schedule

What's inside

Skill name
christchurch-bin-schedule
Description
Query Christchurch City Council kerbside collection schedules (rubbish, recycling, organics). Use when the task involves Christchurch bin days, kerbside collection for a Christchurch address, or CCC three-bin schedules. Supports address search (name → RatingUnitID) or direct RatingUnitID lookup. No account required.
License
MIT
Compatibility
Requires Python 3.10+ and network access for live data
Metadata
thecolab.auth: none · thecolab.pack: nz-public-data · thecolab.risk: low · thecolab.health: healthy · thecolab.writes: false · thecolab.browser: false · thecolab.category: public-data · thecolab.cache_ttl: 24h · thecolab.data_class: public · thecolab.maintainer: @adam91holt · thecolab.skill_type: public-api · thecolab.source_url: https://opendata.ccc.govt.nz/CCCSearch/rest/address/suggest · thecolab.access_mode: public-api · thecolab.source_type: official · thecolab.source_owner: Christchurch City Council · thecolab.last_verified: 2026-07-19 · thecolab.schema_version: 1 · thecolab.allowed_domains: ccc.govt.nz,opendata.ccc.govt.nz
Instructions
76 lines in SKILL.md · view on GitHub

Before installing

  • Ships executable scripts

Files (7)

  • SKILL.md
  • api-notes.md · references/
  • source-notes.md · references/
  • cli.py · scripts/
  • smoke_test.py · scripts/
  • test_contract.py · scripts/
  • contract.json · tests/fixtures/

SKILL.md (first lines)

# Christchurch Bin Schedule

## Goal

Query live Christchurch City Council household kerbside collection schedules through a deterministic CLI with human-readable and JSON output.

Christchurch uses a **three-bin system** under the national standardisation:
- **Red bin** — Rubbish (fortnightly)
- **Yellow bin** — Recycling (fortnightly)
- **Green bin** — Organics (weekly, where available)

All three bin types are typically collected on the **same day of the week**, though they rotate on different fortnightly schedules.

## Use this when

- A user asks when Christchurch bins go out
- A user wants the next rubbish, recycling, or organics collection date for a Christchurch address
- A workflow needs machine-readable CCC collection schedule data

## Do not use this for

- Councils outside Christchurch City / Banks Peninsula (try Auckland, Wellington, or other council skills)
- Inner-city bag collections (not supported by this endpoint)
- Banks Peninsula community collection points (not individual property-level)
- Commercial or private collection schedules
- Finding a RatingUnitID without an address — the user must provide either an address or a known RatingUnitID

## Preferred workflow

1. Accept an address string or a known RatingUnitID from the user
2. If an address is given, resolve it to a RatingUnitID via the CCC address suggest API
3. Fetch the collection schedule from the CCC getProperty endpoint
4. Filter to current/future `out_of_date=False` collections
5. Present the regular schedule (day of week) and upcoming collection dates
6. Use `--json` for agent chaining, comparisons, alerts, or structured reports

## CLI

Run with:

```bash
python3 skills/christchurch-bin-schedule/scripts/cli.py "53 Hereford Street"
python3 skills/christchurch-bin-schedule/scripts/cli.py --rating-unit-id 86089
python3 skills/christchurch-bin-schedule/scripts/cli.py "53 Hereford Street" --json
```

### Arguments

- `address` — street address to search, e.g. `"53 Hereford Street"`
- `--rating-unit-id` — CCC RatingUnitID (numeric), skips address lookup
- `--json` — emit JSON

### Finding your RatingUnitID

1. Visit `https://ccc.govt.nz/services/rubbish-and-recycling/collections/`
2. Search for your address
3. The RatingUnitID can be found by inspecting the network request to `/getProperty?ID=`
4. Alternatively, use this skill with your address and it will resolve the ID automatically

## Resources

- CLI entrypoint: `scripts/cli.py`
- API and stability notes: `references/api-notes.md`

## Notes

- No API key, username, password, or cookie is required
- Christchurch uses the national-standard three-bin system (red/yellow/green)
- The `getProperty` endpoint is protected by Incapsula bot detection — it works reliably from residential NZ IPs but may block datacenter/VPN IPs with 403
- The address suggest endpoint (opendata.ccc.govt.nz) has no bot protection and works universally
- Dates are current Council snapshots, not historical records
- Public holidays may shift collection dates — the CLI reflects the current Council data
- Treat dates as live current snapshots, not guaranteed future schedules
- Organic collections are marked as `Week A` / `Week B` — the `next_planned_date` reflects the actual collection date

From thecolab-ai/.skills, MIT.

Signals

Stars
34
Forks
7
Open issues
10
Last commit (this folder)
Jul 19, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026).

Details

License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped
50+
launches shipped
media placements
500+
media placements
founders on every account
2
founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get christchurch-bin-schedule running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Goes to the Chalk Labs founders, not the newsletter. Privacy

Need help deploying christchurch-bin-schedule?

CallGet help
Cite this page

christchurch-bin-schedule skill. Agent Mart. https://agentmart.dev/skills/thecolab-ai-christchurch-bin-schedule (last updated 2026-10-24)