---
name: mitre10-nz
description: Query Mitre 10 NZ public product search, specials, store locator, and product detail endpoints through a lightweight no-login CLI. Use when the task involves Mitre 10 NZ product lookup, online hardware prices, catalogue specials, store locations, product codes, or machine-readable Mitre 10 product data. Read-only; no cart, checkout, account, or order actions.
---

# Mitre 10 NZ

## Goal

Query live Mitre 10 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 Mitre 10 NZ product prices or specials
- A user wants to search Mitre 10 products by keyword
- A user has Mitre 10 product codes and wants product details
- A user needs Mitre 10 store locations or contact details
- A user needs lightweight machine-readable Mitre 10 product or store data
- A workflow needs a fast read-only alternative to browser-driven Mitre 10 tooling

## Do not use this for

- Mitre 10 Australia or non-Mitre 10 retailers
- Authenticated account, Club, personalised pricing, delivery-slot, cart, checkout, order, wishlist, or quote actions
- Redistributing scraped Mitre 10 product data as a dataset
- Historical pricing or price-change claims unless another dataset provides history

## Preferred workflow

1. Run `scripts/cli.py` with the narrowest subcommand that answers the task
2. Use `search` for keyword price/product lookup and `specials` for promotional products
3. Use `product` when exact product codes are known
4. Use `stores` for store lookup, optionally with `--region` for a city, suburb, or region query
5. Use `--json` for agent chaining, comparisons, or structured reports
6. Mention that prices are live online Mitre 10 snapshots and the source is unofficial

## CLI

Run with:

```bash
python3 skills/mitre10-nz/scripts/cli.py <command> [flags]
```

### Commands

- `search <query> [--limit N] [--page N] [--json]` - product search with prices
- `specials [query] [--limit N] [--page N] [--json]` - promotional products
- `stores [--region text] [--limit N] [--page N] [--json]` - store locator results
- `product <code> [--json]` - fetch exact product details

Examples:

```bash
python3 skills/mitre10-nz/scripts/cli.py search drill --limit 10
python3 skills/mitre10-nz/scripts/cli.py search "circular saw" --limit 5 --json
python3 skills/mitre10-nz/scripts/cli.py specials drill --limit 10 --json
python3 skills/mitre10-nz/scripts/cli.py stores --region auckland
python3 skills/mitre10-nz/scripts/cli.py product 2030160 --json
```

## Resources

- CLI entrypoint: `scripts/cli.py`
- API and stability notes: `references/api-notes.md`

## Notes

- Mitre 10 product search and specials use Algolia public search-only credentials embedded in the site configuration
- Product detail and stores use unauthenticated SAP Commerce OCC endpoints on `ccapi.mitre10.co.nz`
- No username, password, account cookie, private token, or browser automation is required for read-only lookup
- Endpoint shapes and public Algolia keys can change; verify with a small live query before relying on large workflows
- Do not use this skill for cart mutation, checkout, order placement, account actions, or high-volume scraping