auctionzip-cli

Execute AuctionZip operations using the `auctionzip` CLI. All AuctionZip interactions should use this CLI. The `auctionzip` CLI follows this pattern: ```bash auctionzip [arguments] [options] ```

Task	Command
Authenticate (one-time headed Cloudflare clear)	auctionzip auth login
Check auth / Cloudflare clearance	auctionzip auth status
Search lots by keyword	auctionzip search "lego" --limit 10 --table
Get one lot's full detail	auctionzip get "<lot-url-or-slug_ref>" --table
Fresh read (bypass cache)	auctionzip --no-cache get "<lot-url>"

Auth model: auctionzip.com hard-blocks headless browsers at Cloudflare. auth login runs a one-time headed pass that mints a cf_clearance cookie in the persistent profile; search/get reuse that session. No AuctionZip account is required to read lots. If a command reports a Cloudflare block, re-run auctionzip auth login --force.
</quick_start>

**MANDATORY: Verify the live command shape before executing ANY `auctionzip` command.** Consult `usage.json` when the repo or installed package ships it. If `usage.json` is absent, use `auctionzip --help`, the relevant subcommand `--help`, and `README.md` instead. Never guess at command syntax. - **search ``** -- Search public AuctionZip lots by keyword. List-style: `--limit/-l`, `--filter/-f`, `--table/-t`, `--properties/-p`. Returns `ref`, `lot_number`, `title`, `auction_house`, `current_bid`, `bids`, `time_remaining`/`close_time`, `estimate`, `url`. - **get ``** -- Full detail for one lot by URL, `slug_ref`, or bare ref. `--table/-t`, `--properties/-p`. Returns current bid, bid count, next bid, `buyer_premium`, `status`, `auction_type`, `close_time`, `location`, `accepted_payment`, `shipping_terms`, `conditions_of_sale`, `image_urls`, and more. - `image_urls` is the lot's OWN gallery at full size (`_original.jpg`), in page order. A lot page also renders the PREVIOUS and NEXT lots' thumbnails; those are `prev-next-image` and are excluded, so a photo is never attributed to the wrong lot. `[]` means the lot genuinely has no photos. - **auth** -- Authentication management (login, logout, status, test) and nested `auth profiles` - **cache** -- Local response cache management `current_bid`, `bids`, and `status` are snapshots cached by default. For a live read of the current bid before acting, pass `--no-cache`. </essential_principles> **`usage.json`** -- Complete command tree with arguments, options, defaults, and usage instructions when present. **`auctionzip --help` and subcommand `--help`** -- Live installed command tree and option list. **`README.md`** -- Supplemental examples and workflow notes. </reference_index> - Command executes without error - Output is displayed in requested format - Correct command and flags used, verified against the live help output or `usage.json` when present </success_criteria>