Browse-only Wolt consumer CLI. Lists cities, finds venues near a lat/lon,
searches venues and items, and pulls per-venue delivery/ETA snapshots.
Built on Wolt's unauthenticated consumer endpoints discovered via reverse
engineering (OzTamir gist + live browser-sniff). No login, no cart, no orders.
Printed by @Amit-Tabibi (Amit).
Quick Start
1. Install
See Install above.
2. Verify Setup
wolt-pp-cli doctor
This checks your configuration.
3. Try Your First Command
wolt-pp-cli cities
Usage
Run wolt-pp-cli --help for the full command reference and flag list.
Commands
cities
Manage cities
wolt-pp-cli cities - Returns the global list of Wolt cities with country code, slug, timezone,
and coordinates. Backbone of the local store.
order-xp
Manage order xp
wolt-pp-cli order-xp <slug> - Per-venue dynamic snapshot: open_status, delivery_open_status, time_slots_schedule,
delivery_configs, banners. Combined with LD+JSON SSR scrape in Phase 3 for full
venue metadata (name, address, phone, rating, cuisine).
pages
Manage pages
wolt-pp-cli pages list-restaurants-near - Returns the discovery page for a given location: venues organized in sections
with name, slug, online status, ETA, delivery fee, rating, tags.wolt-pp-cli pages search - POST with body {q, target, lat, lon}. Set target="venues" to search restaurants,
target="items" to search dishes across venues.
venues
Manage venues
wolt-pp-cli venues <slug> - Documented community endpoint. As of the last sniff, returns HTTP 200 with
empty body via CloudFront cache. The CLI surfaces this honestly and includes
--debug to capture the failing request for upstream investigation.
Output Formats
# Human-readable table (default in terminal, JSON when piped)
wolt-pp-cli cities
# JSON for scripting and agents
wolt-pp-cli cities --json
# Filter to specific fields
wolt-pp-cli cities --json --select id,name,status
# Dry run — show the request without sending
wolt-pp-cli cities --dry-run
# Agent mode — JSON + compact + no prompts in one flag
wolt-pp-cli cities --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
- Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
- 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
wolt-pp-cli doctor
Verifies configuration and connectivity to the API.
Configuration
Config file: ~/.config/wolt-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
HTTP Transport
This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.
Generated by CLI Printing Press