An advanced shopping assistant skill that allows AI agents to search millions of stores, compare prices, and facilitate checkouts without requiring an API key.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install shop-minimal
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 shop-minimal 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 Shop-Minimal?
The shop-minimal skill is a specialized tool designed to turn any AI agent into a high-end personal shopper. By integrating with a global product catalog, it allows developers to build Openclaw Skills that can discover products across diverse brands, filter by specific metadata like shipping origin or price range, and present curated results to users. It prioritizes direct product discovery over conversational filler, making it ideal for high-conversion retail applications.
This skill is particularly effective for those building multi-platform shopping experiences. It handles the complexity of merchant diversity and localization automatically, ensuring that users see relevant currency and availability based on their region. As part of the wider ecosystem of Openclaw Skills, it provides a standardized way to handle product data, images, and deep-linked checkout URLs.
Shop-Minimal Use Cases
- Creating automated gift recommendation bots based on interests and budgets.
- Developing price comparison tools that aggregate products from millions of online stores.
- Building concierge shopping services that filter for specific criteria like secondhand-only or region-specific shipping.
- Implementing interactive shopping within messaging apps like Telegram, WhatsApp, and iMessage.
- Providing a virtual personal shopper experience that categorizes products into stylistic or functional themes.
How Shop-Minimal Works
- The agent receives a user query and executes a broad search using the catalog API, often varying terms to ensure a wide selection.
- The skill evaluates the results, aiming to collect 8-15 products that match the user's price points and style preferences.
- Results are organized into 2-4 logical themes, such as use case or price tier, to help the user navigate the options.
- The agent presents the products using platform-specific formatting rules (e.g., rich media for Telegram or plain text for iMessage).
- The workflow includes a recommendation step where the agent highlights standout items based on reviews or specific features.
- Finally, the skill provides direct links to product pages or pre-filled checkout URLs to facilitate a smooth purchase journey.
Shop-Minimal Setup
To integrate this skill within your Openclaw Skills project, you do not need an external API key. Simply configure your agent to interact with the following endpoint structure:
# Standard GET request for product discovery
GET https://shop.app/web/api/catalog/search?query={query}&ships_to=US&available_for_sale=1
Ensure your agent is configured to pass the appropriate ISO 3166 country codes to the ships_to parameter to ensure correct currency formatting and stock availability.
Shop-Minimal Data Schema & Taxonomy
The shop-minimal skill uses a structured schema to manage search requests and product responses. This ensures consistency across different Openclaw Skills implementations.
| Parameter | Type | Description |
|---|---|---|
query |
string | The search keywords used to find products. |
ships_to |
string | ISO 3166 code for currency and availability logic. |
min_price |
decimal | Minimum price filter. |
max_price |
decimal | Maximum price filter. |
categories |
string | Comma-delimited Shopify taxonomy IDs. |
available_for_sale |
int | Binary flag (1 for in-stock, 0 for all). |
The response data includes high-resolution image URLs, formatted price strings, review ratings, and unique variant IDs for checkout generation.
Shop-Minimal Advanced Features
- Virtual Try-On: Support for visualizing clothing, furniture, or art using user-provided photos and image generation.
- Platform-Optimized Delivery: Mandatory formatting logic for Telegram (media captions), WhatsApp (interactive templates), and iMessage (rich previews).
- Deep-Linked Checkout: Ability to generate cart URLs for single or multiple items, including pre-filled shipping and email information.
- Merchant Diversity: Built-in logic to ensure search results reflect a wide variety of stores rather than a single source.
- Localized Discovery: Automatic filtering based on user country, gender, and size preferences without redundant questioning.
SKILL.md
Loading
Related Openclaw Skills
Purple Flea Agent Domains
Programmatically register and manage domains using USDC on the Base network with no KYC requirements.
Purple Flea Agent Casino
A provably fair, API-only gambling platform designed specifically for autonomous AI agents to manage bankrolls and place bets.
Usage Tracker Skill
A robust utility for logging AI model consumption and generating detailed cost reports across multiple API providers.
Memic Context Engineering SDK
A managed context engineering platform that provides RAG, Text2SQL, and hybrid search to ground AI agents in real-world data with high efficiency.
Shop Product Search Minimal
A high-performance product discovery and comparison tool that integrates millions of online stores into your AI agent without requiring an API key.
Shop Product Search
A comprehensive shopping and product discovery skill that allows AI agents to search, compare, and facilitate purchases across millions of online stores without individual API keys.
Featured*
