git:20260705.a4019d0 to git:20260719.1748a98

22 added, 1 removed. Audit A to A.

---

name: nz-angel-investment

- description: Queries New Zealand angel and seed investment publication sources from NZGCP Young Company Finance, NZGCP annual/ecosystem reports, and Angel Association NZ member and investment-publication pages. Use when the task involves NZ early-stage capital, angel investment, seed funding, Young Company Finance deal or investment counts, Aspire/Elevate reporting, investor directories, Angel Market reports, or source-backed publication discovery; read-only and no API key required.

+ description: "Queries New Zealand angel and seed investment publication sources from NZGCP Young Company Finance, NZGCP annual/ecosystem reports, and Angel Association NZ member and investment-publication pages. Use when the task involves NZ early-stage capital, angel investment, seed funding, Young Company Finance deal or investment counts, Aspire/Elevate reporting, investor directories, Angel Market reports, or source-backed publication discovery; read-only and no API key required."

+ license: MIT

+ compatibility: "Requires Python 3.10+ and network access for live data"

+ metadata:

+ thecolab.category: "finance"

+ thecolab.source_owner: "New Zealand Growth Capital Partners and Angel Association NZ"

+ thecolab.source_type: "mixed"

+ 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.nzgcp.co.nz"

+ thecolab.allowed_domains: "nz.dealroom.co,www.angelassociation.co.nz,www.nzgcp.co.nz"

+ thecolab.last_verified: "2026-07-19"

+ thecolab.health: "healthy"

+ thecolab.maintainer: "@adam91holt"

---

# NZ Angel Investment

## Goal

Discover and lightly structure New Zealand angel/seed investment sources from NZGCP and Angel Association NZ without requiring API keys or paid Dealroom access.

## Use this when

- A user asks for NZ Young Company Finance releases, deal counts, invested dollars, or companies funded.

- A workflow needs NZGCP annual reports, Dealroom ecosystem reports, Aspire/Elevate reporting, or a source URL for early-stage capital evidence.

- A user asks for Angel Association NZ members, angel networks, investor regions, or investment publications such as Angel Market reports.

- A task needs machine-readable JSON from public NZ angel/seed investment source pages.

## Do not use this for

- Querying the paid Dealroom database/API, logging into investor platforms, or bypassing access controls.

- Legal, financial, investment, or fundraising advice. Return source-backed facts and caveats instead.

- Treating PDF chart/table values as final where the CLI reports `source_discovery_only`; manually verify the linked publication before citing.

## CLI

```bash

python3 skills/nz-angel-investment/scripts/cli.py ycf list --json

python3 skills/nz-angel-investment/scripts/cli.py ycf list --discover --json

python3 skills/nz-angel-investment/scripts/cli.py ycf get 2025 --json

python3 skills/nz-angel-investment/scripts/cli.py nzgcp-reports --kind annual_report --json

python3 skills/nz-angel-investment/scripts/cli.py investors --region Auckland --limit 10 --json

python3 skills/nz-angel-investment/scripts/cli.py publications --json

python3 skills/nz-angel-investment/scripts/cli.py sources --json

```

Commands:

- `ycf list [--discover] [--limit N] [--json]` - returns curated Young Company Finance releases and, with `--discover`, refreshes links from the NZGCP startup investment report page.

- `ycf get <period-or-alias> [--json]` - returns one YCF release. `2025` includes curated headline metrics from NZGCP YCF Autumn 2026; other releases are source-discovery records until metrics are manually extracted.

- `nzgcp-reports [--kind KIND] [--limit N] [--json]` - lists NZGCP report PDFs, including annual reports and Dealroom ecosystem reports. Uses the NZGCP report page plus curated known report URLs.

- `investors [--query TEXT] [--region REGION] [--limit N] [--json]` - reads the Angel Association NZ public members directory and returns investor/member cards with name, regions, focus/tagline, URL, email when listed, and locations.

- `publications [--kind KIND] [--limit N] [--json]` - discovers Angel Association NZ investment publications from the investment-publications page and WordPress download records.

- `sources` / `datasets` - returns the source catalogue, access notes, and caveats.

## Operational Notes

The CLI is intentionally conservative because the important figures live in PDFs and image-heavy report pages. It prefers source discovery, curated known reports, and explicit caveats over brittle stdlib-only PDF chart parsing.

Network failures, bad JSON, rate limits, or upstream outages return `upstream_unavailable` and exit code 2 for JSON commands. Not-found periods return a JSON `not_found` error with exit code 1.

## Resources

- CLI: `scripts/cli.py`

- Smoke test: `scripts/smoke_test.py`

- Source and extraction notes: `references/api-notes.md`