A professional integration skill for building shoppable Instacart recipe pages, managing shopping lists, and performing retailer lookups via MCP and REST APIs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install instacart
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install instacart using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Instacart?
The Instacart skill for Openclaw Skills provides a robust framework for developers to integrate grocery commerce directly into AI-driven workflows. By leveraging the Instacart Developer Platform, this skill allows for the creation of shoppable recipe pages and shopping lists with precise control over request payloads, retailer context, and environment management. It is designed to bridge the gap between digital planning and physical fulfillment, ensuring a seamless user journey from discovery to checkout.
Built with modern standards in mind, this skill supports both the Model Context Protocol (MCP) for agent-native interactions and standard REST APIs for custom application logic. As a key component of the Openclaw Skills ecosystem, it includes comprehensive playbooks for authentication, error handling, and launch-readiness, making it an essential tool for developers building the next generation of commerce-enabled AI agents.
Instacart Use Cases
- Generating shoppable recipe pages from meal planning agents.
- Automating the creation of personalized Instacart shopping lists.
- Performing nearby retailer lookups using geographic data like postal codes.
- Implementing MCP-based agent handoffs for grocery-specific execution.
- Conducting launch-readiness checks and API troubleshooting for Instacart integrations.
- Managing environment-specific authentication and secure API key handling.
How Instacart Works
- The skill initializes by validating the required INSTACART_API_KEY and establishing a local directory at ~/instacart/ for persistent memory.
- It analyzes the user request to select the optimal integration surface, such as Developer Platform REST for full control or MCP for agent-native tools.
- Input data, including ingredients and items, are normalized into generic names while maintaining brand and health preferences in specific filters.
- Geographical context is validated using postal codes and country codes to identify relevant organization-level retailer keys.
- The skill executes requests to Instacart endpoints, generating a products_link_url which is then cached locally to ensure idempotency.
- Throughout the lifecycle, the skill tracks production approval status and messaging constraints to ensure compliance with Instacart guidelines.
Instacart Setup
To integrate this entry from the Openclaw Skills library, follow these steps to configure your environment.
# Set your Instacart API key as an environment variable
export INSTACART_API_KEY='your_api_key_here'
# Ensure jq is installed for running smoke tests and processing JSON
# For macOS:
brew install jq
# For Linux:
sudo apt-get install jq
# Install the skill via the clawhub CLI
clawhub install instacart
On first use, refer to the setup.md file within the skill directory for specific integration guidelines and auth playbooks.
Instacart Data Schema & Taxonomy
The Instacart skill organizes its operational data within the ~/instacart/ directory to maintain context and improve efficiency. This structure is a standard for professional Openclaw Skills.
| File | Description |
|---|---|
memory.md |
Operating context, activation rules, and approved surfaces. |
url-cache.md |
Payload hashes and generated products_link URLs to prevent redundant requests. |
retailer-notes.md |
Preferred retailers, geo-defaults (country/postal code), and known-good keys. |
launch-notes.md |
Production approval state and specific messaging constraints. |
incidents.md |
Detailed logs of failed requests, root causes, and applied fixes. |
Instacart Advanced Features
- Intelligent surface selection between Developer Platform MCP, REST, and Instacart Connect based on task complexity.
- Client-side idempotency engine that hashes payloads to reuse generated URLs and reduce API churn.
- Heuristic ingredient matching that separates brand and health filters from core product names for higher accuracy.
- Geographic validation logic that maps postal codes to organization-level retailer keys.
- Multi-environment support for seamless switching between development sandboxes and production endpoints.
- Automated launch-readiness audits to ensure integrations meet Instacart's production requirements.
SKILL.md
Loading
Related Openclaw Skills
Inspiration
A comprehensive reference engine for finding design patterns, landing page layouts, and AI art inspiration.
Infrastructure
A professional tool for designing cloud architecture, generating provisioning commands, and implementing scalable infrastructure patterns.
InfluxDB Time-Series Data Management
An AI agent skill for architecting, managing, and querying high-performance time-series databases using InfluxDB.
Influencer
A comprehensive toolset for creating and scaling AI-generated virtual influencers with consistent characters and multi-platform content workflows.
Interior Design
A specialized agent skill for managing interior design projects through space verification, localized supplier matching, and ROI-driven staging.
Internet
A comprehensive tool for managing internet connectivity, comparing ISP providers, diagnosing speed issues, and optimizing network performance.
Featured*
