Birthday Gift Finder – hand-picked gift ideas

io.github.maggat由 GitHub 帳號 maggat 發布v1.2.0更新於 Oct 26, 2026

Hand-picked gift ideas for birthdays that assistants turn into shareable wishlists fast. SE + US.

發布方自己的服務:Finder Jobs

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

遠端 MCP 伺服器,提供精選的 Amazon 生日禮物建議,並為美國與瑞典站點建立可分享的願望清單。

可以做什麼
  • 檢查服務健康狀態並列出支援的 Amazon 站點
  • 搜尋生日禮物,瀏覽分頁的精選禮物目錄與商品連結
  • 將 ASIN、貼上的 Amazon 商品網址或關鍵字解析成帶追蹤標籤的購買連結
  • 建立願望清單、加入商品,並依 id 取得清單
  • 一次呼叫建立並填入精選願望清單,回傳擁有者連結與分享連結
適用情境
當使用者想要生日禮物靈感或可分享的願望清單(önskelista、presenttips),且對象是美國或瑞典的購物者時適用,可讓助理用一兩次呼叫完成整理。
執行需求
需要遠端 streamable HTTP 端點;未宣告任何套件、帳號、API 金鑰或環境變數。站點預設值依國家與 Accept-Language 判斷,否則回退到 amazon.se。
安裝前請注意
願望清單建立在伺服器上,create_wishlist 回傳的 editToken 是加入商品所必需,應視為機密。商品連結帶有服務方的 Amazon 聯盟追蹤標籤,商品由服務方人工挑選而非使用者評價。任何取得分享連結的人都能查看清單。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Birthday Gift Finder – hand-picked gift ideas,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.maggat%2Fbirthday-gifts/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "birthday-gift-finder-hand-picked-gift-id": {
      "type": "http",
      "url": "https://birthday-gift-finder.vercel.app/api/mcp"
    }
  }
}

工具

9

get_health

Health & marketplaces

Health check for Birthday Gift Finder. Returns ok, storage, defaultDomain (amazon.se), catalogs for amazon.se and amazon.com with their tracking tags, and marketplaces[]. Use this first. OpenAPI: getHealth.

無需輸入參數。

list_marketplaces

List Amazon marketplaces

List supported Amazon storefronts. amazon.com (US) and amazon.se have hand-picked catalogs with /dp links. Pass marketplace on search/catalog/resolve when you know the user's store; otherwise en-US requests get amazon.com and everything else amazon.se.

無需輸入參數。

search_gifts

Search birthday gifts

Search birthday gifts on the user's Amazon storefront. Pass marketplace=amazon.com for US shoppers (English search), amazon.se for Sweden. Returns search links plus hand-picked catalogMatches with /dp links. OpenAPI: searchAmazon.

輸入參數q必填limitlocaleageBandcountryoccasionmarketplacegiftCategory

get_catalog

Curated gift catalog

Paginated hand-picked birthday gifts with /dp buyUrls. marketplace=amazon.com returns the US catalog (English, USD or no price, tag sw-fodelsedag-20); amazon.se the Swedish one (tag sw-fodelsedag-21). OpenAPI: getCatalog.

輸入參數qlimitlocaleoffsetcountryoccasionmarketplacegiftCategorygiftCategories

resolve_product

Resolve buy link

Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl on amazon.com or amazon.se (tagged for both). Pass marketplace when known. OpenAPI: resolveProduct.

輸入參數urlasinlocalecountrykeywordsoccasionbudgetBandmarketplacegiftCategory

create_wishlist

Create wishlist

Create a birthday gift wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_wishlist_item. OpenAPI: createWishlist.

輸入參數itemslocaleageBandcountryoccasionbudgetBandmarketplacerecipientNamegiftCategories

create_and_fill

One-shot create and fill

One call: create a curated birthday gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a wishlist and add ASINs / keywords / search queries in one call. OpenAPI: agentCreateAndFill.

輸入參數localeageBandcountryoccasionitemAsinsbudgetBanditemQueriesmarketplaceitemKeywordsrecipientNamegiftCategories

get_wishlist

Get wishlist

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 wishlist. Requires editToken from create. OpenAPI: addWishlistItem.

輸入參數id必填urlasinnameemojititlecatalogIdeditToken必填searchKeywords

版本歷史

1
  1. v1.2.0最新Oct 26, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。

其他 Finder 整合