git:20260703.99e2b0c to git:20260719.1748a98

22 added, 1 removed. Audit A to A.

---

name: fma-nz

- description: Query FMA warnings/alerts and licensed provider pages for NZ crowdfunding, peer-to-peer lending, and financial-advice sources. Search alerts, list/register providers by type, and return source-backed JSON payloads for machine-readable workflows.

+ description: "Query FMA warnings/alerts and licensed provider pages for NZ crowdfunding, peer-to-peer lending, and financial-advice sources. Search alerts, list/register providers by type, and return source-backed JSON payloads for machine-readable workflows."

+ license: MIT

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

+ metadata:

+ thecolab.category: "public-data"

+ thecolab.source_owner: "Financial Markets Authority"

+ thecolab.source_type: "official"

+ 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.fma.govt.nz"

+ thecolab.allowed_domains: "fsp-register.companiesoffice.govt.nz,www.fma.govt.nz"

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

+ thecolab.health: "healthy"

+ thecolab.maintainer: "@adam91holt"

---

# FMA NZ

## Goal

Provide practical, safe access to New Zealand Financial Markets Authority public information for:

- warnings-and-alerts listing and details

- licensed provider discovery for crowdfunding and peer-to-peer lending

- pointers to the Financial Advice Provider licensing ecosystem and the Financial Service Providers Register

## Use this when

- A user asks for recent FMA warnings and alerts about scams, impersonation, or unregistered providers

- A task needs licensed provider lookup by name/type across FMA public pages

- A workflow needs source URLs and machine-readable metadata for NZ fintech consumer protection checks

## Do not use this for

- Circumventing login walls, bot challenges, or any private/credentialed APIs

- Storing or persisting any scraped payloads

- Treating summary-only outputs as legal or compliance advice

## CLI

Run with:

```bash

python3 skills/fma-nz/scripts/cli.py <command>

```

## Commands

- `warnings list [--query TEXT] [--since YYYY|YYYY-MM-DD] [--until YYYY|YYYY-MM-DD] [--limit N] [--json]` - search/paginate FMA warnings/alerts by text and date window

- `warnings get <slug-or-url> [--json]` - fetch warning detail with source URL, dates, and summary

- `providers list [--type crowdfunding|p2p|advice|all] [--query TEXT] [--limit N] [--json]` - search FMA licensed-provider listings with type hints

- `providers get <slug-or-url-or-fsp-number> [--json]` - fetch one licensed-provider detail page

- `providers sources [--type crowdfunding|p2p|advice|all] [--json]` - return curated source pages and capability notes

- `provider-search <query> [--type crowdfunding|p2p|advice|all] [--limit N] [--json]` - convenience search wrapper over provider listing

- `crowdfunding-platforms [--query TEXT] [--limit N] [--json]` - curated alias for crowdfunding providers

- `advice-providers [--query TEXT] [--limit N] [--json]` - advice-provider source discovery entry point

## Notes

- Read-only, no keys or session credentials required for the FMA public pages the skill queries.

- Advice-provider register discovery is source-limited: FMA links to the Financial Service Providers Register for searchable coverage, and that register requires a JS-enabled flow in this environment.

- Upstream is handled defensively with `upstream_unavailable` exits when traffic is blocked.

## Resources

- `scripts/cli.py` - command implementations

- `scripts/smoke_test.py` - outage-tolerant smoke checks

- `references/api-notes.md` - source URLs, endpoint behaviour, caveats, and field notes