playbooks

home / skills / michalvavra / agents / rohlik-grocery

rohlik-grocery skill

/skills/rohlik-grocery

This skill helps you search products, add to cart, and manage Rohlik orders via MCPorter, enabling streamlined grocery shopping automation.

npx playbooks add skill michalvavra/agents --skill rohlik-grocery

Review the files below or copy the command above to add this skill to your agents.

Files (3)
SKILL.md
2.4 KB
---
name: rohlik-grocery
description: Grocery shopping via Rohlik.cz.
compatibility: Requires Node.js, MCPorter, and Rohlik.cz credentials (RHL_EMAIL, RHL_PASS).
---

# Rohlik Grocery

Shop via the Rohlik.cz MCP server using MCPorter.

## Usage

```bash
npx mcporter list rohlik
npx mcporter list rohlik --schema
npx mcporter call rohlik.search_products keyword="milk" include_fields='["productId","productName","price","inStock","textualAmount"]'
npx mcporter call rohlik.add_items_to_cart items='[{"productId":1234567,"quantity":1}]'
npx mcporter call rohlik.get_cart
npx mcporter call rohlik.<checkout_tool> key=value
```

Use `mcporter list rohlik --schema` to identify the exact checkout tool name and required parameters.

## Workflow

1. List tools with `mcporter list rohlik` and inspect schemas.
2. Search products and capture `productId` values.
3. Add items to cart with `add_items_to_cart`.
4. Review cart contents and fees using `get_cart`.
5. If checkout requires a slot, use the slot tool from the schema.
6. Ask for explicit confirmation before checkout.

## Common Tasks

Favorites:

```bash
npx mcporter call rohlik.get_all_user_favorites
npx mcporter call rohlik.get_user_favorites_from_categories category_ids='[300105000]'
```

Shopping lists:

```bash
npx mcporter call rohlik.get_user_shopping_lists_preview
npx mcporter call rohlik.get_user_shopping_list_detail shopping_list_id=12345
npx mcporter call rohlik.create_shopping_list name="Weekly Groceries"
npx mcporter call rohlik.add_products_to_shopping_list list_id=12345 product_id=1234567 amount=2
```

Order history:

```bash
npx mcporter call rohlik.fetch_orders limit=2
npx mcporter call rohlik.fetch_orders date_from=2025-12-01 date_to=2025-12-31
npx mcporter call rohlik.repeat_order order_id=12345678
```

## Examples

Search, add, and review cart:

```bash
npx mcporter call rohlik.search_products keyword="eggs" include_fields='["productId","productName","price","inStock"]'
npx mcporter call rohlik.add_items_to_cart items='[{"productId":1234567,"quantity":2}]'
npx mcporter call rohlik.get_cart
```

## Output

MCPorter returns JSON by default. Pipe through `jq` when you need structured filtering.

## Safety

Never run checkout or order submission without explicit user confirmation.

---

See [references/setup.md](references/setup.md) for setup details and device approval on first use.
See [references/examples.md](references/examples.md) for favorites, lists, and order flows.

Overview

This skill enables grocery shopping on Rohlik.cz through the MCPorter interface. It exposes search, cart, favorites, shopping lists, and order history tools so agents can discover products, manage carts, and prepare checkouts programmatically. It returns JSON responses suitable for automated workflows and human review.

How this skill works

The skill calls Rohlik APIs via MCPorter tools. You list available tools and schemas, search products to capture productId values, add items to the cart, and inspect cart contents and fees. Checkout tools vary by account and may require selecting a delivery slot; the schema reveals required parameters.

When to use it

  • Automating recurring grocery orders based on saved shopping lists or favorites
  • Building chat interfaces that let users search Rohlik products and assemble a cart
  • Integrating Rohlik shopping flows into personal assistants or task automation
  • Reviewing cart totals and fees before initiating checkout
  • Fetching order history or repeating past orders programmatically

Best practices

  • Run mcporter list rohlik --schema first to identify available tools and required parameters
  • Always capture productId from search results; product names can change but IDs are stable
  • Inspect get_cart output to verify quantities, substitutions, and delivery fees before checkout
  • Require explicit, user-confirmed approval before executing any checkout or order submission
  • Pipe output through jq or similar JSON tools for deterministic parsing in scripts

Example use cases

  • Search for 'milk', add a specific productId to the cart, then show the cart summary to the user
  • Create a weekly shopping list, add multiple items by productId, and reuse it each week
  • Fetch recent orders and call repeat_order to recreate a past purchase
  • List user favorites and programmatically add preferred items to a promotional basket

FAQ

How do I discover the exact checkout tool name and parameters?

Run npx mcporter list rohlik --schema to view available tools and their parameter schemas.

What response format does the skill return?

MCPorter returns JSON by default; use jq for structured filtering and human-friendly output.