🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Kroger Api.Skill
πŸ¦€ ClawHub

Kroger Api.Skill

by @jasonahorn

Search Kroger/QFC products, manage cart, check pickup availability, and create pickup orders using the official Kroger API.

Versionv1.0.0
Downloads1,448
Stars⭐ 1
#legal#productivity
TERMINAL
clawhub install kroger-api-skill

πŸ“– About This Skill

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

1. Sign up at developer.kroger.com, create app. 2. Add redirect URI e.g. http://localhost 3. Scopes: product.compact locations.read fulfillment.readwrite orders.pickup.create 4. Edit state.json: add client_id, client_secret, chain_id: \"213\" 5. 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

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

python3 kroger-api.skill/scripts/client.py locations 98101 --chain-id 213
Output: locations with id, attributes.address.addressLine1 etc.

Cart (local)

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

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

Create order

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

Grocery list integration

Create grocery-list.txt: 
milk
bread
eggs

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

1. User: "Add milk and eggs to Kroger cart" 2. Search "milk", pick UPC1, cart-add 3. Search "eggs", pick UPC2, cart-add 4. User: "Find QFC near 98101" β†’ locations 5. Set location-set LOC 6. cart-get β†’ items 7. availability β†’ pick slot 8. 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/

    βš™οΈ Configuration

    1. Sign up at developer.kroger.com, create app. 2. Add redirect URI e.g. http://localhost 3. Scopes: product.compact locations.read fulfillment.readwrite orders.pickup.create 4. Edit state.json: add client_id, client_secret, chain_id: \"213\" 5. 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

    πŸ“‹ Tips & Best Practices

  • 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/