modbender Kroger
Search products, add to cart, and find store locations via the Kroger public API.
Prerequisites
- Kroger developer account at https://developer.kroger.com
- Registered application with Product and Cart API access
- OAuth redirect URI configured in the Kroger app settings
Environment Variables
Set these before using:
export KROGER_CLIENT_ID="your-client-id"
export KROGER_CLIENT_SECRET="your-client-secret"
Optional:
KROGER_TOKEN_FILE— token storage path (default:~/.kroger-tokens.json)KROGER_REDIRECT_URI— OAuth callback URL (default:http://localhost:8888/callback)KROGER_LOCATION_ID— store ID for location-specific product availability
Setup (One-Time)
1. Register a Kroger Developer App
- Go to https://developer.kroger.com
- Create an application
- Enable Product and Cart scopes
- Set redirect URI to
http://localhost:8888/callback - Note Client ID and Client Secret
2. Authenticate
Run the auth flow — opens a browser for Kroger login:
scripts/kroger.sh auth
If the redirect URI isn't localhost (e.g., cloud-hosted), use the manual flow:
- Open the
AUTH_URLprinted byscripts/kroger.sh auth - Log in at Kroger
- Copy the redirected URL (even if the page errors)
- Extract the
codeparameter and run:
scripts/kroger.sh exchange <code>
Tokens auto-refresh. Re-auth only needed if refresh token expires.
Actions
Search products
scripts/kroger.sh search "cannellini beans"
Returns up to 5 results with product IDs, descriptions, and brands.
Add to cart
scripts/kroger.sh add <productId> [quantity]
Requires prior OAuth login. Quantity defaults to 1.
Find nearby stores
scripts/kroger.sh locations <zipcode>
Returns up to 5 stores with location IDs. Set KROGER_LOCATION_ID to filter product search by store.
Check auth status
scripts/kroger.sh token
Workflow: Grocery List → Cart
Typical flow for adding a grocery list to Kroger:
- Search each item:
scripts/kroger.sh search "<item>" - Pick the best match from results
- Add to cart:
scripts/kroger.sh add <productId> <qty> - Repeat for all items
When adding many items, batch all searches first, then confirm selections with the user, then add all to cart.