shopify-storefront

name	shopify-storefront
description	Set up a Shopify cart and provide a checkout link. Use when the user asks to buy a product, provides a Shopify product URL to purchase, or wants to add items to a cart on a Shopify store.
user-invocable	false
allowed-tools	Bash(curl *)
context	fork

Shopify Storefront Checkout

Set up a cart with a product and an optional discount code, then give the user a checkout link.

Inputs

• Product URL: A Shopify product URL (e.g. https://humanrequired.shop/products/cool-shirt)
• Discount code (optional): Obtained from the shopify-agent-discount skill. Always check for one before proceeding.

Flow

1. Find the product

Use curl -s "<product_url>.json" (strip any query parameters first, then append .json) to fetch the raw product JSON. Pick the first variant from the response. Note the variant ID.

2. Build the checkout link

Construct the checkout URL directly:

https://<shop-domain>/cart/<variant_id>:1?discount=<DISCOUNT_CODE>

For example:

https://humanrequired.shop/cart/46991516106914:1?discount=WORLD-ID-abc123

• <variant_id>: The numeric variant ID from step 1 (NOT the gid:// format — just the number).
• :1: Quantity of 1.
• ?discount=<DISCOUNT_CODE>: Append only if a discount code was obtained. Omit the parameter entirely if there is no discount.

3. Present to the user

Share the checkout link. If a discount was applied, mention it:

I found a human-only discount and built your cart! Complete your purchase here: {checkout_url}

If no discount was available:

Here's your checkout link: {checkout_url}

Output

Do not narrate each step. Only produce user-facing output at step 3, or earlier if something fails.