| name | petstock-nz |
| description | Query Petstock NZ's public Algolia catalogue and product JSON-LD for bounded product search, current standard and Autoship prices, public offers, rewards signals, and online availability. Use when comparing Petstock NZ products or checking a known product handle, URL, or SKU. Read-only; no account, cart, checkout, payment, vet, booking, or other mutations. |
| license | MIT |
| compatibility | Requires Python 3.10+ and network access for live data |
| metadata | {"thecolab.category":"retail","thecolab.source_owner":"Petstock","thecolab.source_type":"commercial","thecolab.auth":"none","thecolab.access_mode":"html-readonly","thecolab.data_class":"public","thecolab.writes":"false","thecolab.browser":"false","thecolab.risk":"low","thecolab.cache_ttl":"24h","thecolab.schema_version":"1","thecolab.skill_type":"html-readonly","thecolab.pack":"nz-commercial-web","thecolab.source_url":"https://www.petstock.co.nz","thecolab.allowed_domains":"hx85npq0xp-dsn.algolia.net,www.petstock.co.nz","thecolab.last_verified":"2026-07-19","thecolab.health":"healthy","thecolab.maintainer":"@adam91holt"} |
Petstock NZ
Goal
Retrieve current public Petstock NZ catalogue, product, offer, price, and availability evidence without login or browser automation.
Use this when
- Searching Petstock NZ products by keyword
- Checking a known product handle, public URL, or retailer SKU
- Comparing standard and conditional Autoship prices
- Capturing current online availability, delivery, and click-and-collect eligibility
- Reading public rewards signals without treating them as a member discount
Do not use this for
- Account, cart, checkout, payment, order, Autoship enrolment, rewards redemption, vet, booking, prescription, or other mutations
- Veterinary advice or product-suitability decisions
- Store-specific stock promises, historical-price claims, bulk scraping, or GTIN/barcode lookup
Workflow
- Use
search for bounded discovery from Petstock's shipped public read-only Algolia frontend configuration.
- Use
product with a result URL, handle, or numeric SKU for Product JSON-LD offers plus exact-SKU, exact-handle catalogue variants.
- Use
price-snapshot to keep standard, sale, Autoship, member-price, and rewards concepts separate.
- Use
availability for public online and fulfilment flags. These are snapshots, not reservations.
- Add
--json for agent chaining. Every successful command includes source_url and UTC retrieved_at.
CLI
python3 skills/petstock-nz/scripts/cli.py search "dog food" --limit 5 --json
python3 skills/petstock-nz/scripts/cli.py product orijen-original-dog-food --json
python3 skills/petstock-nz/scripts/cli.py price-snapshot 122731000059 --json
python3 skills/petstock-nz/scripts/cli.py availability https://www.petstock.co.nz/products/orijen-original-dog-food --json
The global --timeout N option goes before the command and defaults to 10 seconds.
Interpretation rules
sku is the retailer-supplied identifier. Numeric shape alone does not make it a GTIN, UPC, EAN, or barcode; those fields remain null because no independently labelled barcode field was verified.price_nzd is the current public standard/sale price in the catalogue record.autoship.price_nzd is a conditional recurring-order offer, not a standard or member price.member_price remains unavailable unless a distinct public member-price field is verified.- Rewards programme eligibility and Everyday Rewards point estimates are not cash prices or guaranteed entitlements.
- Confirm price, availability, eligibility, and product suitability on the source page before acting.
Safety
- Uses Python standard library only and unauthenticated read-only requests.
- Calls only the shipped non-mutating Algolia frontend configuration and public Petstock product pages.
- HTTPS origins, ports, credentials, redirects, response sizes, result counts, pages, and timeouts are bounded.
- Missing or malformed search/product data fails closed with a clean error.
Resources
- CLI:
scripts/cli.py
- Fixture and outage-aware live checks:
scripts/smoke_test.py
- Verified surface and field notes:
references/api-notes.md
