<!-- curated-v2 -->
# Studentpresenter — curated Swedish high-school graduation (studenten) gift ideas, wishlist & gift list builder

> Create a gift wishlist for Swedish high-school graduation (studenten) 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, studenten, Swedish high-school graduation (studenten), amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Studentpresenter team for Swedish high-school graduation (studenten) (studenten). 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-student-21.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for Swedish high-school graduation (studenten), especially in Sweden. Example prompts:
- (sv) "Studentpresent till min brorson, max 300 kr"
- (sv) "Vad ger man i present på mottagningen?"
- (en) "Graduation gift for a Swedish student under 300 SEK"
- (en) "Gift ideas for a graduation reception (mottagning)"

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

- Remote MCP: https://studenten-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://studenten-gifts.vercel.app/presenttips
- OpenAPI: https://studenten-gifts.vercel.app/openapi.json · Skill: https://studenten-gifts.vercel.app/skill.md · Guide: https://studenten-gifts.vercel.app/for-agents · Full: https://studenten-gifts.vercel.app/llms-full.txt

---

<!-- /curated-v2 -->
# Skill: Studenten Gifts

Use this skill to build Studentexamen / Studenten celebration gift recommendation lists and shareable wishlists with Amazon buy links.

## When to use
- Family or friends need a Studentexamen / mottagning / studentflak present
- Building a shortlist by occasion, budget, and gift category
- Creating a shareable wishlist the graduate (or family) can publish

## Base URL
https://studenten-gifts.vercel.app

## Required on every call
Pass `marketplace` + `locale` (Sweden default: `amazon.se` + `sv`).

## Key endpoints
- GET `/api/v1/health`
- GET `/api/v1/search?q=&occasion=&budgetBand=&giftCategory=&relationship=&marketplace=&locale=&limit=`
- GET `/api/v1/catalog?marketplace=amazon.se&locale=sv` — 240 curated amazon.se ASINs (`catalogMode: asin-when-known`)
- POST `/api/v1/wishlists` — `{ studentName, occasion, budgetBand, giftCategories, relationship, marketplace, locale, items? }`
- POST `/api/v1/agent/create-and-fill`
- POST `/api/v1/products/resolve` — `{ asin|url|keywords, marketplace, locale }` → `buyUrl`
- MCP (Streamable HTTP): `/api/mcp`

## Fields
- `studentName` (alias `recipientName`)
- `occasion`: studentexamen | mottagning | studentflak | graduation-dinner | thank-you-student | white-cap-party | afterparty | other
- `giftCategories`: jewelry | flowers | fashion | tech | experience | keepsakes | party | gourmet | champagne-accessories | photo | practical | luxury
- `relationship`: parent | friend | relative | partner
- `budgetBand`: under-300 | 300-700 | 700-1500 | 1500-plus

## Tracking
amazon.se product `buyUrl` links include `?tag=sw-student-21` when configured via `NEXT_PUBLIC_AMAZON_TAGS_JSON`. Prefer `buyUrl` / `trackingTag`. Never invent tags or reuse santa/wedding/host/pet/dorm/girlfriend tags. Other storefronts stay untagged search links unless configured.

## Docs
`/llms.txt` `/llms-full.txt` `/openapi.json` `/agents.md` `/for-agents`