Kroger Api Skill

What This Skill Does

The Kroger API Skill allows OpenClaw users to interact directly with the official Kroger and QFC grocery ecosystem. It acts as a comprehensive bridge between your AI agent and the supermarket infrastructure, enabling you to search for thousands of products, manage a local shopping cart, find nearby store locations, verify product availability for pickup, and initiate orders. By utilizing the official Kroger developer platform, this skill transforms your AI assistant into a personal digital shopper capable of handling your grocery logistics automatically.

Installation

To integrate this skill, ensure you have the OpenClaw environment configured. Run the following command: clawhub install openclaw/skills/skills/jasonahorn/kroger-api-skill.

After installation, follow the setup guide: create an account at developer.kroger.com, register your application, and define the necessary scopes (product.compact, locations.read, fulfillment.readwrite, orders.pickup.create). Populate your state.json file with your credentials and chain ID (213 for QFC). Perform the OAuth handshake via the provided CLI scripts to authorize your agent to access account-specific features.

Use Cases

This skill is perfect for automating routine grocery chores. You can use it to maintain a recurring "grocery list" file, where the agent reads your needs, searches for the best matches, adds them to your cart, and manages the checkout process. It is especially useful for busy households that rely on pickup services, as the agent can check availability at your preferred local branch before confirming the final order, ensuring you never travel to a store only to find items are out of stock.

Example Prompts

1. "Search for organic almond milk at my local QFC and add the first result to my cart."
2. "Find QFC locations near zip code 98101."
3. "Check if the items in my cart are available for pickup at LOC123 tomorrow at 10 AM and create the order if they are."

Tips & Limitations

Always ensure your state.json is properly secured, as it stores your API tokens. Remember that UPCs are the primary identifier for products, so when building custom automations, prioritize the use of the product ID field. The skill relies on UTC ISO 8601 formatting for pickup times, so verify your agent's timezone configuration. Note that while the cart is managed locally by the skill, inventory status is live; always perform an availability check before finalizing orders to avoid conflicts.