O
olitreadwell/nz-open-data-connectors
NZ open data connectors
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"olitreadwell-nz-open-data-connectors": {
"command": "npx",
"args": ["tsx"]
}
}
}Parsed from the README we fetched on 2026-11-04; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"olitreadwell-nz-open-data-connectors": {
"command": "npx",
"args": ["tsx"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio olitreadwell-nz-open-data-connectors -- npx tsx
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 1 ★ · olitreadwell/nz-open-data-connectors · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 1 sources
- Score
- score 103 · 1 ★ · 1 sources · repo
- Install
npx tsx
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx tsx. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: 数据处理. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
olitreadwell/nz-open-data-connectors;first catalogued 2026-11-05;last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.# NZ Open Data Connectors
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
TypeScript connectors for New Zealand public data, with language-agnostic wrappers so you can use them from any language (Python, R, Julia, curl, whatever you like).
Keyless-first: every connector works without an API key. Optional keys unlock more, and keys stay server-side - they are read from the environment and never exposed over the API or committed to the repo.
## Packages
| Package | What it is |
| @nz-open-data-connectors/nz-sources | Uniform adapters for 14 NZ public data sources, with live probes and offline fixtures |
| @nz-open-data-connectors/stats-nz | Client for the Aotearoa Data Explorer (ADE) API: dataflow catalogue, data pulls, codelists, and CSV parsing |
| @nz-open-data-connectors/nz-mcp | MCP server that exposes the connectors to Claude, ChatGPT, and other MCP clients |
| @nz-open-data-connectors/connectors-api | Private. HTTP wrapper with an OpenAPI spec and Swagger UI, so any language can call the connectors over HTTP |
| @nz-open-data-connectors/connectors-cli | Command line tool that prints JSON or CSV to stdout, so any language can shell out to it |
| @nz-open-data-connectors/config-eslint | Private. Shared ESLint flat config for the TypeScript packages |
| @nz-open-data-connectors/config-typescript | Private. Shared TypeScript configuration for the packages |
| python/ | Python port of the connectors, one dependency (httpx). Not on PyPI yet; install from the repo. |
| ruby/ | Ruby port of the connectors, one dependency (rexml). Not on RubyGems yet; install from the repo. |
## Connectors
Fourteen source adapters, all in @nz-open-data-connectors/nz-sources. Every one works
keyless. Two accept an optional key from the environment to unlock more:
DigitalNZ with DIGITALNZAPIKEY and LINZ with LINZAPIKEY.
The data is not ours, and each publisher keeps its own terms. GeoNet content
is copyright Earth Sciences New Zealand (formerly GNS Science) and carries
Creative Commons Attribution 3.0 New Zealand. NZOR content carries Creative
Commons Attribution-NonCommercial-ShareAlike 3.0 New Zealand, so it is not for
commercial use. data.govt.nz and the Waka Kotahi open data hub return a licence
value per dataset, and the nzta-open-data adapter passes that value through.
For every other source, check the publisher's licence before you reuse the data:
the connectors fetch it, they do not relicense it. docs/CONNECTORDISCOVERY.md
lists where each source's terms live.
Every adapter also sends the same User-Agent
(nz-open-data-connectors (Language=TypeScript)), waits at most 30
seconds for a response, and marks rate-limited (HTTP 429), server-error (HTTP
5xx) and network failures as retryable on the thrown NzSourceApiError. The
shared httpGet helper in packages/nz-sources/src/http.ts does this for all
fourteen adapters, so callers write nothing extra.
| id | Source | Keyless? | Key env var | Example command |
| geonet | GeoNet (Earth Sciences New Zealand) | Yes | - | npx tsx packages/cli/src/cli.ts probe geonet |
| data-govt-nz | data.govt.nz catalogue | Yes | - | npx tsx packages/cli/src/cli.ts probe data-govt-nz |
| data-govt-datastore | data.govt.nz datastore (MSD benefits) | Yes | - | npx tsx packages/cli/src/cli.ts probe data-govt-datastore |
Keyless-first: every connector works without an API key. Optional keys unlock more, and keys stay server-side - they are read from the environment and never exposed over the API or committed to the repo.
## Packages
| Package | What it is |
| @nz-open-data-connectors/nz-sources | Uniform adapters for 14 NZ public data sources, with live probes and offline fixtures |
| @nz-open-data-connectors/stats-nz | Client for the Aotearoa Data Explorer (ADE) API: dataflow catalogue, data pulls, codelists, and CSV parsing |
| @nz-open-data-connectors/nz-mcp | MCP server that exposes the connectors to Claude, ChatGPT, and other MCP clients |
| @nz-open-data-connectors/connectors-api | Private. HTTP wrapper with an OpenAPI spec and Swagger UI, so any language can call the connectors over HTTP |
| @nz-open-data-connectors/connectors-cli | Command line tool that prints JSON or CSV to stdout, so any language can shell out to it |
| @nz-open-data-connectors/config-eslint | Private. Shared ESLint flat config for the TypeScript packages |
| @nz-open-data-connectors/config-typescript | Private. Shared TypeScript configuration for the packages |
| python/ | Python port of the connectors, one dependency (httpx). Not on PyPI yet; install from the repo. |
| ruby/ | Ruby port of the connectors, one dependency (rexml). Not on RubyGems yet; install from the repo. |
## Connectors
Fourteen source adapters, all in @nz-open-data-connectors/nz-sources. Every one works
keyless. Two accept an optional key from the environment to unlock more:
DigitalNZ with DIGITALNZAPIKEY and LINZ with LINZAPIKEY.
The data is not ours, and each publisher keeps its own terms. GeoNet content
is copyright Earth Sciences New Zealand (formerly GNS Science) and carries
Creative Commons Attribution 3.0 New Zealand. NZOR content carries Creative
Commons Attribution-NonCommercial-ShareAlike 3.0 New Zealand, so it is not for
commercial use. data.govt.nz and the Waka Kotahi open data hub return a licence
value per dataset, and the nzta-open-data adapter passes that value through.
For every other source, check the publisher's licence before you reuse the data:
the connectors fetch it, they do not relicense it. docs/CONNECTORDISCOVERY.md
lists where each source's terms live.
Every adapter also sends the same User-Agent
(nz-open-data-connectors (Language=TypeScript)), waits at most 30
seconds for a response, and marks rate-limited (HTTP 429), server-error (HTTP
5xx) and network failures as retryable on the thrown NzSourceApiError. The
shared httpGet helper in packages/nz-sources/src/http.ts does this for all
fourteen adapters, so callers write nothing extra.
| id | Source | Keyless? | Key env var | Example command |
| geonet | GeoNet (Earth Sciences New Zealand) | Yes | - | npx tsx packages/cli/src/cli.ts probe geonet |
| data-govt-nz | data.govt.nz catalogue | Yes | - | npx tsx packages/cli/src/cli.ts probe data-govt-nz |
| data-govt-datastore | data.govt.nz datastore (MSD benefits) | Yes | - | npx tsx packages/cli/src/cli.ts probe data-govt-datastore |
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/olitreadwell-nz-open-data-connectors/)
- Source
- github · https://github.com/olitreadwell/nz-open-data-connectors
- Browse by field
- 数据处理
- Traction
- 1 ★
- added
- today