<!-- curated-v2 -->
# Fitness Starter — curated starting running, strength or yoga gift ideas, wishlist & gift list builder

> Create a gift wishlist for starting running, strength or yoga in seconds from curated amazon.se (Sweden) and amazon.com (United States) products — carefully selected, hand-picked gift ideas with shareable owner + shopper links.

**Keywords:** gift ideas, wishlist, gift list, shopping list, presenttips, önskelista, presentlista, träning, starting running, strength or yoga, amazon.se, amazon.com, US fitness gifts

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Fitness Starter team for starting running, strength or yoga (träning). 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-fitness-21.
- Market: United States (amazon.com, USD, en-US). Pass marketplace=amazon.com for US shoppers: catalog/search return hand-picked amazon.com /dp/{ASIN} links with tag sw-fitness-20 (e.g. https://www.amazon.com/dp/ASIN?tag=sw-fitness-20). Human pages auto-switch for US visitors; ?country=US forces the US store, ?country=SE the Swedish one.


## United States (amazon.com)

- GET /api/v1/catalog?goal=run&level=starter&marketplace=amazon.com&locale=en-US — hand-picked amazon.com /dp/ products (catalog: "us", linkType=product, trackingTag sw-fitness-20)
- GET /api/v1/search?q=yoga%20mat&goal=yoga&level=starter&marketplace=amazon.com&locale=en-US&limit=5 — catalogMatches are amazon.com /dp/ links
- POST /api/v1/agent/create-and-fill with "marketplace":"amazon.com","locale":"en-US" — pack items link to amazon.com/dp/ASIN?tag=sw-fitness-20
- MCP (/api/mcp): pass marketplace=amazon.com on browse_catalog, search_gear, create_and_fill, create_pack, resolve_product
- budgetBand keys are shared; for amazon.com they mean under $50 (under-500), $50–150 (500-1500), $150–300 (1500-3000), $300+ (3000-plus)

## Store selection (marketplace optional, never an error)
- marketplace and locale are optional on every API and MCP call; a missing store never returns an error.
- Order: marketplace (or domain / X-Amazon-Marketplace header) > country (param or X-Country header; US → amazon.com) > Accept-Language (starts with en-US → amazon.com) > default amazon.se.
- An en-US caller with no marketplace gets amazon.com /dp/ links tagged sw-fitness-20; sv-SE and everything else gets amazon.se links tagged sw-fitness-21. For US shoppers, pass marketplace=amazon.com explicitly.
- amazon.com search links always use English keywords; amazon.com prices are USD (priceUsd) or omitted.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for starting running, strength or yoga, especially in Sweden or the United States (amazon.com). Example prompts:
- (sv) "Vilken utrustning behöver jag för att börja springa?"
- (sv) "Present till någon som börjat med yoga, max 500 kr"
- (en) "What gear do I need to start running?"
- (en) "Gift for someone who just started yoga under 500 SEK"
- (en-US) "Beginner lifting gear under $50" → marketplace=amazon.com

## Quickstart (one call → share link)
```
curl -s -X POST https://fitness-starter.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"athleteName": "Alex", "goal": "run", "level": "starter", "budgetBand": "500-1500", "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["löparbälte"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

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

---

<!-- /curated-v2 -->
# Skill: Fitness Starter Ladder

Suggest fitness gear lists, starter ladders, and recommendation packs (run / lift / yoga) with curated Amazon buy links.

## When to use
- Gear recommendation list or starter ladder (starter → building → serious)
- Someone starting run, lift, or yoga needs a practical pack to buy
- Athlete edits a pack; coach/gifter shops via shopUrl

## Roles & URLs
- **owner** (athlete): `ownerUrl` → `/w/{id}?edit=…`
- **shop** (coach / gifter / agent): `shopUrl` → `/w/{id}/shop?edit=…`

## Steps
1. GET `/api/v1/catalog?goal=&level=&marketplace=amazon.se&locale=` — curated /dp/ products on amazon.se (use `marketplace=amazon.com` for the US catalog)
2. GET `/api/v1/search?q=&goal=&level=&budgetBand=&marketplace=&locale=&limit=`
3. Prefer POST `/api/v1/agent/create-and-fill` with `athleteName`, `goal`, `level`, `marketplace`, `locale`, optional `itemAsins` / `itemKeywords` / `itemQueries`
4. Or POST `/api/v1/wishlists` then POST `.../items`
5. POST `/api/v1/products/resolve` `{ asin|url|keywords, marketplace, locale }` → `buyUrl` + `trackingTag` (sw-fitness-20 on amazon.com, sw-fitness-21 on amazon.se)
6. Return `ownerUrl` and `shopUrl`

## MCP
- `POST /api/mcp` — tools: search_gear, browse_catalog, create_and_fill, create_pack, add_item, resolve_product (marketplace + locale optional; en-US → amazon.com, otherwise amazon.se; pass marketplace=amazon.com for US)

## Enums
- `goal`: run | lift | yoga
- `level`: starter | building | serious
- `budgetBand`: under-500 | 500-1500 | 1500-3000 | 3000-plus

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

## Tracking
amazon.se uses tracking tag `sw-fitness-21` and amazon.com uses `sw-fitness-20` (`NEXT_PUBLIC_AMAZON_TAGS_JSON`).