# Girlfriend Gifts

> Build gift recommendation lists, shopping lists, and shareable wishlists for girlfriend/wife — with multi-country Amazon buy links. For humans and AI agents. Always pass marketplace + locale (e.g. US: marketplace=amazon.com&locale=en).

Site: https://girlfriendgifts.vercel.app

## Quickstart (list-building)
- Health: GET /api/v1/health
- Marketplaces: GET /api/v1/marketplaces
- Search: GET /api/v1/search?q=&marketplace=&locale=&occasion=&budgetBand=&styleTag=&limit=
  Example US: /api/v1/search?q=pearl%20earrings&marketplace=amazon.com&locale=en&limit=5
- Catalog (170+ real amazon.se /dp ASINs): GET /api/v1/catalog?marketplace=amazon.se&locale=sv
- Create wishlist: POST /api/v1/wishlists  { recipientName, occasion, budgetBand, styleTags, relationship, marketplace, locale }
- One-shot list fill: POST /api/v1/agent/create-and-fill
- Resolve: POST /api/v1/products/resolve  { asin|url|keywords, marketplace, locale } → buyUrl
- Owner UI: /w/{id}   Shopper UI: /w/{id}/shop
- Full docs: /llms-full.txt  /openapi.json  /skill.md  /agents.md  /for-agents
- MCP (Streamable HTTP): https://girlfriendgifts.vercel.app/api/mcp (also local stdio via npm run mcp; tools require marketplace + locale)

Tracking: amazon.se product links use ?tag=sw-girlfriend-21 when configured via NEXT_PUBLIC_AMAZON_TAGS_JSON; other storefronts may stay untagged. Prefer buyUrl / trackingTag. Never invent placeholders or reuse santawishli03-21. May earn from qualifying purchases.