| name | animates-nz |
| description | Use when looking up Animates NZ products, current public prices, availability, or product details. Queries bounded public Magento search results and parses product-page JSON-LD through a read-only Python CLI; no cart, checkout, account, payment, prescription, booking, grooming, or other mutations. |
| license | MIT |
| compatibility | Requires Python 3.10+ and network access for live data |
| metadata | {"thecolab.category":"retail","thecolab.source_owner":"Animates New Zealand","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.animates.co.nz","thecolab.allowed_domains":"www.animates.co.nz","thecolab.last_verified":"2026-07-19","thecolab.health":"healthy","thecolab.maintainer":"@adam91holt"} |
Animates NZ
Goal
Retrieve current public Animates NZ product search and detail data without login or browser automation.
Use this when
- Searching Animates NZ products by keyword
- Looking up a public Animates product URL or numeric product ID
- Capturing a current price and availability snapshot with source evidence
Do not use this for
- Cart, checkout, account, Petpoints, payment, prescription, booking, grooming, hire, stock reservation, or any mutation
- Medical or veterinary advice
- Bulk scraping, historical-price claims, or redistribution as a dataset
Workflow
- Use
search to discover products. Results are capped at 10 and each result is verified against its public detail page.
- Use
product for one known Animates URL, .html path, or numeric product ID.
- Use
price-snapshot for the smallest price-and-availability record.
- Add
--json for machine-readable output. Every command reports source_url and UTC retrieved_at.
- Treat values as live website observations, not guaranteed store stock or a historical record.
CLI
python3 skills/animates-nz/scripts/cli.py search "dog food" --limit 3 --json
python3 skills/animates-nz/scripts/cli.py product 18463 --json
python3 skills/animates-nz/scripts/cli.py price-snapshot 18463 --json
The global --timeout N option goes before the command and defaults to 10 seconds.
Output and safety
- Uses Python standard library only and unauthenticated GET requests.
- Search uses the public Magento read-only search endpoint only to obtain bounded product IDs, then parses Product JSON-LD from detail HTML.
- Responses are size-capped; malformed or incomplete upstream data fails instead of returning fabricated success.
- Search can make one search request plus up to
--limit detail requests; keep limits narrow.
Resources
- CLI:
scripts/cli.py
- Live and fixture smoke tests:
scripts/smoke_test.py
- Endpoint, parser, and safety notes:
references/api-notes.md
