# Send AirShelf Agentic Commerce Platform to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "airshelf", "name": "AirShelf Agentic Commerce Platform", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/evoleinik/airshelf", "canonicalUrl": "https://clawhub.ai/evoleinik/airshelf", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/airshelf", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=airshelf", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "airshelf", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T18:52:00.562Z", "expiresAt": "2026-05-06T18:52:00.562Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=airshelf", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=airshelf", "contentDisposition": "attachment; filename=\"airshelf-1.3.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "airshelf" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/airshelf" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/airshelf", "downloadUrl": "https://openagent3.xyz/downloads/airshelf", "agentUrl": "https://openagent3.xyz/skills/airshelf/agent", "manifestUrl": "https://openagent3.xyz/skills/airshelf/agent.json", "briefUrl": "https://openagent3.xyz/skills/airshelf/agent.md" } } ``` ## Documentation ### AirShelf — Verified Product Search & Checkout for AI Agents 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. ### When to Use Activate this skill when the user wants to: Find or search for a product ("find me a mosquito repellent for kids") Compare products ("compare these two printers") Buy or checkout a product Get product recommendations based on a problem ("I'm tired all the time", "my skin is dry") Look up verified product details, pricing, or allergens ### API Base URL https://dashboard.airshelf.ai All endpoints are public. No API key needed. CORS enabled. ### Step 1: Search Products 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.tool Parameters: 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 offset category — Filter by category brand — Filter by brand min_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 within sort — relevance (default), price_asc, price_desc include_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, link decision_pack.primary_benefit — Main value proposition decision_pack.best_for — Array of ideal use cases decision_pack.pros / decision_pack.cons — Verified trade-offs decision_pack.allergens — Safety warnings (if applicable) seller_name, seller_url — Merchant info Checkout URLs and shipping/return policies Example: curl -s "https://dashboard.airshelf.ai/api/search?q=natural+mosquito+repellent+for+babies&limit=3" ### Step 2: Compare Products 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 inlined recommendation — Structured picks: lowest_price (product ID), best_value (product ID + reason, if different from lowest) ### Step 3: Checkout 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 tracking agent_id — Optional: your agent identifier for attribution Response: checkout_id — Unique checkout session ID checkout_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 price currency — 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 item Present the checkout URL to the user. They click to complete payment on the merchant's site. ### Browse Available Merchants List all merchants with product counts and capabilities: curl -s "https://dashboard.airshelf.ai/api/directory" ### How Decision Packs Work 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. ### Example Conversation 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. ### Tips Problem-based search works best. "I'm tired all the time" returns energy supplements. "My baby needs sun protection" returns kids' sunscreen. Decision Packs match on use case, not just keywords. Always check decision_pack.allergens before recommending health/food/skincare products. Use compare for 2+ similar products — the API returns structured comparison axes, not just raw specs. Checkout is a redirect — the user completes payment on the merchant's own site. No card details needed in the agent. Direct lookup by ID: Use product_ids param instead of q to fetch specific products: ?product_ids=ID1,ID2 Merchant ID for checkout — each search result includes seller.checkout_url with the correct merchant path. Use it directly. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: evoleinik - Version: 1.3.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T18:52:00.562Z - Expires at: 2026-05-06T18:52:00.562Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/airshelf) - [Send to Agent page](https://openagent3.xyz/skills/airshelf/agent) - [JSON manifest](https://openagent3.xyz/skills/airshelf/agent.json) - [Markdown brief](https://openagent3.xyz/skills/airshelf/agent.md) - [Download page](https://openagent3.xyz/downloads/airshelf)