Asin

Asin MCP サーバー

Asin の Amazon 価格追跡 API 用の公式 Model Context Protocol サーバーです。

スケジュール設定されたウォッチリスト、価格履歴、オファー、アラートを使って、Amazon の価格や商品を追跡できます。

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 分に 1 回まで利用でき、それより早い呼び出しでは商品は変更されません。一時停止中の商品は、先に再開する必要があります。チェックはバックグラウンドで実行されます。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（およびマーケットプレイス）で絞り込むと商品が追跡中かどうかを確認でき、filter を使うと同じリストを取得できます…
search_amazon	商品の ASIN を見つけるための Amazon 検索結果（スポンサー商品を含め最大 60 件）を表示します。無料で、1 時間あたり 30 回まで検索できます。
track_product	ASIN、Amazon のリンク、または短縮リンク（amzn.to、a.co…）をウォッチリストに追加します。最初のチェックは数秒以内にバックグラウンドで実行されます（完了するまで checking は true）。GET /products/{id} をポーリングするか、… を送信してください
update_product	目標価格、値下がりアラート、チェック間隔、一時停止を設定します。変更する項目だけを送信してください。

API を呼び出すツールはすべてクレジットを消費します。JSON の結果はテキストとして返され、画像はインラインで、その他のファイル（PDF など）は最大 4 MB の埋め込みリソースとして返されます。

ストリーミング可能な 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 を参照してください。