AirShelf for Openclaw

An AI-native commerce platform that provides structured product data and seamless checkout for agent-driven shopping.

evoleinik
v1.3.0
Feb 10, 2026
4
2.3k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install airshelf

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install airshelf 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 AirShelf?

AirShelf is a specialized commerce platform designed specifically for agentic workflows. It allows AI agents to search, compare, and purchase products across a network of verified merchants without the typical hurdles of web scraping, such as CAPTCHAs or bot detection. By providing structured data instead of raw HTML, it enables agents to understand the context of a product through verified metadata.

Built to be developer-friendly, this skill integrates with Openclaw Skills to provide a high-fidelity shopping experience. It features an API that returns Decision Packs—curated intelligence that includes pros, cons, and specific use-case recommendations. This ensures that agents can make informed suggestions based on user needs rather than just keyword matches, all while maintaining a secure checkout process where users finalize payments directly on merchant sites.

AirShelf Use Cases

  • Finding specific products using natural language queries like "mosquito repellent for kids."
  • Comparing multiple products side-by-side using structured comparison axes provided by the API.
  • Generating product recommendations based on specific user problems or symptoms.
  • Looking up verified product details, real-time pricing, and allergen information.
  • Initiating secure checkout redirects for user purchase completion on verified merchant platforms.

How AirShelf Works

  1. The agent receives a user request to find, compare, or buy a product.
  2. The agent sends a natural language query to the search endpoint, which parses intent to extract price filters, brands, and categories.
  3. AirShelf returns structured results including Decision Pack data (pros, cons, and best-for scenarios).
  4. If the user requires a comparison, the agent calls the compare endpoint to receive structured axes and value-based recommendations.
  5. To complete a purchase, the agent sends a POST request to the checkout endpoint to generate a unique checkout URL.
  6. The user is presented with the link to securely complete the transaction on the merchant's own website.

AirShelf Setup

This skill requires no API keys or authentication. Ensure your environment has curl installed for CLI interactions.

# Test the search functionality
curl -s "https://dashboard.airshelf.ai/api/search?q=QUERY&limit=5"

# List available merchants and capabilities
curl -s "https://dashboard.airshelf.ai/api/directory"

Integrate the base URL https://dashboard.airshelf.ai into your Openclaw Skills configuration to allow your agent to access the commerce endpoints.

AirShelf Data Schema & Taxonomy

AirShelf organizes its commerce data into structured objects known as Decision Packs to help agents make better recommendations.

Attribute Type Description
primary_benefit String The main value proposition of the product.
best_for Array Specific use cases or user personas the product fits.
pros / cons Array Verified trade-offs and product quality indicators.
allergens Array Safety warnings for food, health, or skincare items.
checkout_url String A direct link to the merchant's cart or product page.

AirShelf Advanced Features

  • Natural Language Intent Parsing: Automatically extracts filters like max price and stock status from conversational queries.
  • Structured Comparison Axes: Generates automated comparison points (e.g., cost per day) when evaluating multiple items.
  • Decision Pack Intelligence: Provides verified pros and cons for every product to prevent hallucination during recommendations.
  • Agent Attribution: Supports an agent_id parameter to track commerce activity generated by your specific agent.
  • Zero-Auth Integration: Publicly accessible endpoints with CORS enabled for seamless integration across various platforms using Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*