eventfinda-nz
Search and inspect public Eventfinda New Zealand event listings from the no-login website pages. Use when the task involves finding NZ events by location, category, or keyword, getting Eventfinda even
SKILL.mdskills/eventfinda-nz/SKILL.md
GitHubEventfinda NZ
Goal
Query live public Eventfinda New Zealand event listings through a small deterministic CLI with human-readable and JSON output.
Use this when
- A user asks what events are on in Auckland, Wellington, Christchurch, or New Zealand generally
- A workflow needs Eventfinda event titles, URLs, venues, dates, categories, badges, or images
- A user has an Eventfinda event URL/path and wants structured details, sessions, venue address, geo coordinates, or offer/pricing metadata published in the page JSON-LD
- An agent needs a no-login NZ event discovery source before checking venue-specific sources
Do not use this for
- Buying tickets, reserving seats, logging into Eventfinda, or changing account data
- High-volume scraping, full-site mirroring, or alerting that hammers Eventfinda pages
- Private organiser, attendee, sales, or ticket inventory data
- Treating scraped public website structure as a permanent API contract
- The official Eventfinda developer API unless you explicitly have credentials and add a separate authenticated wrapper
Preferred workflow
- Run
scripts/cli.py upcoming --location <slug>for broad discovery - Use
search <query>for keyword searches such as artists, festivals, venues, or genres - Pass the chosen event URL to
event <url>for structured JSON-LD details and sessions - Use
--jsonfor agent chaining, comparisons, or structured summaries - Cite Eventfinda event URLs and include the date/venue when reporting findings
- If a listing has repeated sessions, summarize the first few and mention the total session count
CLI
Run with:
python3 skills/eventfinda-nz/scripts/cli.py <command> [flags]
Commands
upcoming [--location slug] [--category slug] [--page N] [--limit N] [--json]— list public Eventfinda event cards from a location/category pagesearch <query> [--page N] [--limit N] [--json]— search Eventfinda public pages by keywordevent <url-or-path> [--json] [--raw]— inspect a public Eventfinda event detail page using embedded JSON-LD
Examples:
python3 skills/eventfinda-nz/scripts/cli.py upcoming --location auckland --limit 5
python3 skills/eventfinda-nz/scripts/cli.py upcoming --location wellington --category concerts-gig-guide --limit 5 --json
python3 skills/eventfinda-nz/scripts/cli.py search "jazz" --limit 5 --json
python3 skills/eventfinda-nz/scripts/cli.py event /2026/classic-comedy-all-stars-festival-edition/auckland --json
python3 skills/eventfinda-nz/scripts/cli.py event https://www.eventfinda.co.nz/2026/classic-comedy-all-stars-festival-edition/auckland --raw --json
Location and category slugs
The CLI uses Eventfinda website URL slugs. Common locations include:
new-zealandaucklandwellingtonchristchurchhamiltondunedintauranga
Category slugs are the same path segments Eventfinda uses, for example:
concerts-gig-guidefestivals-lifestyleperforming-artssports-outdoorsexhibitionscomedy
If a category/location combination produces no cards, try the broader upcoming --location <slug> page or search <query>.
Resources
- CLI entrypoint:
scripts/cli.py - Live smoke test:
scripts/smoke_test.py - API and website notes:
references/api-notes.md
Notes
- No username, password, API key, account cookie, or browser automation is required for the implemented public website commands
- The official
api.eventfinda.co.nz/v2developer API returned401 Incorrect authentication details suppliedwithout Basic-auth credentials during verification; this skill intentionally uses public website pages instead - Listing pages are parsed from public HTML event cards; detail pages are parsed from embedded Schema.org JSON-LD
- Eventfinda page markup can change; run the smoke test before relying on this skill in automation
- Keep requests narrow and respectful