nz-healthpoint
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 log
SKILL.mdskills/nz-healthpoint/SKILL.md
GitHubHealthpoint 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
- Run
scripts/cli.pywith the narrowest subcommand that answers the task - Use
pharmacies --open-noworopen-now --type pharmacyfor current open-pharmacy checks - Use
urgent-care --region <region>for Accident & Urgent Medical Care providers - Use
search <query> --type <type> --region <region>for named practices or service-type lookups - Use
practice <id>when a result id/path/url is known and detailed hours, address, services, or fees are needed - Use
hospitals --region <region> --ed-onlywhen the user specifically asks about hospitals with listed Emergency Departments - Use
--jsonfor agent chaining, comparisons, and reports
CLI
Run with:
python3 skills/nz-healthpoint/scripts/cli.py <command> [flags]
Commands
categories [--json]- list supported Healthpoint branches and regionssearch [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 listingspractice <id-or-path-or-url> [--json]- fetch one detail page with address, phone, hours, services, fees, and ED indicator where availableopen-now [--type TYPE] [--region REGION] [--near ADDRESS] [--limit N] [--json]- currently open services; defaults to pharmaciesurgent-care [--region REGION] [--near ADDRESS] [--open-now] [--limit N] [--json]- Accident & Urgent Medical Care providerspharmacies [--region REGION] [--near ADDRESS] [--open-now] [--open-late] [--limit N] [--json]- pharmacies;--open-lateverifies detail hours open after 9pm where availablehospitals [--region REGION] [--ed-only] [--limit N] [--json]- public hospital locations, enriched from detail pages with an Emergency Department indicator
Examples
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-nowsends Healthpoint's publicopenNow=truefilter and also parses the returned opening-status text against currentPacific/Aucklandtimesearch --open-saturdayuses Healthpoint's weekend filter where available;--open-sundayand--open-weekendspass through the matching public branch filterspharmacies --open-lateuses Healthpoint'sopenLatefilter, 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.dogeocoder and choose the best city/region text match unless exact--lat --lngis supplied - Auckland is split by Healthpoint into North, East, Central, West, and South Auckland; passing
--region Aucklandsearches 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