Local OpenAPI seed extracted from the working housebuy Worten CLI.
This does not claim to describe the full Worten platform.
It only captures the load-bearing endpoints currently used by the housebuy operator.
Created by @asantos00 (Alexandre Santos).
Current Boundary
This binary is now the intended source of truth for Worten retailer behavior:
resolveproductbuyerstockspecssuggestsearchsnapshot
The generated worten-api subtree remains available as the raw endpoint layer, but housebuy should consume the normalized commands above.
Quick Start
1. Verify Setup
worten-pp-cli doctor
This checks the base configuration and connectivity assumptions.
2. Try the normalized commands
worten-pp-cli resolve 11111111-1111-1111-1111-111111111111
worten-pp-cli product 11111111-1111-1111-1111-111111111111
worten-pp-cli buyer 11111111-1111-1111-1111-111111111111
worten-pp-cli snapshot 11111111-1111-1111-1111-111111111111 --refresh
Usage
Run worten-pp-cli --help for the full command reference and flag list.
Commands
normalized
worten-pp-cli resolve - Resolve a Worten product URL or slug to a canonical product identifier.worten-pp-cli product - Fetch the normalized retailer view for a product.worten-pp-cli buyer - Fetch the normalized buyer view used by housebuy.worten-pp-cli stock - Fetch normalized stock, shipping, seller, and optional nearby-store context.worten-pp-cli specs - Fetch Worten technical specifications with a stable wrapper shape.worten-pp-cli suggest - Fetch normalized search suggestions.worten-pp-cli search - Search Worten products with explicit contexts.worten-pp-cli snapshot - Persist and return normalized snapshot payloads.
worten-api
Manage worten api
worten-pp-cli worten-api get-offer-stock - Fetch nearby store pickup stock for an offer.worten-pp-cli worten-api get-product-details - Fetch product details by Worten product identifier.worten-pp-cli worten-api get-search-suggestions - Fetch search suggestions for a text query.worten-pp-cli worten-api get-technical-specifications - Fetch technical specifications for a Worten product.worten-pp-cli worten-api search-products - Search Worten products by query and context.
Output Formats
# Human-readable table (default in terminal, JSON when piped)
worten-pp-cli worten-api get-offer-stock --offer-id 550e8400-e29b-41d4-a716-446655440000 --search-query example-value --radius 42
# JSON for scripting and agents
worten-pp-cli worten-api get-offer-stock --offer-id 550e8400-e29b-41d4-a716-446655440000 --search-query example-value --radius 42 --json
# Filter to specific fields
worten-pp-cli worten-api get-offer-stock --offer-id 550e8400-e29b-41d4-a716-446655440000 --search-query example-value --radius 42 --json --select id,name,status
# Dry run — show the request without sending
worten-pp-cli worten-api get-offer-stock --offer-id 550e8400-e29b-41d4-a716-446655440000 --search-query example-value --radius 42 --dry-run
# Agent mode — JSON + compact + no prompts in one flag
worten-pp-cli worten-api get-offer-stock --offer-id 550e8400-e29b-41d4-a716-446655440000 --search-query example-value --radius 42 --agent
Agent Usage
This CLI is designed for AI agent consumption:
- Non-interactive - never prompts, every input is a flag
- Pipeable -
--json output to stdout, errors to stderr
- Filterable -
--select id,name returns only fields you need
- Previewable -
--dry-run shows the request without sending
- Explicit retries - add
--idempotent to create retries when a no-op success is acceptable
- Confirmable -
--yes for explicit confirmation of destructive actions
- Piped input - write commands can accept structured input when their help lists
--stdin
- Offline-friendly - sync/search commands can use the local SQLite store when available
- Agent-safe by default - no colors or formatting unless
--human-friendly is set
Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.
Health Check
worten-pp-cli doctor
Verifies configuration and connectivity to the API.
Configuration
Config file: ~/.config/worten-reverse-engineered-pp-cli/config.toml
Static request headers can be configured under headers; per-command header overrides take precedence.
Troubleshooting
Not found errors (exit code 3)
- Check the resource ID is correct
- Run the
list command to see available items
Generated by CLI Printing Press