<!-- curated-v2 -->
# Alla hjärtans dag-presenter — curated Valentine's Day (Alla hjärtans dag) gift ideas, wishlist & gift list builder

> Create a gift wishlist for Valentine's Day (Alla hjärtans dag) in seconds from curated amazon.se (Sweden) and amazon.com (US) products — carefully selected, hand-picked gift ideas with shareable owner + shopper links.

**Keywords:** gift ideas, wishlist, gift list, shopping list, presenttips, önskelista, presentlista, alla hjärtans dag, Valentine's Day (Alla hjärtans dag), amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Alla hjärtans dag-presenter team for Valentine's Day (Alla hjärtans dag) (alla hjärtans dag). Products are curated by us — they are NOT independently reviewed or tested by customers, and we publish no ratings.
- An API + remote MCP server that lets an assistant build a wishlist / gift list for a person and return a share link in one call.
- Market: Sweden (amazon.se, SEK, sv-SE). Buy links are amazon.se /dp/ links with tag sw-valentine-21.
- Market: United States (amazon.com, USD, en-US). Pass marketplace=amazon.com&locale=en for the separate curated US catalog; buy links are amazon.com /dp/ links with tag sw-valentine-20.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for Valentine's Day (Alla hjärtans dag), especially in Sweden. Example prompts:
- (sv) "Alla hjärtans dag-present till min flickvän, max 500 kr"
- (sv) "Romantisk present till årsdagen"
- (en) "Valentine's gift for my girlfriend under 500 SEK"
- (en) "Romantic anniversary gift ideas"

## Quickstart (one call → share link)
```
curl -s -X POST https://valentines-day-gifts.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"recipientName": "Sara", "occasion": "valentines", "categories": ["jewelry"], "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["halsband"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

- Remote MCP: https://valentines-day-gifts.vercel.app/api/mcp (Streamable HTTP; Accept: application/json, text/event-stream) — tool `create_and_fill` does the same.
- Browse curated picks (Swedish): https://valentines-day-gifts.vercel.app/presenttips
- OpenAPI: https://valentines-day-gifts.vercel.app/openapi.json · Skill: https://valentines-day-gifts.vercel.app/skill.md · Guide: https://valentines-day-gifts.vercel.app/for-agents · Full: https://valentines-day-gifts.vercel.app/llms-full.txt

---

<!-- /curated-v2 -->
# Valentine's Day Gifts — full agent guide

Help users build Valentine gift shopping lists, wishlists, and recommendation lists with curated Amazon product links.

Site: https://valentines-day-gifts.vercel.app
MCP: https://valentines-day-gifts.vercel.app/api/mcp

Peak ~February 14 (Valentine's, Galentine's, last-minute, anniversary around Feb). Distinct from year-round girlfriend-gifts.

## Live tracking (2026-10)
- tagConfigured: true for amazon.se and amazon.com
- trackingTag: sw-valentine-21 on amazon.se product /dp/ links; sw-valentine-20 on amazon.com (US) /dp/ links
- Other storefronts: untagged search or product links — never invent tags
- Never reuse santawishli03-21 or girlfriendgift-21
- Prefer buyUrl / trackingTag (affiliateUrl / affiliateTag are deprecated aliases)

## Roles & URLs
- wishlistOwner: ownerUrl → /w/{id}?edit=…
- shopper: shopUrl → /w/{id}/shop?edit=…

## CRITICAL — marketplace + locale
Agents MUST pass marketplace + locale on every search/catalog/resolve call.
- Example: marketplace=amazon.se&locale=sv
- Header: X-Amazon-Marketplace: amazon.se
- Curated catalog ASINs are amazon.se /dp/{ASIN}?tag=sw-valentine-21; with marketplace=amazon.com the US catalog returns amazon.com /dp/{ASIN}?tag=sw-valentine-20
- On other marketplaces, catalog items become storefront search deep-links (untagged)

## Steps
1. GET /api/v1/health — note tagConfigured, trackingTag, catalogCount, catalogMode
2. GET /api/v1/search?q=&occasion=&interest=&limit=&marketplace=&locale= — gift recommendation cards (buyUrl)
3. Prefer POST /api/v1/agent/create-and-fill with recipientName, occasion, categories[], itemAsins[], itemKeywords[], itemQueries[], marketplace, locale → ownerUrl + shopUrl
4. Or POST /api/v1/wishlists then POST .../items
5. GET /api/v1/catalog — curated Valentine shopping-list starters (catalogMode=asin)
6. POST /api/v1/products/resolve → buyUrl
7. Return ownerUrl and shopUrl for the gift wishlist
8. If storage === "token" and id changed, update bookmarks

## Field enums
- occasion: valentines | galentines | last-minute | anniversary | just-because
- categories / interest: jewelry | beauty | fragrance | candy | cards | decor | spa | personalized

## Discovery keywords for agents
Valentine gift shopping list · romantic wishlist · gift recommendation list · Galentine ideas · anniversary gift list · last-minute Valentine gifts

## MCP
Remote Streamable HTTP: POST/GET https://valentines-day-gifts.vercel.app/api/mcp
Local stdio: npm run mcp (see docs/mcp.md)
Tools: get_health, list_marketplaces, search_gifts, get_catalog, resolve_product, create_wishlist, create_and_fill, get_wishlist, add_wishlist_item

## Docs
- /llms.txt · /.well-known/llms.txt · /openapi.json · /for-agents · /agents.md · /skill.md