wolt-cli（wolt CLI 搜索）

Wolt CLI

Tool repository: https://github.com/mekedron/wolt-cli

Open the repository for setup/build details, then use the local wolt binary:

wolt <group> <command> [flags]

Session Startup

1. Inspect command tree once per session:

wolt --help

1. Prefer machine output for agent work:

... --format json

1. Parse .data from the envelope and surface .warnings/.error to the user.

Safety Rules

• Start read-only by default.
• Request explicit confirmation before mutating commands:

- cart add, cart remove, cart clear - profile favorites add, profile favorites remove - profile addresses add, profile addresses update, profile addresses remove, profile addresses use - configure (writes local profile credentials)

• Never describe checkout preview as order placement. The CLI does not place final orders.

Auth Workflow

Use explicit profile names to avoid ambiguity:

wolt configure --profile-name default --wtoken "<token>" --wrtoken "<refresh-token>" --overwrite
wolt profile status --profile default --format json --verbose

Credential fallback for authenticated commands:

1. Explicit flags (--wtoken, --wrtoken, --cookie)
2. Selected profile auth fields
3. Default profile auth fields

When refresh credentials are available, expired/401 access tokens are refreshed automatically and persisted back to local config.

Location Rules

Apply exactly:

• Use either --address "<text>" or both --lat + --lon.
• Do not combine --address with --lat/--lon.
• If no override is passed, profile location is used.
• search venues/items and venue show/hours use --address or profile location (no direct --lat/--lon flags).
• discover, cart, checkout preview, and profile favorites support --lat/--lon.

Command Selection

• Explore nearby options: discover feed, discover categories, search venues, search items
• Inspect one venue deeply: venue show, venue categories, venue search, venue menu, venue hours
• Resolve one item/options for basket actions: item show, item options
• Basket and pricing: cart count/show/add/remove/clear, then checkout preview
• Account and history: profile show/status/orders/payments/addresses/favorites

For large marketplace venues, prefer:

• venue search <slug> --query "<text>"
• venue menu <slug> --category <category-slug>

instead of unrestricted full-catalog menu crawl.

Output and Diagnostics

• --format json|yaml returns envelope keys: meta, data, warnings, optional error.
• On upstream failures, rerun with --verbose to capture request trace and detailed diagnostics.

References

• Full command and flag matrix: references/command-reference.md
• Reusable high-confidence workflows: references/workflows.md
• Envelope/error parsing and automation notes: references/output-and-errors.md