cab-cabnet-nz git:20260719.1748a98A

Immutable. This exact content never changes and is served at /api/v1/blob/680844663b0d036e.

---
name: cab-cabnet-nz
description: "Use when Codex needs to discover Citizens Advice Bureau NZ public client-enquiry evidence, CABNET source availability, advice category taxonomy, or report-backed enquiry trend caveats for New Zealand social-need analysis; wraps keyless cab.org.nz and data.govt.nz discovery and reports explicit blocked states when aggregated CABNET counts are not publicly exported."
license: MIT
compatibility: "Requires Python 3.10+ and network access for live data"
metadata:
  thecolab.category: "public-data"
  thecolab.source_owner: "Citizens Advice Bureau New Zealand"
  thecolab.source_type: "official"
  thecolab.auth: "none"
  thecolab.access_mode: "public-api"
  thecolab.data_class: "public"
  thecolab.writes: "false"
  thecolab.browser: "false"
  thecolab.risk: "low"
  thecolab.cache_ttl: "24h"
  thecolab.schema_version: "1"
  thecolab.skill_type: "public-api"
  thecolab.pack: "nz-public-data"
  thecolab.source_url: "https://www.cab.org.nz"
  thecolab.allowed_domains: "catalogue.data.govt.nz,www.cab.org.nz"
  thecolab.last_verified: "2026-07-19"
  thecolab.health: "healthy"
  thecolab.maintainer: "@adam91holt"
---

# CAB CABNET NZ

## Overview

Use this read-only CLI to inspect public Citizens Advice Bureau NZ material
related to CABNET client-enquiry evidence. CAB has not exposed an unauthenticated
structured export of national CABNET enquiry counts; the skill makes that
blocked state explicit instead of inventing data.

The CLI uses only Python 3 standard library modules and keyless public
endpoints on `cab.org.nz` and `catalogue.data.govt.nz`.

## Commands

Run commands from this skill directory with `python3 scripts/cli.py`.
Every command accepts `--json`.

- `sources --query "welfare report" --json` discovers public CAB pages/reports,
  checks data.govt.nz, and confirms unauthenticated CABNET reporting endpoints
  are forbidden.
- `categories --query tenancy --json` returns the public CAB website advice
  taxonomy from `assets/data/categories.json`. This is not a confirmed CABNET
  enquiry taxonomy or enquiry volume table.
- `enquiries --year 2025 [--category benefits] --json` returns an explicit
  `structured_export_unavailable` blocked state because no public machine-readable
  CABNET enquiry-count export is reachable.
- `trends --category "food assistance" --json` returns report-backed trend
  caveats where a public CAB spotlight report discusses that category, but does
  not fabricate chart values that are only visible in PDFs/images.

## Examples

```bash
python3 scripts/cli.py sources --query "welfare report" --json
python3 scripts/cli.py categories --query tenancy --json
python3 scripts/cli.py enquiries --year 2025 --category benefits --json
python3 scripts/cli.py trends --category "budgeting and debt" --json
```

## Notes

- Use `sources` first when a user asks whether CABNET data is public.
- Treat `categories` counts as article counts in CAB's public rights/advice
  website, not client enquiry counts.
- If CAB later publishes CSV/XLSX/JSON enquiry exports, update
  `scripts/cli.py` to parse that export directly and revise
  `references/api-notes.md`.
- Source and format details are in `references/api-notes.md`.
- Run `python3 scripts/smoke_test.py` for the live smoke test.