general

New Zealand Crawler - Harness Racing New Zealand

Version 2 · Recorded the pushed Harness/Greyhound branch location and outstanding main integration.

Historical version

New Zealand Crawler - Harness Racing New Zealand

Repository location

This crawler is committed and pushed in origin/codex/harness-greyhound-jurisdictions at 490b0c9. That branch is clean and passes 131 tests. It is not yet integrated into origin/main at 4d68b42; consult overview before choosing a base for new work.

Last reviewed: 2026-08-08 AEST

Identity and scope

Source ID: nz_hrnz
Discipline: Harness (H)
Racing code / ISO country: NZ / NZ
Adapter: src/formcrawler/sources/nz/hrnz.py
Base site: https://www.hrnz.co.nz/

The adapter preserves official static fields and results HTML. It uses list and named-month archive fallbacks because the six-digit document names do not contain a year.

Routes and history

Fields list
Field documents: /datahrs/fields/{six-digit-code}fd.htm
Results list
Result documents: /datahrs/results/{six-digit-code}rs.htm
Month archive: /datahrs/results/rlts_{month-name}.htm

python scripts\formcrawler.py discover --source nz_hrnz --url "https://infohorse.hrnz.co.nz/datahrs/fields/fields.htm"
python scripts\formcrawler.py run-queue --source nz_hrnz
python scripts\formcrawler.py discover --source nz_hrnz --url "https://infohorse.hrnz.co.nz/datahrs/results/results.htm"

The source is raw static HTML/PDF acquisition; no racing values are parsed.

Supplementary and breeding information

Fields expose sire, dam, and foal year. Country of origin is not a discrete field. Horse detail links can be session/token dependent; the meeting field document is the stable review fallback.

Storage, verification, and limitations

Artifacts use FormCrawler/h-artifacts/<year>/NZ/nz_hrnz/; handoffs use FormParser/inbox/H/<year>/NZ/nz_hrnz/.

The full test captured the complete current fields list (2/2) and all eight published results from the official results index. The combined root contains 12 stored artifacts (5,339,798 bytes); every raw length, SHA-256, metadata record, and handoff matched. Two automatically paired future result targets remain retryable and do not reduce current pre-race coverage. Archive discovery is bounded by named month, but a year cannot be inferred reliably from the source filename alone.

Module changelog

2026-08-08: Implemented fields/results list discovery, paired static documents, named-month archive support, readiness checks, and integrity-verified live acquisition.