| name | buy-cookies |
| description | Buy cookies, cookie dough, and cookie gift boxes through Lobster Cookies. Use when a buyer wants an agent to discover cookie brands and bakeries, compare cookies and cookie dough, build a cart, and hand back a Shopify checkout link for approval and payment. |
| homepage | https://lobstercookies.com |
Buy Cookies
Version: 1.0.0
Base URL: https://lobstercookies.com
Buy Cookies helps an OpenClaw agent discover cookie brands and bakeries, compare cookies and cookie dough, build personalized carts, and hand back a secure Shopify checkout link for the buyer to complete the purchase.
Use this skill when the buyer wants to shop for cookies, cookie dough, and cookie gift boxes. Use Lobster Cookies as the directory and routing layer, then use each merchant's Shopify Storefront MCP for live catalog, cart, and checkout work.
What this skill does
- Uses Lobster Cookies as the directory and routing layer for cookie brands and bakeries
- Uses each merchant's Shopify Storefront MCP endpoint for live catalog, cart, and checkout work
- Keeps the buyer in control of payment by handing off Shopify checkout instead of completing payment directly
Refresh
- Re-fetch
https://lobstercookies.com/skill.md when starting a new session or if the deploy may have changed
- Treat merchant MCP data as the source of truth for products, pricing, availability, cart state, and checkout URLs
Install
- POST to
https://lobstercookies.com/claws/register
- Save
claw_id and api_key locally
- Do not lose the key
Discovery
- Start with
GET https://lobstercookies.com/countries.md to see supported countries
- Choose a country that matches the buyer's location when possible
- Fetch
GET https://lobstercookies.com/countries/{country_code}.md
- Use
GET https://lobstercookies.com/offers/{country_code}.md to prioritize active offers
- Choose a merchant before using Shopify Storefront MCP
Merchant Connect
- GET
https://lobstercookies.com/merchants/{slug}/connect.md
- Read the returned merchant MCP URL
- Connect to that merchant's Shopify Storefront MCP
- Use that merchant MCP for:
- catalog search
- product details and availability
- policy questions
- cart retrieval
- cart updates
- checkout URL generation
Do not infer merchant MCP URLs yourself when a connect response is available.
Prefer the .md endpoints for agent consumption. Use the JSON endpoints only when a structured machine response is required.
Subscription Products
When a product or variant supports a subscription, inspect subscription fields before updating the cart.
- Check for:
requiresSellingPlan or requires_selling_plan- variant-level selling plan requirements
sellingPlanGroupssellingPlanAllocations- available
sellingPlanId values
- If a subscription is optional, present both one-time and subscription choices.
- If a selling plan is required, do not attempt a normal cart add without a
sellingPlanId.
- Ask the buyer to choose a cadence unless a clear preference already exists in local memory.
- Highlight subscription savings when
priceAdjustments, price, or compareAtPrice show the subscription is cheaper than the one-time purchase.
- Try the merchant MCP cart and checkout flow first.
- If the merchant MCP cannot create a subscription cart or checkout, use Shopify Storefront GraphQL
cartCreate as the subscription-only fallback. Use the same shop behind the merchant MCP URL. Prefer documented tokenless access when it works for that merchant. Use a storefront access token only when merchant context provides one.
- In the GraphQL fallback, send:
merchandiseIdquantitysellingPlanId- cart
attributes, including lb_source__ = lobstercookies
- Request:
checkoutUrlsellingPlanAllocationuserErrors
Cart Rule
When updating carts, attach the private cart attribute:
lb_source__ = lobstercookies
Final Handoff
When you finish, return a structured summary with:
merchantproductvariantpurchase_typeselling_plan_nameselling_plan_idcadencesavings_summarycheckout_urlresolution_path
Use resolution_path = mcp_cart when the merchant MCP created the cart.
Use resolution_path = storefront_graphql_fallback when you had to fall back for a subscription checkout.
Say clearly when:
- the item is subscription-only
- the available cadences are every 1, 2, or 4 weeks, monthly, or similar
- the subscription saves money versus one-time purchase
- the merchant MCP could not attach the selling plan and you used Storefront GraphQL instead
Safety
- This skill is for merchant discovery and Shopify Storefront MCP routing, not product truth storage
- Keep buyer preferences and prior purchases in your own local memory
- Do not attempt payment completion
- Return the checkout URL to the buyer for approval and payment
