Wolt CLI

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.

Created 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