nz-healthpoint git:20260719.1748a98A

Immutable. This exact content never changes and is served at /api/v1/blob/8d06a16a152787d1.

---
name: nz-healthpoint
description: "Query Healthpoint NZ health-service directory: NZ pharmacies, GPs, urgent care, hospitals, dentists, and specialists. Returns locations, contact details, opening hours, and services. No booking or login."
license: MIT
compatibility: "Requires Python 3.10+ and network access for live data"
metadata:
  thecolab.category: "public-data"
  thecolab.source_owner: "Healthpoint"
  thecolab.source_type: "commercial"
  thecolab.auth: "none"
  thecolab.access_mode: "html-readonly"
  thecolab.data_class: "public"
  thecolab.writes: "false"
  thecolab.browser: "false"
  thecolab.risk: "low"
  thecolab.cache_ttl: "24h"
  thecolab.schema_version: "1"
  thecolab.skill_type: "html-readonly"
  thecolab.pack: "nz-commercial-web"
  thecolab.source_url: "https://www.healthpoint.co.nz"
  thecolab.allowed_domains: "www.healthpoint.co.nz"
  thecolab.last_verified: "2026-07-19"
  thecolab.health: "healthy"
  thecolab.maintainer: "@adam91holt"
---

# Healthpoint NZ

## Goal

Query live Healthpoint NZ directory pages through a small deterministic CLI with human-readable and JSON output, without login, booking actions, browser automation, or medical advice.

## Use this when

- A user asks for a nearby or open pharmacy in New Zealand
- A user wants urgent care / Accident & Medical / A&E clinic locations
- A user asks whether a listed GP, pharmacy, dentist, or clinic appears open
- A user wants hospitals or Health NZ / Te Whatu Ora public service locations
- A user needs service contact details, addresses, opening hours, listed services, or fees from Healthpoint
- A workflow needs lightweight machine-readable Healthpoint directory data

## Do not use this for

- Emergencies, triage, diagnosis, medical advice, or deciding whether care is clinically appropriate
- Booking, cancelling, changing, or paying for appointments
- Login, patient portals, referrals, enrolment forms, prescription requests, or provider-admin actions
- ED wait times, queue lengths, or capacity claims; Healthpoint does not reliably expose current ED wait times
- Bulk scraping or republishing Healthpoint as a dataset

## Preferred workflow

1. Run `scripts/cli.py` with the narrowest subcommand that answers the task
2. Use `pharmacies --open-now` or `open-now --type pharmacy` for current open-pharmacy checks
3. Use `urgent-care --region <region>` for Accident & Urgent Medical Care providers
4. Use `search <query> --type <type> --region <region>` for named practices or service-type lookups
5. Use `practice <id>` when a result id/path/url is known and detailed hours, address, services, or fees are needed
6. Use `hospitals --region <region> --ed-only` when the user specifically asks about hospitals with listed Emergency Departments
7. Use `--json` for agent chaining, comparisons, and reports

## CLI

Run with:

```bash
python3 skills/nz-healthpoint/scripts/cli.py <command> [flags]
```

## Commands

- `categories [--json]` - list supported Healthpoint branches and regions
- `search [query] [--type pharmacy|gp|urgent-care|hospital|dentist|...] [--region REGION] [--near ADDRESS] [--lat LAT --lng LNG] [--open-now] [--open-saturday] [--open-sunday] [--open-weekends] [--limit N] [--json]` - search services or typed branch listings
- `practice <id-or-path-or-url> [--json]` - fetch one detail page with address, phone, hours, services, fees, and ED indicator where available
- `open-now [--type TYPE] [--region REGION] [--near ADDRESS] [--limit N] [--json]` - currently open services; defaults to pharmacies
- `urgent-care [--region REGION] [--near ADDRESS] [--open-now] [--limit N] [--json]` - Accident & Urgent Medical Care providers
- `pharmacies [--region REGION] [--near ADDRESS] [--open-now] [--open-late] [--limit N] [--json]` - pharmacies; `--open-late` verifies detail hours open after 9pm where available
- `hospitals [--region REGION] [--ed-only] [--limit N] [--json]` - public hospital locations, enriched from detail pages with an Emergency Department indicator

## Examples

```bash
python3 skills/nz-healthpoint/scripts/cli.py pharmacies --near "Queen Street Auckland" --open-now --limit 5 --json
python3 skills/nz-healthpoint/scripts/cli.py open-now --type pharmacy --region "Central Auckland" --limit 5
python3 skills/nz-healthpoint/scripts/cli.py urgent-care --region Wellington --json
python3 skills/nz-healthpoint/scripts/cli.py search "Thorndon Medical Centre" --json
python3 skills/nz-healthpoint/scripts/cli.py search dentist --type dentist --region Wellington --open-saturday --json
python3 skills/nz-healthpoint/scripts/cli.py hospitals --region Auckland --ed-only --json
python3 skills/nz-healthpoint/scripts/cli.py practice pharmacy/pharmacy/medicines-to-midnight --json
```

## Notes

- Safety disclaimer: For emergencies call 111. For Healthline call 0800 611 116. This skill is for finding services, NOT medical advice.
- Upstream source: Healthpoint NZ (`healthpoint.co.nz`), New Zealand's national directory of health services
- Healthpoint states that directory details are supplied by service providers; hours, fees, services, and contacts can be incomplete or stale
- `--open-now` sends Healthpoint's public `openNow=true` filter and also parses the returned opening-status text against current `Pacific/Auckland` time
- `search --open-saturday` uses Healthpoint's weekend filter where available; `--open-sunday` and `--open-weekends` pass through the matching public branch filters
- `pharmacies --open-late` uses Healthpoint's `openLate` filter, then checks detail hours for closing times after 9pm where available; Healthpoint's own open-late checkbox is broader than 9pm
- Nearby searches use Healthpoint's public `/nearme.do` geocoder and choose the best city/region text match unless exact `--lat --lng` is supplied
- Auckland is split by Healthpoint into North, East, Central, West, and South Auckland; passing `--region Auckland` searches all five subregions
- No API key, username, password, account cookie, private token, or browser session is required for implemented read-only commands
- Endpoint shapes and HTML markup can change without notice because this is an unofficial wrapper around public website surfaces
- API and stability notes: `references/api-notes.md`
- CLI entrypoint: `scripts/cli.py`