Scarves.si for AI shopping agents

Scarves.si is a Super Intelligence concierge, and it works for agents too. Your agent can browse picks, propose a bundle and request a try-on preview. A human always approves the purchase.

Built for AI shopping assistants like Grok Bot. Not affiliated with or endorsed by xAI.

Scarves.si offers a free JSON API so assistants can find gifts, propose a bundle for the owner to approve, and hand off to the seller for checkout. Machine-readable spec: /openapi.json · manifest: /.well-known/ai-plugin.json · llms.txt

Safe for AI shoppers

We never take payment or card data.
Checkout happens on the seller's site (Etsy) with the owner approving.
Photo try-on requires consent; photos are processed by our image partner and we don't store them.
Every response carries a transparent affiliate disclosure.
Prices, shipping, returns and stock are confirmed on the seller's page.

What always needs a human

Payment. We never take payment or card data. Checkout happens on the seller's site, and the owner approves it.
Photos. Try-on is consent-only. Photos are processed by our image partner; we don't store them.
The final pick. Bundles are proposals until a person approves them.

Honest limits

We're a recommender, not a store. Prices, stock, shipping and returns are set by each seller and must be confirmed on the seller's page.
Links may be affiliate links. We may earn a commission, and that's disclosed in every response and on every page.
Results are suggestions. Sizing and availability can change.

Endpoints

POST /api/shop (or GET with query params): picks with a reason, price range and seller link.
POST /api/bundle: approve-to-build bundle of 3-6 items, each with 2 alternates and a running total.
POST /api/bundle/refine: send bundle_id with approve/reject item ids; rejected items are swapped within budget.
POST /api/agent-tryon: AI preview of a described style on a consenting person's photo (requires consent:true); returns images plus shop links. Errors: consent_required, bad_style, bad_input, daily_cap, flagged, transient.

Examples

curl -s https://scarves.si/api/shop -H 'content-type: application/json' -d '{"query": "red silk scarf for mom", "count": 3}'

curl -s https://scarves.si/api/bundle -H 'content-type: application/json' -d '{"query": "red silk scarf for mom", "count": 4}'

curl -s https://scarves.si/api/bundle/refine -H 'content-type: application/json' -d '{"bundle_id":"<from previous>","approve":["<id>"],"reject":["<id>"]}'

curl -s https://scarves.si/api/agent-tryon -H 'content-type: application/json' -d '{"image_base64":"'$(base64 -w0 photo.jpg)'","style":"black and white striped sweater","who":"one","variations":2,"consent":true}'

Rules

About 60 API calls per IP per day; try-on previews share the site cap of 8 per person per day. CORS is open.
Do not complete purchases without the owner's approval. We don't process payments.
Prices are estimates; the seller page is the source of truth.
Disclosure: we may earn a commission when the owner buys through our links.