get_health
Health & service info
Health check for Girlfriend Gifts romantic gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, marketplaceIds. Use list_marketplaces to discover storefronts. OpenAPI: getHealth.
無需輸入參數。
list_marketplaces
List Amazon marketplaces
List supported Amazon storefronts (id, domain, label, defaultLocale, currencyHint, tagConfigured). Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.
無需輸入參數。
search_gifts
Search girlfriend / wife gifts
Search Amazon for romantic partner gifts to build a recommendation or shopping list. Returns PA-API products when configured for the default storefront, otherwise romantic search deep-link cards + catalogMatches. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.
輸入參數q必填limitlocale必填occasionstyleTagbudgetBandmarketplace必填
get_catalog
Curated gift catalog
Curated girlfriend/wife gift catalog (170+ real amazon.se /dp ASINs) for building shopping lists and wishlists. On amazon.se items include /dp/ASIN buy links (tag sw-girlfriend-21 when configured); on other marketplaces catalogMode is search-ideas. ALWAYS pass marketplace + locale. OpenAPI: getCatalog.
輸入參數qlocale必填occasionstyleTagstyleTagsbudgetBandmarketplace必填
resolve_product
Resolve buy / inspiration link
Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (product /dp or romantic search). ALWAYS pass marketplace + locale for the user. Does not invent Associates tags — uses server-configured tags per storefront. OpenAPI: resolveProduct.
輸入參數urlasinlocale必填keywordsoccasionstyleTagbudgetBandmarketplace必填
create_wishlist
Create wishlist
Create a girlfriend/wife gift list / wishlist for shopping-list building. Returns id, editToken, ownerUrl (she edits), shopUrl (he/agent shops), wishlist, storage. Save editToken for add_wishlist_item. If storage is token, later mutations may return a new id — always use the latest. OpenAPI: createWishlist.
輸入參數itemslocaleoccasionstyleTagsbudgetBandmarketplacerelationshiprecipientName
create_and_fill
One-shot create and fill
Preferred agent path for list-building: create a gift wishlist and fill it with ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl. Pass marketplace + locale. OpenAPI: agentCreateAndFill.
輸入參數localeoccasionitemAsinsstyleTagsbudgetBanditemQueriesmarketplaceitemKeywordsrelationshiprecipientName
Fetch a wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
輸入參數id必填
add_wishlist_item
Add wish item
Add an item to a gift list / wishlist (shopping-list building). Requires editToken from create. Body: name/title plus asin, url (pasted /dp), searchKeywords, or catalogId. Token storage may return a new id — update bookmarks. Prefer buyUrl in responses. OpenAPI: addWishlistItem.
輸入參數id必填urlasinnameemojititlelocalecatalogIdeditToken必填marketplacesearchKeywords