get_health
Health & marketplaces
Health check for Housewarming Kit gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, and marketplaces[] (domain, label, tagConfigured). Use first to discover storefronts. OpenAPI: getHealth.
无需输入参数。
list_marketplaces
List Amazon marketplaces
List supported Amazon storefronts (domain, label, currencyHint, tagConfigured). Agents MUST pick the user's marketplace and pass it on search/catalog/resolve. tagConfigured is false until real Associates IDs exist (buyUrl omits ?tag=).
无需输入参数。
search_kits
Search housewarming kits
Search Amazon for first-apartment / housewarming essentials on the user's marketplace. Returns PA-API products when configured, otherwise search deep-link cards (buyUrl, trackingTag) + catalogMatches. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.
输入参数q必填limitlocale必填moveTyperoomFocusbudgetBandmarketplace必填
get_catalog
Curated kit catalog
Paginated curated housewarming starters. On amazon.se items may include /dp/ASIN buy links; elsewhere catalogMode is search-ideas. ALWAYS pass marketplace + locale. Search remains primary. OpenAPI: getCatalog.
输入参数qlimitlocale必填offsetmoveTyperoomFocusbudgetBandmarketplace必填
resolve_product
Resolve buy / inspiration link
Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to buyUrl (product /dp or apartment search). ALWAYS pass marketplace + locale. Does not invent Associates tags — trackingTag is null until configured. OpenAPI: resolveProduct.
输入参数urlasinlocale必填keywordsmoveTyperoomFocusbudgetBandmarketplace必填
create_kit
Create housewarming kit
Create a housewarming / first-apartment kit list. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_kit_item. Prefer create_and_fill for one-shot. OpenAPI: createWishlist.
输入参数itemslocale必填cityHintmoveTyperoomFocusbudgetBandmarketplace必填householdName
create_and_fill
One-shot create and fill
One call: create a curated housewarming / moving in gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a kit and add ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl. ALWAYS pass marketplace + locale. OpenAPI: agentCreateAndFill.
输入参数locale必填moveTypeitemAsinsroomFocusbudgetBanditemQueriesmarketplace必填itemKeywordshouseholdName
Fetch a kit by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
输入参数id必填
Add an item to a kit. Requires editToken from create. Body: name/title plus asin, url (pasted /dp), searchKeywords, or catalogId. Token storage may return a new id — update bookmarks. OpenAPI: addWishlistItem.
输入参数id必填urlasinnameemojititlecatalogIdeditToken必填searchKeywords