Aggregate RSS feeds from major New Zealand news websites. Use when the task involves NZ news, current events in New Zealand, what's happening in NZ, NZ headlines, or searching NZ stories by topic, timeframe, or source. No authentication required.
Aggregate live RSS feeds from major New Zealand news websites into a single CLI tool for quick headline scanning, source browsing, and obvious topic searching.
scripts/cli.tssearch for any topic lookup, either positionally or with flags--source, --since-hours, --since-date, --contains-all, --exact, and --exclude when the request needs tighter matching--json when another tool or agent needs machine-readable outputRun with:
npx tsx skills/nz-news/scripts/cli.ts <command> [flags]
The easiest path for topic lookups is now search.
Examples:
npx tsx skills/nz-news/scripts/cli.ts search cyclone
npx tsx skills/nz-news/scripts/cli.ts search --keyword cyclone --since-hours 24
npx tsx skills/nz-news/scripts/cli.ts search --keyword "housing market" --contains-all --source rnz,newsroom
npx tsx skills/nz-news/scripts/cli.ts search --keyword coalition --exact --since-date 2026-04-01
npx tsx skills/nz-news/scripts/cli.ts topic cyclone --exclude sport --limit 5
topic is kept as an alias for search, so both of these work:
npx tsx skills/nz-news/scripts/cli.ts topic cyclone
npx tsx skills/nz-news/scripts/cli.ts search --keyword cyclone
headlines [--limit N] [--json]Top headlines across all primary sources (NZ Herald, Stuff, RNZ, Newsroom, The Spinoff, Interest.co.nz), deduplicated and sorted by date. Default limit: 10.
Examples:
npx tsx skills/nz-news/scripts/cli.ts headlines
npx tsx skills/nz-news/scripts/cli.ts headlines --limit 20
npx tsx skills/nz-news/scripts/cli.ts headlines --json
source <name> [--limit N] [--json]News from a specific source. Accepts source ID (for example rnz, stuff, herald) or a source name. Default limit: 10.
Examples:
npx tsx skills/nz-news/scripts/cli.ts source rnz
npx tsx skills/nz-news/scripts/cli.ts source stuff --limit 5
npx tsx skills/nz-news/scripts/cli.ts source herald --json
search [keyword...] [flags]Search headlines and summaries across NZ sources. You can provide the search term positionally or with --keyword.
Useful flags:
--keyword <text> for flag-based search input--source rnz,herald to limit the search to specific feeds--since-hours <hours> to keep only recent stories--since-date <YYYY-MM-DD or ISO timestamp> for a fixed start date--contains-all to require every term in a multi-word query--exact to match an exact phrase--exclude sport,opinion to remove unwanted terms--limit N--jsonJSON shape:
fetchedAtkeywordmatchModesourcesQueriedsourcesOkfilters.sourceIdsfilters.sinceHoursfilters.sinceDatefilters.excludefilters.limittotalMatchingreturnedCountitems[] with title, url, published, source, sourceId, summaryerrors[]Examples:
npx tsx skills/nz-news/scripts/cli.ts search cyclone
npx tsx skills/nz-news/scripts/cli.ts search --keyword cyclone --since-hours 24
npx tsx skills/nz-news/scripts/cli.ts search --keyword "housing market" --contains-all --source rnz,newsroom
npx tsx skills/nz-news/scripts/cli.ts search --keyword coalition --exact --since-date 2026-04-01
npx tsx skills/nz-news/scripts/cli.ts topic cyclone --exclude sport --limit 5 --json
sources [--json]List all available news sources with a live status check showing which feeds are working, how many items each returned, and response time.
Examples:
npx tsx skills/nz-news/scripts/cli.ts sources
npx tsx skills/nz-news/scripts/cli.ts sources --json
summary [--json]Brief summary showing total story count across sources and the top 5 headlines.
Examples:
npx tsx skills/nz-news/scripts/cli.ts summary
npx tsx skills/nz-news/scripts/cli.ts summary --json
| ID | Name | Format | Type |
|---|---|---|---|
| herald | NZ Herald | RSS | Primary |
| stuff | Stuff | Atom | Primary |
| rnz | RNZ | RSS | Primary |
| newsroom | Newsroom | RSS | Primary |
| spinoff | The Spinoff | Atom | Primary |
| interest | Interest.co.nz | RSS | Primary |
| rnz-politics | RNZ Politics | RSS | Category |
| rnz-business | RNZ Business | RSS | Category |
| rnz-national | RNZ National | RSS | Category |
| rnz-world | RNZ World | RSS | Category |
| rnz-sport | RNZ Sport | RSS | Category |
| rnz-te-ao-maori | RNZ Te Ao Māori | RSS | Category |
Primary sources are queried by default. Category feeds (RNZ sub-feeds) are available via source <id> and search --source <id>, but excluded from headlines and summary to avoid duplicate stories.
No API key required — just Node.js and npx tsx.
scripts/cli.tsscripts/feeds.tsscripts/smoke-test.tsfetch available in modern Node runtimes--json output is for chaining into other tools or agent steps