healthcert-rest-homes-nz

name	healthcert-rest-homes-nz
description	Query Ministry of Health certified aged-care rest-home provider data, facility pages, audit-report links, and certification caveats. Use when the task involves NZ rest-home certification, aged-care provider beds, legal entities, auditors, certificate end dates, audit report metadata, corrective-action page availability, or source caveats for bot-protected Ministry facility pages.
license	MIT
compatibility	Requires Python 3.10+ and network access for live data
metadata	{"thecolab.category":"property","thecolab.source_owner":"Ministry of Health","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.health.govt.nz/system/files/LegalEntitySummaryAgedCare.csv","thecolab.allowed_domains":"www.health.govt.nz","thecolab.last_verified":"2026-07-19","thecolab.health":"healthy","thecolab.maintainer":"@adam91holt"}

HealthCert Rest Homes NZ

Goal

Use a read-only CLI to inspect public Ministry of Health certified aged-care rest-home data and facility audit metadata.

Use This When

• A user asks for certified New Zealand rest homes, aged-care facilities, bed counts, auditors, or legal provider names
• A workflow needs a respectful sample of Ministry certified-provider CSV rows by legal provider
• A user needs public Ministry facility page details or audit report links for one rest home
• A user needs clear blocked-source caveats for Ministry pages that return Cloudflare or edge-protection responses

Do Not Use This For

• Bulk mirroring audit PDFs/DOCX files
• Private resident records, clinical records, complaints, or non-public certification data
• HealthCERT write actions, provider registration, or authenticated Ministry systems
• Inferring risk ratings or corrective-action status when the public page is blocked or does not publish those rows

Preferred Workflow

1. Run scripts/cli.py list --json to fetch and filter the official certified aged-care CSV.
2. Use sample --provider "Legal name" --json for a small provider-level aggregation sample.
3. Use facility "Premises name" --json to fetch the public Ministry facility page when reachable.
4. Use reports "Premises name" --json to list public audit report links without downloading the documents.
5. If a facility page is blocked, report the returned blocked status, source_url, and the CSV fallback row instead of treating the facility as missing.

CLI

Run with:

python3 skills/healthcert-rest-homes-nz/scripts/cli.py <command> [flags]

Commands:

• list [--query TEXT] [--city CITY] [--provider NAME] [--limit N] [--json] - fetch and filter the certified aged-care CSV
• facility <slug-or-name> [--json] - fetch one public facility page and return premise/provider/certification details when reachable
• reports <slug-or-name> [--json] - list public audit report links for one facility page
• sample --provider NAME [--limit N] [--json] - return a small provider-level CSV sample and summary totals

Resources

• CLI entrypoint: scripts/cli.py
• Smoke test: scripts/smoke_test.py
• Source notes and caveats: references/api-notes.md

Notes

• The CLI is read-only, keyless, and uses Python standard library modules plus the repo-local lib/nzfetch.py helper.
• The official CSV is the primary structured source for list/sample commands.
• Facility pages may return HTTP 403 to automated clients. The CLI classifies that as blocked and keeps the CSV-derived fallback metadata available.
• Audit report links are listed as metadata only; the skill does not download or parse PDFs/DOCX files.