CLI for Rohlik Group grocery services - search products, manage cart, view orders, and get personalized shopping suggestions.
Note
This is a fork of rohlik-mcp converted from an MCP server into a standalone CLI with a SKILL.md for agentic use.
Warning
This CLI uses reverse-engineered Rohlik APIs. For personal use only.
Supported Services:
- 🇨🇿 Rohlik.cz - Czech Republic
- 🇩🇪 Knuspr.de - Germany
- 🇦🇹 Gurkerl.at - Austria
- 🇭🇺 Kifli.hu - Hungary
- 🇷🇴 Sezamo.ro - Romania
Requires Bun runtime.
# Clone and install
git clone https://github.com/timolins/rohlik-cli.git
cd rohlik-cli
bun install
# Link globally to use 'rohlik' command anywhere
bun link
# Set credentials
export ROHLIK_USERNAME="your-email@example.com"
export ROHLIK_PASSWORD="your-password"
# Optional: Set region (defaults to rohlik.cz)
export ROHLIK_BASE_URL="https://www.knuspr.de"Without global link: If you skip
bun link, run commands withbun run rohlikinstead ofrohlik.
# Search for products
rohlik search "milk"
rohlik search "bread" --limit 20 --favourites
# Manage cart
rohlik cart # View cart
rohlik cart add 12345 # Add product by ID
rohlik cart add 12345 --quantity 3
rohlik cart remove ABC123 # Remove by cart item ID
# View orders
rohlik orders # Order history
rohlik orders --limit 20
rohlik order 12345 # Order details
# Delivery
rohlik delivery # Delivery info + upcoming orders
rohlik slots # Available delivery slots
# Account
rohlik account # Premium status, bags, announcements
# Smart shopping
rohlik frequent # Most purchased items
rohlik frequent --orders 10 --top 20 --categories
rohlik meals breakfast # Meal suggestions
rohlik meals dinner --count 15Add --json to any command for machine-readable output:
rohlik search "milk" --json
rohlik cart --json
rohlik frequent --json| Command | Description |
|---|---|
search <query> |
Search for products |
cart |
View cart contents |
cart add <id> |
Add product to cart |
cart remove <id> |
Remove item from cart |
orders |
View order history |
order <id> |
View order details |
delivery |
View delivery info |
slots |
View delivery slots |
account |
View account info |
frequent |
View frequently purchased items |
meals <type> |
Get meal suggestions (breakfast, lunch, dinner, snack, baking, drinks, healthy) |
| Variable | Required | Description |
|---|---|---|
ROHLIK_USERNAME |
Yes | Your Rohlik email |
ROHLIK_PASSWORD |
Yes | Your Rohlik password |
ROHLIK_BASE_URL |
No | Service URL (default: https://www.rohlik.cz) |
ROHLIK_DEBUG |
No | Enable debug logging |
# Run in dev mode
bun run dev
# Run tests
bun test
# Run tests in watch mode
bun test --watch- Check credentials in environment variables
- Enable debug:
export ROHLIK_DEBUG=true - Verify account works on Rohlik website
Smart shopping features (frequent, meals) require past orders.
- Reduce
--orderscount for smart features - API has rate limiting (~100ms between requests)
MIT - see LICENSE
- dvejsada/HA-RohlikCZ for reverse engineering the Rohlik API