briscoes-nz
Query Briscoes NZ homewares product search, sale/deal snapshots, SKU detail, and store-finder. Use for Briscoes product lookup, prices, sale products, or store locations. No cart or account.
SKILL.mdskills/briscoes-nz/SKILL.md
GitHubBriscoes NZ
Goal
Query live Briscoes NZ product and store data through a small deterministic CLI with human-readable and JSON output, without browser automation or account login.
Use this when
- A user asks for Briscoes NZ product prices or sale/deal products
- A user wants to search Briscoes products by keyword
- A user has a Briscoes SKU and wants product details
- A user wants Briscoes store locations or contact details
- A workflow needs lightweight machine-readable Briscoes public product or store data
Do not use this for
- Non-Briscoes retailers or Briscoes Group brands other than Briscoes NZ
- Authenticated account, rewards, personalised, cart, checkout, order, gift registry, or payment actions
- Redistributing scraped Briscoes product data as a dataset
- Historical pricing or price-change claims unless another dataset provides history
Preferred workflow
- Run
scripts/cli.pywith the narrowest subcommand that answers the task - Use
searchfor keyword price/product lookup - Use
specialsfor sale/deal-flagged products; this is a search-derived view verified against Magento product pricing, not a dedicated Briscoes specials API - Use
productwhen an exact SKU is known and full Magento price-range detail matters - Use
stores --regionto narrow store-finder results by city, region, suburb, or name - Use
--jsonfor agent chaining, comparisons, alerts, or structured reports - Mention that prices are live Briscoes online snapshots and the source is unofficial
CLI
Run with:
python3 skills/briscoes-nz/scripts/cli.py <command> [flags]
Commands
search <query> [--limit N] [--page N] [--json]- product search with current pricesproduct <sku> [--json]- fetch exact SKU detailstores [--region text] [--json]- list public Briscoes store-finder locationsspecials [query] [--limit N] [--page N] [--json]- sale/deal-flagged products verified to have a sale price below regular price, optionally filtered by query
Examples:
python3 skills/briscoes-nz/scripts/cli.py search towel --limit 10
python3 skills/briscoes-nz/scripts/cli.py search "cast iron" --limit 5 --json
python3 skills/briscoes-nz/scripts/cli.py product 1129433 --json
python3 skills/briscoes-nz/scripts/cli.py stores --region auckland --json
python3 skills/briscoes-nz/scripts/cli.py specials bedding --limit 10 --json
Resources
- CLI entrypoint:
scripts/cli.py - Live smoke test:
scripts/smoke_test.py - API and stability notes:
references/api-notes.md
Notes
- No API key secret, username, password, account cookie, or browser automation is required for supported read-only operations
- Briscoes uses an Adobe Commerce/Magento PWA backed by Klevu for product search/listing
searchuses Klevu search data;specialsuses Klevu discovery plus Magento price verification;productandstoresuse Briscoes Magento GraphQL- Endpoint shapes can change; verify with a small live query before relying on large workflows
- Keep usage narrow and respectful