<!-- curated-v2 -->
# Housewarming Kit — curated housewarming / moving in gift ideas, wishlist & gift list builder

> Create a gift wishlist for housewarming / moving in 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, inflyttningsfest, housewarming / moving in, amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Housewarming Kit team for housewarming / moving in (inflyttningsfest). 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-housewarm-21.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for housewarming / moving in, especially in Sweden. Example prompts:
- (sv) "Inflyttningspresent till vänner som köpt första lägenheten"
- (sv) "Gör en lista med det viktigaste till nya hemmet"
- (en) "Housewarming gift for friends who bought their first apartment"
- (en) "Make a checklist for a new home"

## Quickstart (one call → share link)
```
curl -s -X POST https://housewarming-kit.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"householdName": "Alex & Sam", "moveType": "first-apartment", "budgetBand": "under-2k", "roomFocus": ["kitchen"], "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["skärbräda"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

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

---

<!-- /curated-v2 -->
# Skill: Housewarming Kit

Use this skill to build first-apartment / housewarming kits and shareable shop lists with Amazon purchase links on the end user's marketplace.

## When to use
- Someone is moving into a first apartment, upgrading, merging households, student housing, or a furnished rental
- They want a shopping list / kit / recommendation list of move-in essentials (moveType + budget + roomFocus)
- Guests should help fill gaps via a shareable shop URL
- You need curated starters plus open Amazon search (search is primary)

## Roles & URLs
- **kit owner** (mover): `ownerUrl` → `/w/{id}?edit=…` — add/edit kit items
- **shopper / guest / agent**: `shopUrl` → `/w/{id}/shop?edit=…` — search & buy

## Marketplace (required for agents)
ALWAYS pass `marketplace` (id like `us` or domain like `amazon.com`) and `locale` (e.g. `en-US`, `sv-SE`).
Do NOT hardcode amazon.se as the only path.

## Tracking tags
amazon.se product buy URLs include `?tag=sw-housewarm-21` (configured via `NEXT_PUBLIC_AMAZON_TAGS_JSON`). Other storefronts stay untagged (no `?tag=`). Health reports per-marketplace `tagConfigured` / `trackingTag`. Never invent placeholders (`housewarmkit-21`) or reuse `santawishli03-21` / girlfriend tags.

## Steps
1. GET `/api/v1/search?q=&moveType=&budgetBand=&roomFocus=&marketplace=&locale=&limit=` for ideas
2. Prefer POST `/api/v1/agent/create-and-fill` with `householdName`, `moveType`, `budgetBand`, `roomFocus`, `marketplace`, `locale`, `itemAsins[]`, `itemKeywords[]`, `itemQueries[]`
3. Or POST `/api/v1/wishlists` then POST `.../items` with `{ name, asin }` or `{ name, url }`
4. GET `/api/v1/catalog` — curated starters (200+ move-in essentials); **search is the main path**
5. POST `/api/v1/products/resolve` `{ asin, marketplace, locale }` or `{ keywords, marketplace, locale }` → `buyUrl` + `trackingTag`
6. GET `/api/v1/marketplaces` or `/api/v1/health` for supported storefronts
7. MCP remote: `/api/mcp` (Streamable HTTP)
8. Return `ownerUrl` and `shopUrl` to the user
9. If `storage === "token"` and `id` changed, update bookmarks (prefer Upstash Redis; prefix `hwkit:`)

## Field enums
- `moveType`: first-apartment | upgrade | couple-merge | student | furnished-rental
- `budgetBand`: under-2k | 2k-5k | 5k-10k | 10k-plus
- `roomFocus`: kitchen | bathroom | sleep | laundry | cleaning | lighting | storage

## Docs
- /llms.txt and /.well-known/llms.txt
- /llms-full.txt
- /openapi.json
- /for-agents
- /agents.md