fyi-oia-nz
Query FYI.org.nz OIA/LGOIMA public authorities and request records through a read-only Alaveteli API surface, including request metadata, authority lookups, request timelines, and request search.
SKILL.mdskills/fyi-oia-nz/SKILL.md
GitHubFYI.org.nz OIA/LGOIMA
Scope
This skill wraps FYI.org.nz public authority/request read endpoints and the published all-authorities CSV. It is designed for public-corpus research and reproducible citations around OIA/LGOIMA requests.
Use this when
- You need NZ public authority discovery from FYI’s authority list
- You need authority detail for a specific FYI body URL slug
- You need request metadata for an ID or
request/<id>-<slug> - You need request event timelines (calculated_state/state transitions)
- You need simple request-text search across FYI pages as a discovery aid
Do not use this for
- Request drafting or posting
- Requester personal data extraction
- Bulk crawling of the search surface
Commands
authorities [--tag <tag>] [--query <text>] [--limit N] [--json]- List public authorities from
/body/all-authorities.csv, with optional tag/text filtering.
- List public authorities from
categories [--limit N] [--json]- List body tags/categories discovered in
all-authorities.csv.
- List body tags/categories discovered in
body <url_name_or_url> [--json]- Fetch authority metadata from
/body/<url_name>.json.
- Fetch authority metadata from
search <query> [--limit N] [--json]- Search FYI request pages for matching titles; uses
/search/*endpoints where available and falls back to parsed request result HTML.
- Search FYI request pages for matching titles; uses
request <id_or_slug> [--full] [--json]- Fetch request metadata from
/request/<id>.json. - Metadata-only mode strips requester-identifying fields.
--fullincludes the full timeline with event/type fields and message IDs.
- Fetch request metadata from
events <id_or_slug> [--json]- Fetch and flatten request event timeline only.
Read-only contract
- No logins, tokens, keys, browser automation, or write operations.
- Defaults are metadata-first and remove requester personal text/name fields from command output.
- Uses only HTTPS GETs with conservative timeouts.
Resources
scripts/cli.pyscripts/smoke_test.pyreferences/api-notes.md