| name | baby-factory-nz |
| description | Use when searching Baby Factory NZ products, checking current public sale prices, or reading product details and offers. Parses bounded public search-page state and product JSON-LD through a read-only Python CLI; no cart, checkout, account, payment, booking, hire, registry, or other mutations. |
| license | MIT |
| compatibility | Requires Python 3.10+ and network access for live data |
| metadata | {"thecolab.category":"retail","thecolab.source_owner":"The Baby Factory","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.babyfactory.co.nz","thecolab.allowed_domains":"www.babyfactory.co.nz","thecolab.last_verified":"2026-07-19","thecolab.health":"healthy","thecolab.maintainer":"@adam91holt"} |
Baby Factory NZ
Goal
Retrieve current public Baby Factory NZ search, product, offer, and price data without login or browser automation.
Use this when
- Searching Baby Factory products by keyword
- Checking a current public sale or regular price
- Reading Product JSON-LD for a known product URL or slug
Do not use this for
- Cart, checkout, account, payment, booking, hire, gift registry, order, stock reservation, or mutations
- Child-safety or medical advice; consult product manuals and qualified professionals
- Bulk scraping, historical-price claims, or redistribution as a dataset
Workflow
- Use
search for discovery. Results are capped at 20 and parsed from bounded public page state.
- Use
product for one Baby Factory product URL or slug.
- Use
price-snapshot for a compact current offer record.
- Add
--json for machine-readable output. Every command reports source_url and UTC retrieved_at.
- Treat values as live website observations; verify safety-critical specifications against the manufacturer.
CLI
python3 skills/baby-factory-nz/scripts/cli.py search "car seat" --limit 5 --json
python3 skills/baby-factory-nz/scripts/cli.py product disney-baby-everslim-4-in-1-convertible-car-seat-vintage-disney-4020561-black-grey --json
python3 skills/baby-factory-nz/scripts/cli.py price-snapshot https://www.babyfactory.co.nz/disney-baby-everslim-4-in-1-convertible-car-seat-vintage-disney-4020561-black-grey --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 parses bounded
window.category JSON; detail commands parse Product JSON-LD.
- Responses are size-capped and normalized; raw HTML is never emitted.
- Missing, malformed, or incomplete product data fails rather than returning fabricated success.
Resources
- CLI:
scripts/cli.py
- Live and fixture smoke tests:
scripts/smoke_test.py
- Endpoint, parser, and safety notes:
references/api-notes.md
