keepa-mcp

keepa-mcp

Keepa API を通じて、AI アシスタントに Amazon の価格と販売ランキングの履歴を提供します。

---

非公式パッケージです。 keepa-mcp は Keepa GmbH と提携、推奨、サポートされていません。 「Keepa」と「Amazon」は、それぞれの所有者の商標です。これは、一般公開されている Keepa API 用の独立したオープンソースクライアントです。

---

できること

ツール	説明	プロンプトの例
get_product	商品名、ブランド、カテゴリー、現在価格、購入ボックス、レビュー数、評価	「ASIN B08N5WRWNW の現在の Amazon 価格と評価を教えてください」
get_price_history	Amazon、新品、中古、購入ボックスの価格をデコードした時系列データ	「B08N5WRWNW の過去 1 年間の価格履歴を表示してください」
get_sales_rank_history	時系列の販売ランキングと需要トレンドの概要	「B07PXGQC1Q の需要は上昇傾向ですか、それとも下降傾向ですか？」
search_products	キーワードによる商品検索。一致する ASIN を返します	「Amazon で『wireless earbuds』の ASIN を探してください」
get_best_sellers	Keepa カテゴリー内の売れ筋 ASIN	「エレクトロニクスのベストセラーを教えてください」
get_deals	値下げ率と評価で絞り込んだ現在の値下げ商品	「30％以上オフで星 4.5 以上の商品を表示してください」

---

クイックスタート

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json （macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "keepa": {
      "command": "npx",
      "args": ["-y", "keepa-mcp"],
      "env": {
        "KEEPA_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Code

claude mcp add keepa -e KEEPA_API_KEY=your_key -- npx -y keepa-mcp

OpenAI Codex CLI

~/.codex/config.toml に追加します。

[mcp_servers.keepa]
command = "npx"
args = ["-y", "keepa-mcp"]

[mcp_servers.keepa.env]
KEEPA_API_KEY = "YOUR_API_KEY_HERE"

---

Keepa API キーの取得方法

https://keepa.com/#!api で登録して、API キーを取得してください。

無料プランでは、1 分あたり 100 トークンが提供されます。各商品データのリクエストで消費するトークン数は、取得するデータ（履歴の長さ、出品数など）に応じて変わります。一般的な商品検索では 1～5 トークン、ベストセラー一覧やセール情報の取得ではそれ以上のトークンを消費します。トークン消費量の一覧については、Keepa API ドキュメントをご覧ください。

トークン消費量の概要：

• get_product：約 2～4 トークン — 商品レコードに加えて、必要な stats、rating、buybox の追加データを取得します。これらがない場合、Keepa は現在価格、評価、レビュー数、出品数を返しません。
• get_price_history / get_sales_rank_history：約 2～4 トークン
• get_best_sellers：リクエストごとに 50～100 トークン
• get_deals：ページごとに 5～25 トークン
• 無料プランのトークンは、1 分あたり 100 トークン補充されます

リアルタイムの出品データ（offers）はリクエストしません。これをリクエストすると、マーケットプレイスへのリアルタイム照会が発生し、呼び出しごとに追加で 10 トークン以上を消費するため、トークン残高が少ない場合はリクエスト自体が失敗する可能性があります。0.1.2 より前のバージョンでは常に offers=20 を送信していたため、get_product の消費量は、この表で以前記載されていた 1 トークンではありませんでした。

上限に達した場合、ツールは明確なエラーメッセージを返します。トークンが補充された後に再試行してください。

---

会話の例

1. 商品調査

「B08N5WRWNW を調べてから、過去 6 か月間の価格履歴を表示し、需要が伸びているかどうか教えてください。」

アシスタントは get_product を呼び出し、続いて range="6m" を指定して get_price_history、さらに range="6m" を指定して get_sales_rank_history を呼び出し、結論をまとめます。

2. カテゴリーの販売機会を調査

「エレクトロニクス（カテゴリー 172282）のベストセラー上位 20 件を取得し、最初の 3 件について現在の詳細と販売ランキングのトレンドを調べてください。」

アシスタントは get_best_sellers を呼び出し、続いて最初の 3 件の ASIN について get_product と get_sales_rank_history を呼び出し、需要の兆候をまとめます。

3. お買い得商品を探す

「評価の高い Amazon のお買い得商品を、25％以上オフで探してください。その後、最上位の商品について価格履歴を表示し、本当に値下がりしているか確認してください。」

アシスタントは min_price_drop_pct=25、min_rating=45 を指定して get_deals を呼び出し、最上位の ASIN を選びます。次に range="6m" を指定して get_price_history を呼び出し、申告された値下がりを過去のデータと照合します。

---

開発

# Install dependencies
npm install

# Run tests (no live HTTP; all upstream calls are mocked)
npm test

# Build TypeScript to dist/
npm run build

# Start the server (requires KEEPA_API_KEY in environment)
KEEPA_API_KEY=your_key node dist/index.js

プロジェクト構成

src/
  index.ts                 # Server entry point, tool registration
  constants.ts             # API base URL, Keepa time offset, limits
  types.ts                 # TypeScript interfaces
  services/
    keepa-client.ts        # Fetch wrapper, time utilities, history decoder
  tools/
    get-product.ts
    get-price-history.ts
    get-sales-rank-history.ts
    search-products.ts
    get-best-sellers.ts
    get-deals.ts
tests/
  keepa-client.test.ts     # Unit tests for time conversion and history decoding
  tools.test.ts            # Integration tests with mocked fetch + fixture JSON
  fixtures/                # Realistic Keepa response shapes

---

開発元

Puya Ventures LLC が開発しています。商品リサーチ、E コマース、SaaS チーム向けに、カスタム MCP サーバーと AI 統合を構築しています。お問い合わせ： [email protected] | ポートフォリオ：puyarahmanian.com

Product-Research MCP Suite の一部です： keepa-mcp · google-trends-mcp · junglescout-mcp

---

プライバシー

このサーバーはお使いのマシン上だけで動作します。テレメトリを収集せず、データも保存しません。ネットワークへのリクエストは Keepa API（api.keepa.com）へのものだけで、API キーと、照会した ASIN、キーワード、またはカテゴリ ID を送信します。API キーは KEEPA_API_KEY 環境変数から読み込まれ、ディスクに書き込まれることも、Keepa 以外に送信されることもありません。Keepa のプライバシーポリシーをご覧ください：https://keepa.com/#!privacy

ライセンス

MIT。LICENSE をご覧ください。