Asin

dev.asin由 asin.dev 發布官方發布者v0.1.0更新於 Nov 7, 2026

Track Amazon prices and products with a scheduled watchlist, price history, offers and alerts.

已驗證Streamable HTTP可網頁執行資料與分析商業與電商

概覽

AI 產生的概覽

Asin 官方 MCP 伺服器,讓助理追蹤 Amazon 商品與價格:監控清單、價格歷史、報價與提醒。

可以做什麼
  • 搜尋 Amazon,並透過 ASIN、連結或短連結把商品加入監控清單
  • 列出已追蹤商品的最新狀態與價格趨勢,並讀取商品的完整價格歷史
  • 讀取目前報價與賣家價格,查詢任一 ASIN 在指定站點的價格歷史
  • 立即觸發一次檢查,或修改目標價格、降價提醒、檢查間隔與暫停狀態
  • 刪除商品及其價格歷史,查看方案、剩餘額度與每月額度用量
適用情境
適合想讓助理在對話中監控 Amazon 價格、比較報價,或回答某商品價格歷史與已追蹤商品相關問題的情境。
執行需求
需要 Asin API 金鑰:託管端點透過 Authorization 標頭以 Bearer 方式傳送,本機 stdio 套件則以環境變數 ASIN_API_KEY 設定。本機套件需要 Node.js 20 或更新版本,也支援 Docker。需要能連線至 Asin API 的網路。
安裝前請注意
所有呼叫 API 的工具都會消耗額度,部分操作(立即檢查、讀取報價)按次計費;刪除商品會一併刪除其價格歷史。API 金鑰屬於機密,請勿寫入共用設定。自架的 HTTP 服務在對外開放前應置於 TLS 之後。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Asin,將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "asin": {
      "type": "http",
      "url": "https://www.asin.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Asin MCP Server

Official Model Context Protocol server for the Asin Amazon price tracking API.

Track Amazon prices and products with a scheduled watchlist, price history, offers and alerts.

It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).

Requirements

  • Node.js 20 or newer
  • a Asin API key — sign up, then copy it from the dashboard

Hosted server (recommended)

Asin runs this server for you at https://www.asin.dev/api/mcp (Streamable HTTP). Send your API key as a Bearer token in the Authorization header; nothing to install.

sh
claude mcp add --transport http asin https://www.asin.dev/api/mcp --header "Authorization: Bearer YOUR_API_KEY"
json
{  "mcpServers": {    "asin": {      "url": "https://www.asin.dev/api/mcp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}

The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.

Run it locally

Claude Code

sh
claude mcp add asin --env ASIN_API_KEY=YOUR_API_KEY -- npx -y @asindev/mcp

Claude Desktop, Cursor, Windsurf and other clients

Add the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):

json
{  "mcpServers": {    "asin": {      "command": "npx",      "args": ["-y", "@asindev/mcp"],      "env": {        "ASIN_API_KEY": "YOUR_API_KEY"      }    }  }}

VS Code

json
{  "servers": {    "asin": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@asindev/mcp"],      "env": {        "ASIN_API_KEY": "${input:asin-api-key}"      }    }  },  "inputs": [    {      "type": "promptString",      "id": "asin-api-key",      "description": "Asin API key",      "password": true    }  ]}

Claude Desktop extension

Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.

Docker

sh
docker build -t asin-mcp .docker run -i --rm -e ASIN_API_KEY=YOUR_API_KEY asin-mcp

Tools

ToolDescription
check_productAsks for a check right away (1 credit), at most once per 5 minutes; earlier calls return the product unchanged. A paused product has to be resumed first. The check runs in the background; with wait=t…
delete_productRemoves the product and its price history.
fetch_offersReads the offers on Amazon for 1 credit, refunded if it doesn't answer. A read made in the last 3 hours, by anyone, is returned instead, for free (charged: false). The answer is the same as GET /offe…
get_accountYour plan, the credits left (monthly allowance and packs), how many products you track and the credits they use per month.
get_asin_historyEvery price Asin read for an ASIN on a marketplace over the period, whoever tracks it, oldest first, with the lowest, highest and average of those prices. A history of more than 5000 points is thinne…
get_offersWho sells the product and at what price, as last read, cheapest first, with Amazon's own price and the cheapest new and used offers (used is only known for Amazon's own outlet). Free: this never read…
get_productThe product's latest state and every price read of the period, oldest first. The history covers every read of this ASIN on this marketplace, including those made before you added it, so a product add…
list_productsYour watchlist, newest first, with each product's latest state and its recent prices (trend). Filter with asin (and marketplace) to know if a product is tracked, or with filter to get the same lists…
search_amazonAmazon search results (up to 60, sponsored included), to find the ASIN of a product. Free, limited to 30 searches per hour.
track_productAdds an ASIN, an Amazon link or a short link (amzn.to, a.co…) to your watchlist. The first check runs in the background within seconds (checking is true until then): poll GET /products/{id}, or send…
update_productTarget price, drop alerts, check interval, or pause. Send only what changes.

Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.

Streamable HTTP

sh
npx @asindev/mcp --http --port 3000

The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.

createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):

ts
import { createHttpHandler } from "@asindev/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

Security

  • The API key is read from ASIN_API_KEY (stdio) or the request headers (HTTP) and removed from error messages.
  • Content fetched from websites is untrusted: the server instructions tell the model to treat it as data, not instructions.
  • See SECURITY.md to report a vulnerability.

Development

sh
npm installnpm testnpm run buildnpx @modelcontextprotocol/inspector node dist/stdio.js

Built on the SDK

The server uses the official Node.js SDK (@asindev/sdk).

All Asin SDKs

SDKPackageInstall
Node.js@asindev/sdknpm install @asindev/sdk
Pythonasindotdevpip install asindotdev
Goasin-gogo get github.com/asindotdev/asin-go
.NETAsindotnet add package Asin
Rubyasindotdevgem install asindotdev
PHPasindotdev/sdkcomposer require asindotdev/sdk
Javaasin-javabuild from source, see its README
CLI@asindev/clinpm install -g @asindev/cli
MCP server@asindev/mcpnpx -y @asindev/mcp

License

MIT — see LICENSE.

來源:README.md,提交 d28f901

工具

0
該伺服器需要 API 金鑰等憑證,因此 SourceWeft 無法在沒有憑證的情況下讀取其工具,也未收錄。

版本歷史

1
  1. v0.1.0最新Nov 7, 2026

評分

已滿足適用檢查項的 85%

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

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

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Asin 整合