Asin

Asin MCP 服务

面向 Asin 亚马逊价格跟踪 API 的官方 Model Context Protocol 服务。

通过定时监控清单、价格历史、优惠和提醒，跟踪亚马逊价格和商品。

它让 Claude、Cursor、VS Code、Windsurf 和任何 MCP 客户端都能将 API 作为工具调用。通过 stdio（本地）或 Streamable HTTP（可自托管）运行。

要求

• Node.js 20 或更高版本
• 一个 Asin API 密钥 — 注册，然后从控制台复制密钥

托管服务（推荐）

Asin 会为你运行此服务，地址为 https://www.asin.dev/api/mcp（Streamable HTTP）。在 Authorization 标头中以 Bearer 令牌的形式发送 API 密钥；无需安装。

claude mcp add --transport http asin https://www.asin.dev/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "asin": {
      "url": "https://www.asin.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

托管服务和此软件包提供相同的 API；如果你需要使用 stdio、自定义网络出口或自行托管，请在本地运行此软件包。

在本地运行

Claude Code

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

Claude Desktop、Cursor、Windsurf 和其他客户端

将服务添加到客户端的 MCP 配置中（claude_desktop_config.json、.cursor/mcp.json……）：

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

VS Code

{
  "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 扩展

从发布页面下载 .mcpb 捆绑包并打开；Claude Desktop 会提示你输入 API 密钥。

Docker

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

工具

工具	描述
check_product	立即请求检查（1 个额度），每 5 分钟最多一次；提前调用会返回未更改的商品。暂停的商品必须先恢复。检查在后台运行；使用 wait=t…
delete_product	删除商品及其价格历史。
fetch_offers	读取 Amazon 上的报价，消耗 1 个额度；如果没有返回结果则退还额度。过去 3 小时内任何人读取过的报价会直接返回，不收费（charged: false）。返回结果与 GET /offe… 相同
get_account	查看你的套餐、剩余额度（月度额度和额度包）、跟踪的商品数量及这些商品每月消耗的额度。
get_asin_history	查看某个市场中某个 ASIN 在此期间的所有已读取价格（不论由谁跟踪），按时间从早到晚排列，并显示这些价格中的最低价、最高价和平均价。超过 5000 个点的历史记录会进行精简…
get_offers	查看最后一次读取时哪些商家在售以及售价，按价格从低到高排列，并显示 Amazon 自营价格以及最低的新货和二手报价（只有 Amazon 自营店的二手报价才可知）。免费：此前从未读取过…
get_product	查看商品的最新状态以及此期间读取的每个价格，按时间从早到晚排列。历史记录包含此市场中该 ASIN 的所有读取记录，包括你添加商品之前的记录，因此商品添加…
list_products	查看你的关注列表，按添加时间从新到旧排列，并显示每件商品的最新状态和近期价格（趋势）。使用 asin（及 marketplace）筛选可确认商品是否在跟踪中，或使用 filter 获取相同列表…
search_amazon	Amazon 搜索结果（最多 60 条，包含赞助结果），用于查找商品的 ASIN。免费，每小时最多搜索 30 次。
track_product	将 ASIN、Amazon 链接或短链接（amzn.to、a.co…）添加到你的关注列表。首次检查会在几秒内于后台运行（在此之前 checking 为 true）：轮询 GET /products/{id}，或发送…
update_product	设置目标价格、降价提醒、检查间隔或暂停状态。只发送需要更改的内容。

每个调用 API 的工具都会消耗额度。JSON 结果以文本形式返回；图片会内嵌返回，其他文件（PDF…）则作为嵌入资源返回，最大 4 MB。

Streamable HTTP

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

端点为 POST /mcp（无状态，返回 JSON）。每个客户端都在 x-api-key 请求头（或 Authorization: Bearer <key>）中发送自己的密钥；服务端不会使用自己的密钥。默认绑定到 127.0.0.1，并拒绝浏览器来源，除非你允许它们——对外开放前，请在其前面配置 TLS。

createHttpHandler() 已导出，可用于兼容 Fetch 的运行时（Cloudflare Workers、Deno、Bun）：

import { createHttpHandler } from "@asindev/mcp";

export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

安全

• API 密钥从 ASIN_API_KEY（stdio）或请求头（HTTP）中读取，并会从错误消息中移除。
• 从网站获取的内容不可信：服务说明会告知模型将其视为数据，而非指令。
• 请参阅 SECURITY.md 报告漏洞。

开发

npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js

基于 SDK 构建

该服务使用官方 Node.js SDK（@asindev/sdk）。

所有 Asin SDK

SDK	包	安装
Node.js	@asindev/sdk	npm install @asindev/sdk
Python	asindotdev	pip install asindotdev
Go	asin-go	go get github.com/asindotdev/asin-go
.NET	Asin	dotnet add package Asin
Ruby	asindotdev	gem install asindotdev
PHP	asindotdev/sdk	composer require asindotdev/sdk
Java	asin-java	从源代码构建，参见其 README
CLI	@asindev/cli	npm install -g @asindev/cli
MCP 服务	@asindev/mcp	npx -y @asindev/mcp

许可证

MIT — 参见 LICENSE。