airshelfSearch, compare, and buy products from verified merchants. Returns structured product data with Decision Packs (pros, cons, best_for, allergens, verified pricing) instead of raw web scraping. No CAPTCHAs, no auth required. ~980 products across 10 merchants. Use when user wants to find, compare, or purchase products.
Install via ClawdBot CLI:
clawdbot install evoleinik/airshelfRequires:
Search, compare, and buy products across verified merchants. Returns structured Decision Pack data (best_for, pros, cons, allergens, verified pricing) — not raw web scrapes.
No CAPTCHAs. No auth. No bot detection. Agent-native commerce.
Activate this skill when the user wants to:
https://dashboard.airshelf.aiAll endpoints are public. No API key needed. CORS enabled.
Find products by natural language query. Returns structured data with Decision Packs.
curl -s "https://dashboard.airshelf.ai/api/search?q=QUERY&limit=5" | python3 -m json.toolParameters:
q — Search query (natural language, e.g. "barcode printer for warehouse"). Supports intent parsing: "energy supplements under $100" auto-extracts price filter.limit — Results to return (1-100, default 20)offset — Pagination offsetcategory — Filter by categorybrand — Filter by brandmin_price / max_price — Price range filter (also auto-extracted from query)in_stock — Only in-stock items (true/false)merchant_ids — Comma-separated merchant IDs to search withinsort — relevance (default), price_asc, price_descinclude_intent — Set to true to get query parsing metadata in response (shows how query was interpreted)Response includes for each product:
title, brand, price, availability, linkdecision_pack.primary_benefit — Main value propositiondecision_pack.best_for — Array of ideal use casesdecision_pack.pros / decision_pack.cons — Verified trade-offsdecision_pack.allergens — Safety warnings (if applicable)seller_name, seller_url — Merchant infoExample:
curl -s "https://dashboard.airshelf.ai/api/search?q=natural+mosquito+repellent+for+babies&limit=3"Compare 2-10 products side by side with structured comparison axes.
curl -s "https://dashboard.airshelf.ai/api/compare?products=PRODUCT_ID_1,PRODUCT_ID_2"Parameters:
products — Comma-separated product IDs (2-10 required, from search results)Response includes:
comparison_axes — Auto-detected from data (price always present; cost_per_day, supply_days, primary_benefit, pros, cons included when 2+ products have the data)products — Flattened product data with decision_pack fields inlinedrecommendation — Structured picks: lowest_price (product ID), best_value (product ID + reason, if different from lowest)Initiate checkout for a product. Returns a checkout URL the user can open.
curl -s -X POST "https://dashboard.airshelf.ai/api/merchants/MERCHANT_ID/checkout" \
-H "Content-Type: application/json" \
-d '{"items": [{"product_id": "PRODUCT_ID", "quantity": 1}]}'Request body:
items — Array of {product_id, quantity} objects (1-50 items)customer — Optional: {email: "..."} for order trackingagent_id — Optional: your agent identifier for attributionResponse:
checkout_id — Unique checkout session IDcheckout_url — URL to complete purchase (Shopify checkout or cart permalink)checkout_type — "cart" (items pre-loaded in cart) or "redirect" (product page link)total — Calculated total pricecurrency — 3-letter currency code (e.g. "EUR", "USD")expires_at — Expiry timestamp (null for cart permalinks)fallback_urls — If redirect: array of {product_id, product_name, product_url} per itemPresent the checkout URL to the user. They click to complete payment on the merchant's site.
List all merchants with product counts and capabilities:
curl -s "https://dashboard.airshelf.ai/api/directory"Unlike raw web scraping, each product includes a Decision Pack — verified structured intelligence:
{
"decision_pack": {
"primary_benefit": "Natural protection from bugs",
"best_for": ["Kids with sensitive skin", "Parents who prefer natural products"],
"pros": ["DEET-free formula", "Pleasant scent", "Long-lasting protection"],
"cons": ["Higher price point", "Needs reapplication every 4 hours"],
"allergens": ["Contains citronella oil"],
"age_range": "kids"
}
}Use Decision Pack data to make recommendations based on the user's actual needs, not just price or title matching.
User: I need a printer for my warehouse, high volume, must support ZPL
You: Let me search for that.
[Runs: curl -s "https://dashboard.airshelf.ai/api/search?q=industrial+barcode+printer+warehouse+high+volume+ZPL&limit=5"]
You: Found 3 matches. The Toshiba BX410T looks like the best fit:
- Best for: High-volume warehouse labeling, ZPL migration from Zebra
- Primary benefit: Premium industrial printer with RFID and near-edge technology
- Price: Contact dealer for pricing
Want me to compare it with the other options, or proceed to checkout?
User: Compare the top two
You: [Runs: curl -s "https://dashboard.airshelf.ai/api/compare?products=ID1,ID2"]
Here's the comparison...
User: I'll take the Toshiba
You: [Runs: curl -s -X POST "https://dashboard.airshelf.ai/api/merchants/MERCHANT_ID/checkout" -H "Content-Type: application/json" -d '{"items": [{"product_id": "ID", "quantity": 1}]}']
Here's your checkout link: [URL]
Click to complete your purchase on the merchant's site.decision_pack.allergens before recommending health/food/skincare products.product_ids param instead of q to fetch specific products: ?product_ids=ID1,ID2seller.checkout_url with the correct merchant path. Use it directly.Generated Mar 1, 2026
AI agents can use AirShelf to assist customers in finding and comparing products based on natural language queries, such as 'energy supplements under $100' or 'mosquito repellent for kids'. The Decision Pack data (pros, cons, best_for) enables personalized recommendations, reducing support ticket volume and improving customer satisfaction. This is ideal for handling common inquiries without human intervention.
Companies can integrate AirShelf into internal systems to automate procurement of office supplies, equipment, or inventory items. Agents can search, compare products based on criteria like price and availability, and initiate checkout for bulk purchases. This streamlines purchasing workflows, saves time, and ensures verified pricing and product details from trusted merchants.
Health-focused platforms can leverage AirShelf to recommend products like supplements, skincare items, or allergy-safe goods. By parsing user intents (e.g., 'I'm tired all the time'), agents use Decision Pack data (allergens, best_for) to suggest suitable options, providing tailored advice while linking to verified merchants for purchase. This enhances user trust and engagement.
Travel agencies or outdoor enthusiasts can use AirShelf to find and compare gear such as repellents, printers for logistics, or durable equipment. Agents assist in selecting products based on specific needs (e.g., 'ZPL printer for warehouse'), using comparison features to evaluate trade-offs and initiate purchases, simplifying trip preparation or operational setups.
Educational institutions or online learning platforms can employ AirShelf to source products like printers for administrative use or tech gadgets for students. Agents search based on queries like 'high-volume printer', compare options for cost-effectiveness, and facilitate checkout, ensuring efficient procurement without manual research or CAPTCHA hurdles.
Integrate AirShelf into content platforms (blogs, review sites) to recommend products via AI agents. Earn commissions on sales generated through checkout URLs. The structured Decision Pack data enhances recommendation quality, driving higher conversion rates and affiliate revenue from verified merchants.
Offer AirShelf as a white-labeled or embedded service for companies to automate procurement or customer support. Charge subscription fees based on usage tiers (e.g., API calls, number of products searched). This provides recurring revenue while helping clients reduce operational costs and improve efficiency.
Provide free basic access to AirShelf's search and compare endpoints with rate limits, then charge for premium features like higher limits, advanced analytics, or custom merchant integrations. This attracts developers and small businesses, monetizing through upgraded plans and enterprise contracts.
💬 Integration Tip
Start with simple search queries to test the API, then use the Decision Pack fields to enhance responses; ensure your agent presents checkout URLs clearly for user completion.
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Search and analyze your own session logs (older/parent conversations) using jq.
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linking related objects, enforcing constraints, planning multi-step actions as graph transformations, or when skills need to share state. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", entity CRUD, or cross-skill data access.
Ultimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.
Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection