# Home Office Builder — curated home office setup gift ideas, wishlist & gift list builder > Create a gift wishlist for home office setup 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, hemmakontor, home office setup, amazon.se ## What it is - A catalog of carefully selected, curated gift picks, hand-picked by the Home Office Builder team for home office setup (hemmakontor). 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-homeoffice-21. ## When an assistant should use it Use this when the user wants gift ideas, a wishlist, gift list or shopping list for home office setup, especially in Sweden. Example prompts: - (sv) "Gör en inköpslista för ett ergonomiskt hemmakontor för utvecklare" - (sv) "Present till kollega som jobbar hemifrån" - (en) "Build a home office shopping list for a developer" - (en) "Gift for a colleague who works from home" ## Quickstart (one call → share link) ``` curl -s -X POST https://home-office-builder.vercel.app/api/v1/agent/create-and-fill \ -H 'content-type: application/json' \ -d '{"personName": "Marcus", "role": "developer", "budgetBand": "1500-4000", "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["skärmarm"]}' ``` Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`. - Remote MCP: https://home-office-builder.vercel.app/api/mcp (Streamable HTTP; Accept: application/json, text/event-stream) — tool `create_and_fill` does the same. - Browse curated picks (Swedish): https://home-office-builder.vercel.app/presenttips - OpenAPI: https://home-office-builder.vercel.app/openapi.json · Skill: https://home-office-builder.vercel.app/skill.md · Guide: https://home-office-builder.vercel.app/for-agents · Full: https://home-office-builder.vercel.app/llms-full.txt --- # Skill: Home Office Builder Use this skill to suggest home-office desk gear by **role** and **budget** and to create shareable desk boards with Amazon purchase links on the **selected storefront**. Geared to desk-setup shopping lists and home-office gear recommendations. ## When to use - Someone wants a desk setup shortlist with buy links (role + budget + marketplace + locale) - A desk owner wants to publish a board a buyer (or AI agent) can shop - You need curated amazon.se /dp/ starters plus open Amazon search ## Roles & URLs - **deskOwner**: `ownerUrl` → `/w/{id}?edit=…` — add/edit gear - **buyer**: `shopUrl` → `/w/{id}/shop?edit=…` — search & buy ## Required agent params Always pass **`marketplace`** (domain e.g. `amazon.se` / `amazon.com`) and **`locale`** (e.g. `sv`, `en-US`), plus prefer **`role`** and **`budgetBand`**. Search runs on the selected store. ## Steps 1. GET `/api/v1/search?q=&role=&budgetBand=&marketplace=&locale=&limit=` for ideas (PA-API products or search deep-links; `paapi:false` fallback). Check `tagConfigured`. 2. Prefer POST `/api/v1/agent/create-and-fill` with `personName`, `role`, `budgetBand`, `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?role=&budgetBand=&marketplace=&locale=&offset=&limit=` — curated starters (150+ verified amazon.se ASINs; `catalogMode=asin` for amazon.se) 5. POST `/api/v1/products/resolve` `{ asin }` or `{ url }` or `{ keywords }` (+ marketplace/locale/role) → `buyUrl` (+ `tagConfigured`, `trackingTag`) 6. Return `ownerUrl` and `shopUrl` to the user 7. If `storage === "token"` and `id` changed, update bookmarks (prefer Upstash Redis for stable share links) ## Field enums - `role`: developer | designer | student | general - `budgetBand`: under-500 | 500-1500 | 1500-4000 | 4000-plus ## Docs - https://home-office-builder.vercel.app/llms.txt - https://home-office-builder.vercel.app/llms-full.txt - https://home-office-builder.vercel.app/openapi.json - https://home-office-builder.vercel.app/for-agents - https://home-office-builder.vercel.app/agents.md - https://home-office-builder.vercel.app/skill.md ## MCP - Remote Streamable HTTP: https://home-office-builder.vercel.app/api/mcp - Local stdio: `npm run mcp` (see /docs/mcp.md) ## Tracking tag Tracking tag: amazon.se uses real Associates tag `sw-homeoffice-21` via `NEXT_PUBLIC_AMAZON_TAGS_JSON={"amazon.se":"sw-homeoffice-21"}`. Other storefronts stay untagged (`tagConfigured=false` / `trackingTag=null`). Prefer response fields `buyUrl` + `trackingTag`. Never invent placeholders; never reuse Santa (`santawishli03-21`) or Girlfriend (`girlfriendgift-21`) tags.