bookme-nz
Query Bookme NZ discounted activities, experiences, tours, restaurants, and last-minute deals. Supports hot deals, cheapest offers, regional/category search, and deal detail. No login, booking, or pay
SKILL.mdskills/bookme-nz/SKILL.md
GitHubBookme NZ
Goal
Query live Bookme NZ discount marketplace data through a lightweight deterministic CLI with human-readable and JSON output.
Use this when
- A user asks for cheap or discounted things to do in New Zealand
- A user wants Bookme activity, experience, tour, restaurant, or last-minute deal lookup
- A user wants current hot/featured Bookme offers
- A user wants cheapest current Bookme deals in a region
- A user has a Bookme deal id or URL and wants public deal details
- A workflow needs machine-readable public Bookme deal data
Do not use this for
- Booking, checkout, payment, cart, voucher redemption, login, favourites, account, or operator actions
- Official venue ticketing outside Bookme
- Non-Bookme deal marketplaces or historical price tracking
- High-volume scraping or dataset redistribution
- Claims that a Bookme deal is available beyond the current live snapshot
Preferred workflow
- Run
scripts/cli.pywith the narrowest subcommand that answers the task - Use
deals --region ... --category ...for region/category discount scans - Use
cheapestfor lowest current discounted prices andhotfor featured offers - Use
searchfor keyword lookups such as activity names, operators, or themes - Use
deal <id-or-url>after selecting a result to fetch public detail fields - Use
regionsandcategoriesto discover supported slugs - Use
--jsonfor agent chaining, alerts, comparisons, or structured reports
CLI
Run with:
python3 skills/bookme-nz/scripts/cli.py <command> [flags]
Commands
search <query> [--region name] [--category slug/id] [--sort featured|discount|low|high] [--limit N] [--json]— search current discounted deals by keyworddeals [--region name] [--category slug/id] [--sort featured|discount|low|high] [--limit N] [--json]— list current discounted dealscheapest [--region name] [--category slug/id] [--limit N] [--json]— cheapest current discounted dealshot [--region name] [--limit N] [--json]— featured/hot discounted dealsdeal <id-or-slug-or-url> [--region name] [--json]— fetch public detail fields for one dealregions [--json]— list supported Bookme NZ regionscategories [--query text] [--limit N] [--json]— list/search supported deal categories
Examples:
python3 skills/bookme-nz/scripts/cli.py deals --region auckland --category jet-boating --limit 5
python3 skills/bookme-nz/scripts/cli.py cheapest --region queenstown --category jet-boating --limit 10 --json
python3 skills/bookme-nz/scripts/cli.py search curry --region wellington --category restaurants --json
python3 skills/bookme-nz/scripts/cli.py hot --region rotorua --limit 5 --json
python3 skills/bookme-nz/scripts/cli.py deal 8004 --region auckland --json
Resources
- CLI entrypoint:
scripts/cli.py - API and stability notes:
references/api-notes.md
Notes
- No API key, username, password, account cookie, private token, or browser session is required for supported read-only commands
- The CLI uses Bookme's public website JSON deal endpoints and public detail pages only
- Discount-focused commands require
reduction_raw > 0, so price-guarantee or reservation-only cards are not treated as discounted deals - Treat prices, spaces, dates, and discounts as live Bookme snapshots that can change or sell out quickly
- Bookme.co.nz is the upstream source for all deal data returned by this skill