shopify-storefront

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.