fma-nz
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
SKILL.mdskills/fma-nz/SKILL.md
GitHubFMA 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:
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 windowwarnings get <slug-or-url> [--json]- fetch warning detail with source URL, dates, and summaryproviders list [--type crowdfunding|p2p|advice|all] [--query TEXT] [--limit N] [--json]- search FMA licensed-provider listings with type hintsproviders get <slug-or-url-or-fsp-number> [--json]- fetch one licensed-provider detail pageproviders sources [--type crowdfunding|p2p|advice|all] [--json]- return curated source pages and capability notesprovider-search <query> [--type crowdfunding|p2p|advice|all] [--limit N] [--json]- convenience search wrapper over provider listingcrowdfunding-platforms [--query TEXT] [--limit N] [--json]- curated alias for crowdfunding providersadvice-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_unavailableexits when traffic is blocked.
Resources
scripts/cli.py- command implementationsscripts/smoke_test.py- outage-tolerant smoke checksreferences/api-notes.md- source URLs, endpoint behaviour, caveats, and field notes