✓ Verified 🌐 Web Scrapers ✓ Enhanced Data

Kroger Api Skill

Skill for searching Kroger/QFC products, managing cart, checking pickup availability, and creating p

Rating: 4.5 (93 reviews)
Downloads: 34,950 downloads
Version: 1.0.0

Overview

Skill for searching Kroger/QFC products, managing cart, checking pickup availability, and creating pickup orders.

Complete Documentation

View Source →

Kroger/QFC API Skill

Overview

Skill for searching Kroger/QFC products, managing cart, checking pickup availability, and creating pickup orders. Uses official Kroger API. QFC chain ID: 213.

Setup

Sign up at developer.kroger.com, create app.
Add redirect URI e.g. http://localhost
Scopes: product.compact locations.read fulfillment.readwrite orders.pickup.create
Edit state.json: add client_id, client_secret, chain_id: \"213\"
OAuth:
python3 scripts/client.py --state state.json oauth-url
Visit URL, login, authorize.
Copy code from redirect (e.g. http://localhost?code=ABC123)
python3 scripts/client.py --state state.json oauth-exchange ABC123

Usage (via exec)

Run from workspace root:

Search products

text

python3 kroger-api.skill/scripts/client.py search \"milk\" --chain-id 213 --limit 5

Output: JSON products with id (UPC), attributes.description, attributes.brand etc.

Find locations

text

python3 kroger-api.skill/scripts/client.py locations 98101 --chain-id 213

Output: locations with id, attributes.address.addressLine1 etc.

Cart (local)

text

python3 kroger-api.skill/scripts/client.py cart-add 0001111101001 2  # UPC qty
python3 kroger-api.skill/scripts/client.py cart-get
python3 kroger-api.skill/scripts/client.py cart-clear

Check availability

text

python3 kroger-api.skill/scripts/client.py availability LOC123 --items '[{&quot;upc&quot;:&quot;UPC&quot;,&quot;quantity&quot;:1}]'

Create order

text

python3 kroger-api.skill/scripts/client.py order-create LOC123 \&quot;2026-02-14T10:00:00Z\&quot; --items '[{&quot;upc&quot;:&quot;UPC&quot;,&quot;quantity&quot;:1}]'

Grocery list integration

Create grocery-list.txt:

text

milk
bread
eggs

text

python3 kroger-api.skill/scripts/client.py grocery --zip 98101

Lists items & locations. Agent: for each item search, pick UPC (e.g. first result), add_to_cart, then availability, order.

Agent Workflow Example

User: "Add milk and eggs to Kroger cart"
Search "milk", pick UPC1, cart-add
Search "eggs", pick UPC2, cart-add
User: "Find QFC near 98101" → locations
Set location-set LOC
cart-get → items
availability → pick slot
order-create with slot time.

State

state.json: tokens, cart, location_id.

Notes

Endpoints based on Kroger API docs. Verify at developer.kroger.com/reference
UPC from products.id
Pickup datetime: ISO 8601 UTC
Errors: check API response
Token auto-refreshes.

Package as kroger-api.skill/

Installation

Terminal bash


openclaw install kroger-api-skill

Copied!

💻Code Examples

### Cart (local)

-cart-local.txt

python3 kroger-api.skill/scripts/client.py cart-add 0001111101001 2  # UPC qty
python3 kroger-api.skill/scripts/client.py cart-get
python3 kroger-api.skill/scripts/client.py cart-clear