{ "schemaVersion": "1.0", "item": { "slug": "buy-amazon", "name": "Buy from Amazon — Search, Cart & Order for AI Agents", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/lucasgeeksinthewood/buy-amazon", "canonicalUrl": "https://clawhub.ai/lucasgeeksinthewood/buy-amazon", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/buy-amazon", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=buy-amazon", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/buy-amazon" }, "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." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/buy-amazon", "agentPageUrl": "https://openagent3.xyz/skills/buy-amazon/agent", "manifestUrl": "https://openagent3.xyz/skills/buy-amazon/agent.json", "briefUrl": "https://openagent3.xyz/skills/buy-amazon/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "When to Use This Skill", "body": "Activate this skill when your user wants to:\n\nBuy something — \"buy me headphones,\" \"order a birthday gift,\" \"I need a new keyboard\"\nShop on Amazon — \"find me something on Amazon,\" \"what's a good laptop stand?\"\nCompare products — \"what are the best wireless earbuds under $50?\"\nSend a gift — \"order a gift for my mom,\" \"buy something nice for under $30\"\nReorder or track — \"where's my order?\" \"check on order AC-047\"\n\nIf the user mentions buying, ordering, shopping, gifting, or purchasing — this is your skill." }, { "title": "How It Works (The Short Version)", "body": "Search Amazon → add products to cart → checkout with a shipping address and email → request payment link → done. The user gets an email with a payment link. They pay on their own, we ship. No money is charged through this API.\n\nAll API calls go to https://buystuff.ai — one endpoint, no setup, no API keys needed. Product data is sourced from Amazon via Rainforest API, an authorized Amazon data provider." }, { "title": "Sessions", "body": "Every API response includes an X-Session-ID header and a sessionId field in the JSON body. Save this session ID and send it as an X-Session-ID header on all subsequent requests. This lets you:\n\nAdd multiple products to the same cart\nView your active cart without remembering the cart ID\nMaintain continuity across the entire shopping flow\n\n# First request — get a session ID from the response\ncurl \"https://buystuff.ai/search?q=earbuds\"\n# Response header: X-Session-ID: ses_abc123...\n# Response body includes: \"sessionId\": \"ses_abc123...\"\n\n# All subsequent requests — send it back\ncurl -H \"X-Session-ID: ses_abc123...\" \"https://buystuff.ai/search?q=yoga+mat\"\ncurl -H \"X-Session-ID: ses_abc123...\" -X POST https://buystuff.ai/cart -d '{\"asin\":\"B09F5RKG8P\"}'\n\nIf you don't send a session ID, a new one is auto-created on each request. Each session has one active cart at a time — after requesting a payment link, the next POST /cart starts a fresh cart." }, { "title": "Payment Model", "body": "No payment info is collected through this API. Zero credit cards, zero tokens, zero wallets.\n\nWhen the user is ready, the agent requests a payment link. buystuff.ai emails the user a secure payment link. They click, pay on buystuff.ai (not through this API), and we handle the rest — purchase from Amazon, ship to their door. No payment is ever processed through this skill.\n\nService fee: 10% of (subtotal + shipping)\nPayment: User gets an email with a payment link — not through this API\nFulfillment: Once paid, we buy from Amazon and ship within 24-48 hours\nRefunds: support@buystuff.ai\n\nAlways show the full price breakdown before requesting the payment link." }, { "title": "Data Handling", "body": "All API calls go to https://buystuff.ai. Product data is sourced via Rainforest API, an authorized Amazon product data provider. Shipping details are shared with Amazon only for order fulfillment. No data is sold or shared with other third parties.\n\nDataWhenPurposeSearch queriesStep 1Find products (no PII)Shipping addressStep 4Deliver the orderEmailStep 4Send payment link + updatesAgent ID (optional)Step 4Track your agent's orders" }, { "title": "Safety: No Money Charged Through This API", "body": "This skill cannot charge money or complete purchases. It only generates a payment link email. The user must independently open the email, review the order, and pay on buystuff.ai — completely outside this API.\n\nYou MUST get explicit user approval before requesting the payment link (Step 5). Show the price breakdown, wait for \"yes.\" Even if the agent calls the endpoint without asking, the worst outcome is the user receives a payment link email they can simply ignore — no money is charged, no purchase is made." }, { "title": "Step 1: Search Products", "body": "/buy-amazon-search\n\ncurl \"https://buystuff.ai/search?q=wireless+earbuds&sort_by=price_low_to_high&number_of_results=10\"\n\nParameterTypeRequiredDescriptionqstringYesSearch querysort_bystringNoprice_low_to_high, price_high_to_low, average_review, most_recentnumber_of_resultsintegerNoLimit results (default 20)exclude_sponsoredbooleanNoRemove sponsored resultspageintegerNoResults page number\n\nResponse includes results[] with asin, title, price, rating, ratingsTotal, isPrime, isBestseller, isDeal.\n\nAgent tips:\n\nShow 3-5 results so the user can compare — don't just pick the first one\nMention ⭐ ratings and review counts — users trust social proof\nHighlight Prime items (free shipping) and deals\nIf no results found, suggest broadening the search terms or trying different keywords\nIf the user has a budget, use sort_by=price_low_to_high and mention which ones fit" }, { "title": "Step 2: Check Product Details", "body": "/buy-amazon-details\n\ncurl \"https://buystuff.ai/product/B09F5RKG8P\"\n\nResponse includes full product info: title, brand, price, buyboxWinner (shipping cost, availability, Prime status), rating, ratingBreakdown, specifications, variants.\n\nAgent tips:\n\nCheck buyboxWinner.availability — if \"Out of Stock,\" tell the user and suggest alternatives\nIf buyboxWinner.shipping.raw is \"FREE\", highlight it — users love free shipping\nShow the ratingBreakdown percentages so users can see if ratings are legit (watch for lots of 1-stars)\nIf variants exist (colors, sizes), ask the user which one before adding to cart\nMention key specifications that match what the user asked about" }, { "title": "Step 3: Add to Cart", "body": "/buy-amazon-cart\n\ncurl -X POST https://buystuff.ai/cart \\\n -H \"Content-Type: application/json\" \\\n -H \"X-Session-ID: ses_abc123...\" \\\n -d '{\"asin\": \"B09F5RKG8P\", \"quantity\": 1}'\n\nFieldTypeRequiredDescriptionasinstringYesAmazon product IDquantityintegerNoDefault: 1\n\nSave the cartId from the response — you need it for checkout.\n\nMulti-item carts: Call POST /cart again with the same session to add more products to the same cart. If you add the same ASIN twice, the quantity is combined.\n\nView the current cart (without needing the cartId):\n\ncurl -H \"X-Session-ID: ses_abc123...\" https://buystuff.ai/cart\n\nUpdate item quantity:\n\ncurl -X PATCH https://buystuff.ai/cart/cart_abc123/items/B09F5RKG8P \\\n -H \"Content-Type: application/json\" \\\n -d '{\"quantity\": 3}'\n\nRemove an item:\n\ncurl -X DELETE https://buystuff.ai/cart/cart_abc123/items/B09F5RKG8P\n\nIf adding fails: The ASIN might be invalid or the product unavailable. Go back to search and help the user pick another option." }, { "title": "Step 4: Checkout", "body": "/buy-amazon-checkout\n\ncurl -X POST https://buystuff.ai/cart/cart_abc123/checkout \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"shipping\": {\n \"name\": \"John Doe\",\n \"line1\": \"123 Main St\",\n \"line2\": \"Apt 4B\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94105\",\n \"country\": \"US\"\n },\n \"email\": \"john@example.com\",\n \"agentId\": \"your-agent-id\"\n }'\n\nFieldTypeRequiredDescriptionshipping.namestringYesRecipient full nameshipping.line1stringYesStreet addressshipping.line2stringNoApt, suite, unitshipping.citystringYesCityshipping.statestringYes2-letter state codeshipping.zipstringYesZIP codeshipping.countrystringNoDefault: \"US\"emailstringYesFor payment link + order updatesagentIdstringNoYour agent ID\n\nResponse returns summary with subtotal, shipping, serviceFee, total.\n\nAgent tips:\n\nIf the user hasn't given a shipping address, ask for it naturally: \"Where should I ship it?\"\nIf no email provided, ask: \"What email should we send the payment link to?\"\nAlways present the full breakdown before requesting the payment link:\n\nSubtotal, Shipping (often FREE with Prime), Service fee (10%), Total\n\n\nIf the user seems surprised by the price, remind them of the 10% service fee and offer to find alternatives" }, { "title": "Step 5: Request Payment Link", "body": "/buy-amazon-confirm\n\nOnly call this after the user says yes. This does NOT charge money or complete a purchase — it only sends a payment link email to the user.\n\ncurl -X POST https://buystuff.ai/cart/cart_abc123/confirm\n\nResponse returns orderId, status, total, and a confirmation message. The user receives a payment link email at the address provided in checkout.\n\nTell the user: \"Check your email for the payment link — once you pay, we'll ship it within 24-48 hours!\"" }, { "title": "Step 6: Track Order", "body": "/buy-amazon-status\n\ncurl \"https://buystuff.ai/order/AC-MLLZVLMB-001\"\n\nStatuses: PENDING_FULFILLMENT → PROCESSING → SHIPPED → DELIVERED\n\nWhen status is SHIPPED, there will be a trackingNumber — share it with the user." }, { "title": "Example: Buying Earbuds", "body": "User: Find me wireless earbuds under $50\n\nAgent: Here are the top wireless earbuds under $50 on Amazon:\n\n1. 🏆 Sony WF-C500 — $38.00 ⭐4.5 (12,420 reviews) ✓Prime\n2. JBL Tune 130NC — $49.95 ⭐4.3 (8,200 reviews) ✓Prime\n3. Soundcore A20i — $29.99 ⭐4.4 (45,000 reviews) ✓Prime\n\nAll three have Prime (free shipping). The Sony has the best rating, and the Soundcore has the most reviews. Want details on any of these?\n\nUser: Get the Sony ones. Ship to John Doe, 123 Main St, San Francisco CA 94105. Email is john@example.com\n\nAgent: Here's your order:\n\n Sony WF-C500 Wireless Earbuds $38.00\n Shipping (Prime) FREE\n Service fee (10%) $3.80\n ─────────────────────────────────\n Total $41.80\n\nShip to: John Doe, 123 Main St, San Francisco, CA 94105\n\nReady to confirm?\n\nUser: Yes!\n\nAgent: Done! Order #AC-MLLZVLMB-001 is confirmed. 🎉\n\nWe've sent a payment link to john@example.com — just click, pay, and we'll ship within 24-48 hours." }, { "title": "Example: Birthday Gift", "body": "User: I need a birthday gift for my sister, she's into yoga. Budget is $30.\n\nAgent: Here are some great yoga gifts under $30 on Amazon:\n\n1. Manduka eKO Yoga Mat Towel — $24.99 ⭐4.6 (3,200 reviews) ✓Prime\n2. Yoga Wheel Set (3-pack) — $27.95 ⭐4.5 (8,100 reviews) ✓Prime\n3. Essential Oils Gift Set — $19.99 ⭐4.4 (22,000 reviews) ✓Prime 🔥Deal\n\nThe essential oils set is on sale and fits your budget with room to spare. The yoga wheel set is really popular. Want to see details on any?\n\nUser: The yoga wheel set! Ship to Sarah Chen, 456 Oak Ave, Austin TX 78701. My email is mike@example.com\n\nAgent: Perfect gift choice! Here's the summary:\n\n Yoga Wheel Set (3-pack) $27.95\n Shipping (Prime) FREE\n Service fee (10%) $2.80\n ─────────────────────────────────\n Total $30.75\n\nShip to: Sarah Chen, 456 Oak Ave, Austin, TX 78701\n\nConfirm?\n\nUser: Do it\n\nAgent: Order #AC-MLLZVLMB-002 confirmed! 🎁\n\nPayment link sent to mike@example.com. Pay and we'll have it shipped to Sarah within 24-48 hours. Happy birthday to your sister!" }, { "title": "Example: Multi-Item Order", "body": "User: I need a wireless mouse and a mousepad for my new desk setup.\n\nAgent: Let me search for both! Here's what I found:\n\nWireless mice:\n1. Logitech M185 — $12.99 ⭐4.5 (75,000 reviews) ✓Prime\n2. Logitech Pebble 2 — $24.99 ⭐4.6 (15,000 reviews) ✓Prime\n\nMousepads:\n1. SteelSeries QcK — $9.49 ⭐4.7 (90,000 reviews) ✓Prime\n2. Corsair MM350 — $14.99 ⭐4.6 (12,000 reviews) ✓Prime\n\nUser: Get the Logitech M185 and the SteelSeries mousepad.\n\nAgent: Added both to your cart:\n\n Logitech M185 Wireless Mouse $12.99\n SteelSeries QcK Mousepad $9.49\n Shipping $5.99\n Service fee (10%) $2.85\n ─────────────────────────────────\n Total $31.32\n\nWhere should I ship them? And what email for the payment link?\n\nUser: Ship to Alex Kim, 789 Pine St, Seattle WA 98101. Email alex@example.com\n\nAgent: Here's the final summary:\n\n 2 items → $31.32 total\n Ship to: Alex Kim, 789 Pine St, Seattle, WA 98101\n\nConfirm?\n\nUser: Yes\n\nAgent: Order #AC-MLLZVLMB-003 confirmed! 🎉\n\nPayment link sent to alex@example.com. Once you pay, both items ship within 24-48 hours." }, { "title": "Handling Common Situations", "body": "User doesn't give a budget: Search normally and show a range of prices. Ask \"Do you have a price range in mind?\" if results vary widely.\nProduct out of stock: Say \"That one's currently unavailable\" and suggest similar alternatives from the search results.\nUser wants to compare two products: Pull details on both and present a quick comparison (price, rating, key specs).\nUser changes their mind after checkout: They can simply not pay the email link. The order expires if unpaid.\nUser asks about returns: Direct them to support@buystuff.ai.\nSearch returns too many results: Narrow with sort_by, exclude_sponsored, or a more specific query." }, { "title": "Quick Reference", "body": "GET https://buystuff.ai/search?q={query} Search products\nGET https://buystuff.ai/product/{asin} Product details\nGET https://buystuff.ai/cart Get session's active cart (by session)\nGET https://buystuff.ai/cart/{cartId} Get cart by ID\nPOST https://buystuff.ai/cart Add product to cart (or create cart)\nPATCH https://buystuff.ai/cart/{cartId}/items/{asin} Update item quantity\nDELETE https://buystuff.ai/cart/{cartId}/items/{asin} Remove item from cart\nPOST https://buystuff.ai/cart/{cartId}/checkout Checkout\nPOST https://buystuff.ai/cart/{cartId}/confirm Request payment link\nGET https://buystuff.ai/order/{orderId} Track order\n\nHeader: X-Session-ID — send on all requests to maintain session" } ], "body": "When to Use This Skill\n\nActivate this skill when your user wants to:\n\nBuy something — \"buy me headphones,\" \"order a birthday gift,\" \"I need a new keyboard\"\nShop on Amazon — \"find me something on Amazon,\" \"what's a good laptop stand?\"\nCompare products — \"what are the best wireless earbuds under $50?\"\nSend a gift — \"order a gift for my mom,\" \"buy something nice for under $30\"\nReorder or track — \"where's my order?\" \"check on order AC-047\"\n\nIf the user mentions buying, ordering, shopping, gifting, or purchasing — this is your skill.\n\nHow It Works (The Short Version)\n\nSearch Amazon → add products to cart → checkout with a shipping address and email → request payment link → done. The user gets an email with a payment link. They pay on their own, we ship. No money is charged through this API.\n\nAll API calls go to https://buystuff.ai — one endpoint, no setup, no API keys needed. Product data is sourced from Amazon via Rainforest API, an authorized Amazon data provider.\n\nSessions\n\nEvery API response includes an X-Session-ID header and a sessionId field in the JSON body. Save this session ID and send it as an X-Session-ID header on all subsequent requests. This lets you:\n\nAdd multiple products to the same cart\nView your active cart without remembering the cart ID\nMaintain continuity across the entire shopping flow\n# First request — get a session ID from the response\ncurl \"https://buystuff.ai/search?q=earbuds\"\n# Response header: X-Session-ID: ses_abc123...\n# Response body includes: \"sessionId\": \"ses_abc123...\"\n\n# All subsequent requests — send it back\ncurl -H \"X-Session-ID: ses_abc123...\" \"https://buystuff.ai/search?q=yoga+mat\"\ncurl -H \"X-Session-ID: ses_abc123...\" -X POST https://buystuff.ai/cart -d '{\"asin\":\"B09F5RKG8P\"}'\n\n\nIf you don't send a session ID, a new one is auto-created on each request. Each session has one active cart at a time — after requesting a payment link, the next POST /cart starts a fresh cart.\n\nPayment Model\n\nNo payment info is collected through this API. Zero credit cards, zero tokens, zero wallets.\n\nWhen the user is ready, the agent requests a payment link. buystuff.ai emails the user a secure payment link. They click, pay on buystuff.ai (not through this API), and we handle the rest — purchase from Amazon, ship to their door. No payment is ever processed through this skill.\n\nService fee: 10% of (subtotal + shipping)\nPayment: User gets an email with a payment link — not through this API\nFulfillment: Once paid, we buy from Amazon and ship within 24-48 hours\nRefunds: support@buystuff.ai\n\nAlways show the full price breakdown before requesting the payment link.\n\nData Handling\n\nAll API calls go to https://buystuff.ai. Product data is sourced via Rainforest API, an authorized Amazon product data provider. Shipping details are shared with Amazon only for order fulfillment. No data is sold or shared with other third parties.\n\nData\tWhen\tPurpose\nSearch queries\tStep 1\tFind products (no PII)\nShipping address\tStep 4\tDeliver the order\nEmail\tStep 4\tSend payment link + updates\nAgent ID (optional)\tStep 4\tTrack your agent's orders\nSafety: No Money Charged Through This API\n\nThis skill cannot charge money or complete purchases. It only generates a payment link email. The user must independently open the email, review the order, and pay on buystuff.ai — completely outside this API.\n\nYou MUST get explicit user approval before requesting the payment link (Step 5). Show the price breakdown, wait for \"yes.\" Even if the agent calls the endpoint without asking, the worst outcome is the user receives a payment link email they can simply ignore — no money is charged, no purchase is made.\n\nStep 1: Search Products\n\n/buy-amazon-search\n\ncurl \"https://buystuff.ai/search?q=wireless+earbuds&sort_by=price_low_to_high&number_of_results=10\"\n\nParameter\tType\tRequired\tDescription\nq\tstring\tYes\tSearch query\nsort_by\tstring\tNo\tprice_low_to_high, price_high_to_low, average_review, most_recent\nnumber_of_results\tinteger\tNo\tLimit results (default 20)\nexclude_sponsored\tboolean\tNo\tRemove sponsored results\npage\tinteger\tNo\tResults page number\n\nResponse includes results[] with asin, title, price, rating, ratingsTotal, isPrime, isBestseller, isDeal.\n\nAgent tips:\n\nShow 3-5 results so the user can compare — don't just pick the first one\nMention ⭐ ratings and review counts — users trust social proof\nHighlight Prime items (free shipping) and deals\nIf no results found, suggest broadening the search terms or trying different keywords\nIf the user has a budget, use sort_by=price_low_to_high and mention which ones fit\nStep 2: Check Product Details\n\n/buy-amazon-details\n\ncurl \"https://buystuff.ai/product/B09F5RKG8P\"\n\n\nResponse includes full product info: title, brand, price, buyboxWinner (shipping cost, availability, Prime status), rating, ratingBreakdown, specifications, variants.\n\nAgent tips:\n\nCheck buyboxWinner.availability — if \"Out of Stock,\" tell the user and suggest alternatives\nIf buyboxWinner.shipping.raw is \"FREE\", highlight it — users love free shipping\nShow the ratingBreakdown percentages so users can see if ratings are legit (watch for lots of 1-stars)\nIf variants exist (colors, sizes), ask the user which one before adding to cart\nMention key specifications that match what the user asked about\nStep 3: Add to Cart\n\n/buy-amazon-cart\n\ncurl -X POST https://buystuff.ai/cart \\\n -H \"Content-Type: application/json\" \\\n -H \"X-Session-ID: ses_abc123...\" \\\n -d '{\"asin\": \"B09F5RKG8P\", \"quantity\": 1}'\n\nField\tType\tRequired\tDescription\nasin\tstring\tYes\tAmazon product ID\nquantity\tinteger\tNo\tDefault: 1\n\nSave the cartId from the response — you need it for checkout.\n\nMulti-item carts: Call POST /cart again with the same session to add more products to the same cart. If you add the same ASIN twice, the quantity is combined.\n\nView the current cart (without needing the cartId):\n\ncurl -H \"X-Session-ID: ses_abc123...\" https://buystuff.ai/cart\n\n\nUpdate item quantity:\n\ncurl -X PATCH https://buystuff.ai/cart/cart_abc123/items/B09F5RKG8P \\\n -H \"Content-Type: application/json\" \\\n -d '{\"quantity\": 3}'\n\n\nRemove an item:\n\ncurl -X DELETE https://buystuff.ai/cart/cart_abc123/items/B09F5RKG8P\n\n\nIf adding fails: The ASIN might be invalid or the product unavailable. Go back to search and help the user pick another option.\n\nStep 4: Checkout\n\n/buy-amazon-checkout\n\ncurl -X POST https://buystuff.ai/cart/cart_abc123/checkout \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"shipping\": {\n \"name\": \"John Doe\",\n \"line1\": \"123 Main St\",\n \"line2\": \"Apt 4B\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94105\",\n \"country\": \"US\"\n },\n \"email\": \"john@example.com\",\n \"agentId\": \"your-agent-id\"\n }'\n\nField\tType\tRequired\tDescription\nshipping.name\tstring\tYes\tRecipient full name\nshipping.line1\tstring\tYes\tStreet address\nshipping.line2\tstring\tNo\tApt, suite, unit\nshipping.city\tstring\tYes\tCity\nshipping.state\tstring\tYes\t2-letter state code\nshipping.zip\tstring\tYes\tZIP code\nshipping.country\tstring\tNo\tDefault: \"US\"\nemail\tstring\tYes\tFor payment link + order updates\nagentId\tstring\tNo\tYour agent ID\n\nResponse returns summary with subtotal, shipping, serviceFee, total.\n\nAgent tips:\n\nIf the user hasn't given a shipping address, ask for it naturally: \"Where should I ship it?\"\nIf no email provided, ask: \"What email should we send the payment link to?\"\nAlways present the full breakdown before requesting the payment link:\nSubtotal, Shipping (often FREE with Prime), Service fee (10%), Total\nIf the user seems surprised by the price, remind them of the 10% service fee and offer to find alternatives\nStep 5: Request Payment Link\n\n/buy-amazon-confirm\n\nOnly call this after the user says yes. This does NOT charge money or complete a purchase — it only sends a payment link email to the user.\n\ncurl -X POST https://buystuff.ai/cart/cart_abc123/confirm\n\n\nResponse returns orderId, status, total, and a confirmation message. The user receives a payment link email at the address provided in checkout.\n\nTell the user: \"Check your email for the payment link — once you pay, we'll ship it within 24-48 hours!\"\n\nStep 6: Track Order\n\n/buy-amazon-status\n\ncurl \"https://buystuff.ai/order/AC-MLLZVLMB-001\"\n\n\nStatuses: PENDING_FULFILLMENT → PROCESSING → SHIPPED → DELIVERED\n\nWhen status is SHIPPED, there will be a trackingNumber — share it with the user.\n\nExample: Buying Earbuds\nUser: Find me wireless earbuds under $50\n\nAgent: Here are the top wireless earbuds under $50 on Amazon:\n\n1. 🏆 Sony WF-C500 — $38.00 ⭐4.5 (12,420 reviews) ✓Prime\n2. JBL Tune 130NC — $49.95 ⭐4.3 (8,200 reviews) ✓Prime\n3. Soundcore A20i — $29.99 ⭐4.4 (45,000 reviews) ✓Prime\n\nAll three have Prime (free shipping). The Sony has the best rating, and the Soundcore has the most reviews. Want details on any of these?\n\nUser: Get the Sony ones. Ship to John Doe, 123 Main St, San Francisco CA 94105. Email is john@example.com\n\nAgent: Here's your order:\n\n Sony WF-C500 Wireless Earbuds $38.00\n Shipping (Prime) FREE\n Service fee (10%) $3.80\n ─────────────────────────────────\n Total $41.80\n\nShip to: John Doe, 123 Main St, San Francisco, CA 94105\n\nReady to confirm?\n\nUser: Yes!\n\nAgent: Done! Order #AC-MLLZVLMB-001 is confirmed. 🎉\n\nWe've sent a payment link to john@example.com — just click, pay, and we'll ship within 24-48 hours.\n\nExample: Birthday Gift\nUser: I need a birthday gift for my sister, she's into yoga. Budget is $30.\n\nAgent: Here are some great yoga gifts under $30 on Amazon:\n\n1. Manduka eKO Yoga Mat Towel — $24.99 ⭐4.6 (3,200 reviews) ✓Prime\n2. Yoga Wheel Set (3-pack) — $27.95 ⭐4.5 (8,100 reviews) ✓Prime\n3. Essential Oils Gift Set — $19.99 ⭐4.4 (22,000 reviews) ✓Prime 🔥Deal\n\nThe essential oils set is on sale and fits your budget with room to spare. The yoga wheel set is really popular. Want to see details on any?\n\nUser: The yoga wheel set! Ship to Sarah Chen, 456 Oak Ave, Austin TX 78701. My email is mike@example.com\n\nAgent: Perfect gift choice! Here's the summary:\n\n Yoga Wheel Set (3-pack) $27.95\n Shipping (Prime) FREE\n Service fee (10%) $2.80\n ─────────────────────────────────\n Total $30.75\n\nShip to: Sarah Chen, 456 Oak Ave, Austin, TX 78701\n\nConfirm?\n\nUser: Do it\n\nAgent: Order #AC-MLLZVLMB-002 confirmed! 🎁\n\nPayment link sent to mike@example.com. Pay and we'll have it shipped to Sarah within 24-48 hours. Happy birthday to your sister!\n\nExample: Multi-Item Order\nUser: I need a wireless mouse and a mousepad for my new desk setup.\n\nAgent: Let me search for both! Here's what I found:\n\nWireless mice:\n1. Logitech M185 — $12.99 ⭐4.5 (75,000 reviews) ✓Prime\n2. Logitech Pebble 2 — $24.99 ⭐4.6 (15,000 reviews) ✓Prime\n\nMousepads:\n1. SteelSeries QcK — $9.49 ⭐4.7 (90,000 reviews) ✓Prime\n2. Corsair MM350 — $14.99 ⭐4.6 (12,000 reviews) ✓Prime\n\nUser: Get the Logitech M185 and the SteelSeries mousepad.\n\nAgent: Added both to your cart:\n\n Logitech M185 Wireless Mouse $12.99\n SteelSeries QcK Mousepad $9.49\n Shipping $5.99\n Service fee (10%) $2.85\n ─────────────────────────────────\n Total $31.32\n\nWhere should I ship them? And what email for the payment link?\n\nUser: Ship to Alex Kim, 789 Pine St, Seattle WA 98101. Email alex@example.com\n\nAgent: Here's the final summary:\n\n 2 items → $31.32 total\n Ship to: Alex Kim, 789 Pine St, Seattle, WA 98101\n\nConfirm?\n\nUser: Yes\n\nAgent: Order #AC-MLLZVLMB-003 confirmed! 🎉\n\nPayment link sent to alex@example.com. Once you pay, both items ship within 24-48 hours.\n\nHandling Common Situations\nUser doesn't give a budget: Search normally and show a range of prices. Ask \"Do you have a price range in mind?\" if results vary widely.\nProduct out of stock: Say \"That one's currently unavailable\" and suggest similar alternatives from the search results.\nUser wants to compare two products: Pull details on both and present a quick comparison (price, rating, key specs).\nUser changes their mind after checkout: They can simply not pay the email link. The order expires if unpaid.\nUser asks about returns: Direct them to support@buystuff.ai.\nSearch returns too many results: Narrow with sort_by, exclude_sponsored, or a more specific query.\nQuick Reference\nGET https://buystuff.ai/search?q={query} Search products\nGET https://buystuff.ai/product/{asin} Product details\nGET https://buystuff.ai/cart Get session's active cart (by session)\nGET https://buystuff.ai/cart/{cartId} Get cart by ID\nPOST https://buystuff.ai/cart Add product to cart (or create cart)\nPATCH https://buystuff.ai/cart/{cartId}/items/{asin} Update item quantity\nDELETE https://buystuff.ai/cart/{cartId}/items/{asin} Remove item from cart\nPOST https://buystuff.ai/cart/{cartId}/checkout Checkout\nPOST https://buystuff.ai/cart/{cartId}/confirm Request payment link\nGET https://buystuff.ai/order/{orderId} Track order\n\nHeader: X-Session-ID — send on all requests to maintain session" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/lucasgeeksinthewood/buy-amazon", "publisherUrl": "https://clawhub.ai/lucasgeeksinthewood/buy-amazon", "owner": "lucasgeeksinthewood", "version": "1.2.4", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/buy-amazon", "downloadUrl": "https://openagent3.xyz/downloads/buy-amazon", "agentUrl": "https://openagent3.xyz/skills/buy-amazon/agent", "manifestUrl": "https://openagent3.xyz/skills/buy-amazon/agent.json", "briefUrl": "https://openagent3.xyz/skills/buy-amazon/agent.md" } }