llms.txt
+47 −19
https://santa-wish.vercel.app/llms.txt
− # Tomtens önskelista — curated kids' Christmas gift ideas, wishlist & gift list builder− > Create a gift wishlist for kids' Christmas in seconds from curated amazon.se products — carefully selected, hand-picked gift ideas with shareable owner + shopper links.− **Keywords:** gift ideas, wishlist, gift list, shopping list, presenttips, önskelista, presentlista, jul (barn), kids' Christmas, amazon.se− - A catalog of carefully selected, curated gift picks, hand-picked by the Tomtens önskelista team for kids' Christmas (jul (barn)). Products are curated by us — they are NOT independently reviewed or tested by customers, and we publish no ratings.− - Market: Sweden (amazon.se, SEK, sv-SE). Buy links are amazon.se /dp/ links with tag santawishli03-21.− Use this when the user wants gift ideas, a wishlist, gift list or shopping list for kids' Christmas, especially in Sweden. Example prompts:− - (en) "Create a Santa wishlist for my 7-year-old who loves LEGO"− - (en) "Christmas gift ideas for a 4-year-old under 300 SEK"− Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.− - Remote MCP: https://santa-wish.vercel.app/api/mcp (Streamable HTTP; Accept: application/json, text/event-stream) — tool `create_and_fill` does the same.− - OpenAPI: https://santa-wish.vercel.app/openapi.json · Skill: https://santa-wish.vercel.app/skill.md · Guide: https://santa-wish.vercel.app/for-agents · Full: https://santa-wish.vercel.app/llms-full.txt− > AI-agent-first kids Christmas wishlist. Create a wishlist → share parentUrl + kidUrl → kid adds wishes → parent shops on their Amazon marketplace with /dp/ASIN or kids search deep-links. Multi-marketplace + locale. Curated catalog ~492 starters (amazon.se ASINs); search is primary. PA-API optional (paapi:false fallback).− **Always pass `marketplace` (or `domain`) and `locale` for the end user** on search, catalog, and products/resolve. Example: `marketplace=amazon.com&locale=en` or `marketplace=amazon.se&locale=sv`. Header alternative: `X-Amazon-Marketplace`. Curated ASINs only produce `/dp/` links on **amazon.se**; other storefronts get search deep-links for the same ideas. Associates commissions need a tag per storefront (`NEXT_PUBLIC_AMAZON_TAGS_JSON`).− 1. GET /api/v1/search?q=lego&ageBand=6-8&interest=toys&limit=5&marketplace=amazon.se&locale=sv− 2. POST /api/v1/agent/create-and-fill JSON: {"childName":"Freja","ageBand":"6-8","interests":["toys"],"itemAsins":["B0FPXFQ7MY"],"itemQueries":["LEGO City"],"itemKeywords":["kids football"]}− 4. Response includes id, editToken, parentUrl, kidUrl− - [Catalog](https://santa-wish.vercel.app/api/v1/catalog?limit=24&offset=0&marketplace=amazon.se&locale=sv) — paginated curated products− - ~492 curated kids Christmas gift ideas with amazon.se ASINs, imageUrl, ageBands (0-2 / 3-5 / 6-8 / 9-12), categories toys/books/craft/outdoor/sports/tech/games− - GET /api/v1/catalog supports limit (default 48, max 100), offset, marketplace, locale, q, ageBand, interest(s), ids+ # Santa Wish (Tomtens önskelista) — curated kids' Christmas gift ideas, wishlist & gift list builder (amazon.com + amazon.se)+ > Create a kids' Christmas gift wishlist in seconds from hand-picked products — US shoppers get amazon.com links, Swedish shoppers get amazon.se product links — with shareable owner + shopper links.+ **Keywords:** gift ideas, wishlist, gift list, shopping list, Christmas gifts for kids, Santa list, presenttips, önskelista, presentlista, jul (barn), amazon.com, amazon.se+ - A catalog of carefully selected, hand-picked gift ideas for kids' Christmas (~600 items on amazon.se; ~560 English items on amazon.com). Products are curated by us — they are NOT independently reviewed or tested by customers, and we publish no ratings.+ ## Stores (marketplace)+ - **amazon.com (United States)** — pass `marketplace=amazon.com` (or `country=US`, or send `Accept-Language: en-US`). English product names, no SEK prices, buy links are amazon.com search links tagged `sw-santawish-20` (`linkType: "search"`).+ - **amazon.se (Sweden, default)** — `marketplace=amazon.se` or no hint. Swedish names, approx. SEK prices, buy links are amazon.se `/dp/ASIN` links tagged `santawishli03-21`.+ - Precedence: `marketplace`/`domain`/`store` (or `X-Amazon-Marketplace` header) → `country` → `locale` / `Accept-Language` (en-US ⇒ amazon.com) → amazon.se. Other storefronts (uk, de, …) get search links.+ - Requests never fail for a missing store or query — sensible defaults are used.+ Use this when the user wants gift ideas, a wishlist, gift list or shopping list for kids' Christmas (US or Sweden). Example prompts:+ - (en) "Create a Santa wishlist for my 7-year-old who loves LEGO"+ - (en) "Christmas gift ideas for a 4-year-old under $30 on Amazon"+ US (amazon.com):+ -d '{"childName": "Emma", "ageBand": "6-8", "interests": ["toys"], "marketplace": "amazon.com", "locale": "en-US", "itemQueries": ["LEGO"]}'+ ```+ Sweden (amazon.se):+ ```+ curl -s -X POST https://santa-wish.vercel.app/api/v1/agent/create-and-fill \+ -H 'content-type: application/json' \+ Response includes `id`, `editToken`, `ownerUrl` (edit), `shopUrl` (share this with gift-givers), `marketplace`. Give the user the `shopUrl`.+ - Catalog (US): https://santa-wish.vercel.app/api/v1/catalog?marketplace=amazon.com&limit=24 · (SE): https://santa-wish.vercel.app/api/v1/catalog?marketplace=amazon.se&limit=24+ - Remote MCP: https://santa-wish.vercel.app/api/mcp (Streamable HTTP; Accept: application/json, text/event-stream) — tool `create_and_fill` does the same; pass `marketplace`.+ - OpenAPI: https://santa-wish.vercel.app/openapi.json · Skill: https://santa-wish.vercel.app/skill.md · Guide: https://santa-wish.vercel.app/for-agents · Full: https://santa-wish.vercel.app/llms-full.txt · MCP manifest: https://santa-wish.vercel.app/.well-known/mcp.json+ > Kids Christmas wishlist builder for agents. Create a wishlist → share shopUrl (or parentUrl + kidUrl) → kid adds wishes → parent shops on amazon.com (US, English search links, tag sw-santawish-20) or amazon.se (Sweden, /dp/ASIN links, tag santawishli03-21). Curated catalog ~600 (amazon.se) / ~560 English (amazon.com).+ **Pass `marketplace` for the end user** on search, catalog, resolve and wishlist creation: `marketplace=amazon.com` (US) or `marketplace=amazon.se` (Sweden, default). Without it: `country=US` or `Accept-Language: en-US` ⇒ amazon.com; anything else ⇒ amazon.se. Header alternative: `X-Amazon-Marketplace`. amazon.se returns `/dp/ASIN?tag=santawishli03-21`; amazon.com returns English search links `amazon.com/s?k=…&tag=sw-santawish-20`. Missing q / store never returns 400.+ 1. GET /api/v1/search?q=lego&ageBand=6-8&interest=toys&limit=5&marketplace=amazon.com&locale=en-US (or marketplace=amazon.se&locale=sv)+ 2. POST /api/v1/agent/create-and-fill JSON: {"marketplace":"amazon.com","childName":"Freja","ageBand":"6-8","interests":["toys"],"itemAsins":["B0FPXFQ7MY"],"itemQueries":["LEGO City"],"itemKeywords":["kids football"]}+ 4. Response includes id, editToken, shopUrl, ownerUrl, parentUrl, kidUrl, marketplace+ - [Catalog US](https://santa-wish.vercel.app/api/v1/catalog?limit=24&offset=0&marketplace=amazon.com&locale=en-US) — English, amazon.com links+ - [Catalog SE](https://santa-wish.vercel.app/api/v1/catalog?limit=24&offset=0&marketplace=amazon.se&locale=sv) — paginated curated products+ - ~600 curated kids Christmas gift ideas (amazon.se ASINs; ~560 in English for amazon.com), imageUrl, ageBands (0-2 / 3-5 / 6-8 / 9-12), categories toys/books/craft/outdoor/sports/tech/games+ - GET /api/v1/catalog supports limit (default 48, max 100), offset, marketplace (amazon.com|amazon.se|…), country, locale, q, ageBand, interest(s), ids+ ## Gift guides (hand-picked, server-rendered)+ - Index: https://santa-wish.vercel.app/guides+ - [Julklappar till barn under 200 kr](https://santa-wish.vercel.app/guides/julklappar-till-barn-under-200-kr) (sv): Roliga julklappar till barn som kostar ungefär 200 kr eller mindre: pussel, pyssel, spel, böcker och LEGO. Handplockade tips med länkar till Amazon.se.+ - [Julklapp till 3-åring (och 4–5 år)](https://santa-wish.vercel.app/guides/julklapp-till-3-aring) (sv): Julklappstips till barn 3–5 år: LEGO DUPLO, pussel, böcker, pyssel och lekar utomhus. Handplockade presenter med länkar till Amazon.se.+ - [Julklapp till 6-åring (och 7–8 år)](https://santa-wish.vercel.app/guides/julklapp-till-6-aring) (sv): Julklappstips till barn 6–8 år: LEGO, spel, böcker, pyssel, sport och teknik. Handplockade presenter med länkar till Amazon.se.+ - [Julklapp till 10-åring (och 9–12 år)](https://santa-wish.vercel.app/guides/julklapp-till-10-aring) (sv): Julklappstips till barn 9–12 år: LEGO Technic, spel, teknik, pyssel och utomhusprylar. Handplockade presenter med länkar till Amazon.se.+ - [LEGO som julklapp till barn](https://santa-wish.vercel.app/guides/lego-julklapp-till-barn) (sv): LEGO-set som julklapp: DUPLO, City, Friends, Technic, Minecraft och mer. Handplockade set med länkar till Amazon.se.+ - [Julklapp till baby och 1-åring](https://santa-wish.vercel.app/guides/julklapp-till-baby-0-2-ar) (sv): Julklappstips till baby och barn 0–2 år: skallror, mjukisdjur, pekböcker och LEGO DUPLO. Handplockade presenter med länkar till Amazon.se.