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 服务器,让助手追踪亚马逊商品与价格:监控清单、价格历史、报价和提醒。

可以做什么
  • 搜索亚马逊,并通过 ASIN、链接或短链接把商品加入监控清单
  • 列出已追踪商品的最新状态与价格趋势,并读取商品的完整价格历史
  • 读取当前报价与卖家价格,查询任意 ASIN 在指定站点的价格历史
  • 立即触发一次检查,或修改目标价格、降价提醒、检查间隔与暂停状态
  • 删除商品及其价格历史,查看套餐、剩余额度和每月额度消耗
适用场景
适合希望让助手在对话中监控亚马逊价格、比较报价,或回答某商品价格历史与已追踪商品相关问题的场景。
运行要求
需要一个 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 集成