amazon-creators

Amazon Creators API MCP - チャットからすぐ貼り付けられるアフィリエイト商品カード

商品をまとめた記事を書いているなら、面倒な作業はもうおなじみでしょう。Amazonで商品を見つけ、画像をコピーし、価格を調べ、アフィリエイトリンクを貼り付け、記事を読んでもらう頃に価格が変わっていないことを願う。そして、次の9商品でも同じことを繰り返します。

このサーバーが、その作業を代わりに行います。Claudeに商品を探すよう頼むと、Amazonの最新カタログを検索し、完成済みのHTMLカードを返します。画像、価格、割引額、星評価、Associatesタグをあらかじめ含めたリンク、そしてAmazonが求める開示文までそろっています。WordPress、Ghost、Substackなど、使っているサービスに貼り付けるだけです。Claude Desktopなら、コピーする前にカードの表示も確認できます。

Amazon Creators APIを基盤にしています。これは、Amazonが2026年5月15日に旧エンドポイントを廃止した際、Product Advertising API 5.0に代わって導入されたREST APIです。ワークフローがまだPA-APIを参照しているなら、そのエンドポイントはもうずっと前から使えません。再び使えるようにする方法がこれです。

「これらをグリッドにして」と頼むだけで、スタイルをインライン化し、すべてのリンクにタグを付け、下部に開示文を配置した状態で仕上がります。貼り付けたら、次に進みましょう。

クイックナビゲーション

対象ユーザー · 実際の使い方 · APIキーの取得 · インストール · 環境変数 · ツール · 出力形式 · スタイル設定 · Associatesのコンプライアンス · トラブルシューティング

---

対象ユーザー

• アフィリエイトブロガーやニッチサイトの運営者：商品まとめ記事や「用途別おすすめX」の記事をよく書き、商品埋め込みを手作業ではなく数秒で済ませたい方。
• コンテンツチームやSEOチーム：開発者に毎回APIを接続してもらわずに、多数の記事で一貫したブランドイメージの商品カードを使いたい方。
• ニュースレターの執筆者：Substack、Ghost、beehiivで、記事にそのまま追加できるきれいなHTMLを使いたい方。
• PA-API 5.0から移行する方：旧エンドポイントが廃止された今、すぐに使える代替手段が必要な方。

使うためにAPIの知識は必要ありません。ClaudeにMCPサーバーを追加し、Associatesのキーを一度貼り付ければ準備完了です。重要なポイントは、利用資格を満たすAssociatesアカウントを持っていることです。

---

実際の使い方

これはフォームではなく、会話を中心に作られています。記事のテーマを説明すると、Claudeが検索して要約し、埋め込みを頼んだときにだけHTMLを出力します。使い方の流れは次のとおりです。

1. 投稿用の商品を探す

「500ポンド未満で最高のダイレクトドライブ式レーシングホイールを探してください」

Claude が search_items を実行し、HTML ではなくシンプルな概要を返します。

500ポンド未満のダイレクトドライブ式ホイールが8件見つかりました。おすすめはこちらです： • Fanatec CSL DD（349ポンド） - レビュー評価が高く、5 Nmモーターを搭載 • Moza R5 Bundle（469ポンド） - ペダル付き、5.5 Nm • Cammus C5（399ポンド） - コンパクト これらを埋め込み可能なグリッドにまとめましょうか？

2. カードまたはグリッドを作成する

「はい、上位3件のグリッドを作ってください」

今度は format: 'html-grid' に切り替わり、完全なHTMLドキュメントを返します。画像、価格、割引額、評価、タグ、「as of」タイムスタンプ、開示事項のフッター。すべてそろっています。貼り付ければ完了です。

3. レート制限を消費せずにスタイルを変更する

ここが役立つポイントです。Creators API には実際のレート制限があるため（最初はおよそ1秒に1リクエストで、売上が増えるにつれて上限も上がります）、色を変えたくなるたびに Amazon に再問い合わせするのは避けたいところです。その必要はありません。Claude は前回の呼び出しで取得したデータを保持し、ローカルで再レンダリングします。

「同じグリッドで、カードはダークカラー、ボタンはホットピンクにしてください」

{
  "response": { "searchResult": { "items": [ /* from the previous call */ ] } },
  "format": "html-grid",
  "customStyles": ".amzn-card{background:#0f172a;color:#f1f5f9} .amzn-card__cta{background:hotpink;color:#111}"
}

スタイルを20回変更しても、追加のAPI呼び出しはゼロです。見た目は好きなだけ調整できます。

4. 特定のASINを検索する

「B09B2SBHQK、B08N5M7S6K、B0BZC6YR7Qの現在の詳細を調べてください」

Claude が get_items を呼び出し、3件の概要をまとめます。知っておきたい点が1つあります。API は指定した順番で商品を返すとは限らず、見つからないASINは通知なく除外されます（それらは別の errors 配列に入ります）。Claude は asin フィールドを使って照合するため、自分で気にする必要はありません。

5. 色とサイズのバリエーションを一覧表示する

「Echo Show 5にはどんな色がありますか？」

これには get_variations を使います。親ASINの商品バリエーションを一覧表示し、それぞれの価格も確認できます。

---

APIキーを取得する

ここでつまずく人が多いので、率直にお伝えします。Creators API は誰でも利用できるわけではなく、審査があります。 午後いっぱい時間をかけて取り組む前に、知っておく価値があります。

事前に必要なもの

• 対象とするマーケットプレイスで承認済みの Amazon Associates アカウント（.com のアカウントでは .co.uk に接続できません。認証情報は地域に紐付けられています）。
• 直近30日間で、条件を満たした発送済みの売上が少なくとも10件あること。 ここでつまずく人が多くいます。ローリング30日間のどの期間でも売上が10件を下回ると、基準を再び超えるまでアクセスが停止されます。新しいアカウントや活動が少ないアカウントは、まだAPIにアクセスできません。
• アカウントのメインユーザーである必要があります。 Associates アカウントのサブユーザーは Creators API のページを表示したり、キーを生成したりできません。私の経験では、これが何よりもチームを困らせています。
• MCP を実行するマシンに Node.js 20 以降がインストールされていること。

認証情報の作成場所

Associates Centralにサインインし、Toolsメニューを開いてCreators APIを選択します。または、affiliate-program.amazon.com/creatorsapiに直接アクセスします。手順は3つです。

1. Creators API アプリケーションを作成する

2. 名前を付けて、リージョンを選択する

ここで選択するリージョンによって、AMAZON_CREDENTIAL_VERSION（NA = 3.1、EU = 3.2、FE = 3.3。全一覧は下記を参照）が決まります。実際に記事を書くマーケットプレイスに合ったリージョンを選択してください。

3. Credential ID と Secret をコピーする

Amazon によって Login with Amazon（v3.x）の認証情報ペアが生成されます。両方をコピーしてください。ID は AMAZON_CLIENT_ID に、Secret は AMAZON_CLIENT_SECRET に設定します。これらがご自身のマシンの外に出ることはありません。MCP サーバーは Amazon と直接通信するため、Houtini やその他の第三者に送信されることはありません。

古い v2.x 認証情報について： 2026年初頭より前にアプリを設定した場合、v2.x の Cognito 認証情報が残っている可能性があります。これらはここでは使えません。新しい Login with Amazon アプリケーションを作成して v3.x キーを取得してください。サーバーは起動時に認証情報をチェックし、v2.x の場合はそのことを明確に示すメッセージを表示して起動を拒否するため、原因が分からず困ることはありません。

---

インストール

利用するために何かをクローンする必要はありません。npx が公開済みパッケージを取得します。必要なのは、5つの環境変数を用意することだけです。

Claude Desktop

設定ファイルを開きます。

• Windows： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "amazon-creators": {
      "command": "npx",
      "args": ["-y", "@houtini/amazon-creators-mcp"],
      "env": {
        "AMAZON_CLIENT_ID": "amzn1.application-oa2-client.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "AMAZON_CLIENT_SECRET": "amzn1.oa2-cs.v1.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "AMAZON_PARTNER_TAG": "yourtag-20",
        "AMAZON_CREDENTIAL_VERSION": "3.1",
        "AMAZON_MARKETPLACE": "www.amazon.com"
      }
    }
  }
}

Claude Desktop を再起動して、*「Amazon で［書いている内容］を探して」*と伝えれば、すぐに使えます。

Claude Code（CLI）

claude mcp add \
  -e AMAZON_CLIENT_ID=amzn1.application-oa2-client.xxx \
  -e AMAZON_CLIENT_SECRET=amzn1.oa2-cs.v1.xxx \
  -e AMAZON_PARTNER_TAG=yourtag-20 \
  -e AMAZON_CREDENTIAL_VERSION=3.1 \
  -e AMAZON_MARKETPLACE=www.amazon.com \
  -s user amazon-creators -- npx -y @houtini/amazon-creators-mcp

claude mcp get amazon-creatorsを実行して、正しく追加されたことを確認します。Status: Connectedと表示されていれば接続済みです。

---

環境変数

変数	必須	例	備考
AMAZON_CLIENT_ID	はい	amzn1.application-oa2-client.…	Creators API アプリの「Credential Id」
AMAZON_CLIENT_SECRET	はい	amzn1.oa2-cs.v1.…	同じ場所にある「Secret」
AMAZON_PARTNER_TAG	はい	yourtag-20	Associates のトラッキング ID
AMAZON_CREDENTIAL_VERSION	はい	3.1 / 3.2 / 3.3	リージョン固有の値です。下の表を参照してください
AMAZON_MARKETPLACE	はい	www.amazon.com	マーケットプレイスの完全なホスト名
AMAZON_MAX_CONCURRENCY	いいえ	4	同時に処理するリクエストの最大数。デフォルトは 4 です。
DEBUG	いいえ	1	詳細な stderr ログを有効にします。デフォルトでは無効です。

リージョンごとの認証情報バージョン

認証情報は1つのリージョンに紐づいており、そのリージョン外のマーケットプレイスを呼び出すと認証に失敗します。そのため、サーバーは起動時にこれらを照合し、リクエストの途中で問題が発覚する前に停止します。

リージョン	バージョン	マーケットプレイス
NA	3.1	www.amazon.com、www.amazon.ca、www.amazon.com.mx、www.amazon.com.br
EU	3.2	www.amazon.co.uk、www.amazon.de、www.amazon.fr、www.amazon.it、www.amazon.es、www.amazon.nl、www.amazon.com.be、www.amazon.eg、www.amazon.in、www.amazon.ie、www.amazon.pl、www.amazon.sa、www.amazon.se、www.amazon.com.tr、www.amazon.ae
FE	3.3	www.amazon.co.jp、www.amazon.sg、www.amazon.com.au

---

ツール

ツール	入力	内容
search_items	keywords / actor / author / brand / title + フィルター	カタログを検索します。1ページあたり最大10件です。itemPage を使ってページを切り替えてください。
get_items	asins: string[]（1～10件）	指定した ASIN を検索します。結果は、送信した順序ではなく asin で照合してください。
get_variations	asin: string	親 ASIN のサイズ／カラー違いの子商品を取得します。
get_browse_nodes	browseNodeIds: string[]	カテゴリのメタデータと親カテゴリの階層を取得します。json / markdown のみです。
format_items	直前の呼び出しで取得した response または items[]	取得済みのデータを再レンダリングします。Amazon にはアクセスしません。 無料でスタイルを変更する方法です。

Amazon にアクセスする4つのツールは、すべて次の項目を受け取ります。

• format - 'json' | 'markdown' | 'html-card' | 'html-grid' | 'html-deals'（デフォルトは markdown。get_browse_nodes は json | markdown のみ）
• resources - 取得するフィールドを camelCase のパスで指定します（itemInfo.title、offersV2.listings.price など）。省略すると、適切なデフォルトのフィールドセットが使われます。
• customStyles - HTML のレンダリング時に、組み込みスタイルシートへ追加する CSS です。html-deals の場合は、行より前に独立した <style> ブロックとして追加されるため、スタイルシート全体を読み込まずにサイト独自のスタイルを調整できます。
• titleMaxChars - レンダリングするタイトルの最大文字数です（デフォルトは 80）。Amazon のタイトルはキーワードが詰め込まれて150文字を超えることも多いため、80文字ならカード内に1行で収まります。0 にすると制限がなくなります。Markdown と JSON では常にタイトル全体が出力されます。
• hideItemsWithoutPrice - html-grid で価格のない商品を除外します（デフォルトは true）。価格のないカードは、クリックするきっかけもなく、埋め込みとして効果的ではありません。商品を必ず表示する比較表を作成する場合は false に設定してください。

---

ツールではなく、サイトに合わせたセール商品行

以下の形式はどれも、カードらしい見た目のカードを生成します。単独で埋め込む場合には適していますが、サイト独自のスタイルがすでに設定された記事に追加すると、記事の途中に別のデザインが入り込んでしまうため適しません。

html-deals は、構造用のマークアップを出力します。商品ごとに1つの .amazon-deal-row を .amazon-deals-section で囲みます。テーマですでにこれらのクラスを定義していれば、出力はそのスタイルを継承し、追加のスタイル調整は不要です。定義されていない場合は、format_items を includeCss: true で再実行すると、適切なデフォルトスタイルが適用されます。

Find me three burr coffee grinders and give me deal rows for the post

各行の高さは70pxに固定されているため、商品が10件あっても、画面を何度もスクロールするのではなく、一覧として見渡せます。同じ理由から、特徴の箇条書きはデフォルトでオフになっています。表示する場合は format_items に featureCount を設定し、スペースを確保するため、独自 CSS で行の max-height を解除してください。行の上にタイトルを付けたい場合は、format_items に heading（「見出しに『2026年のおすすめ商品』を追加」）を渡すと、<h3 class="amazon-deals-header"> が生成されます。

出力されないものが2つあります。

• Prime バッジ。 Creators API のレスポンスには、商品が Prime 対象かどうかの情報がないため、購入先になる可能性のあるページに配送の約束をでっち上げて表示することはできません。
• 空の星評価。 レビュー情報はアソシエイトアカウントごとに取得制限があります。Amazon から情報が返されない場合、評価をゼロとして表示するのではなく、評価の行自体が省略されます。

星評価について

customerReviews.starRating と customerReviews.count はすべての呼び出しでリクエストされますが、Amazon がこれらを返すのは、そのデータを利用できるアカウントに限られます。行に星評価が表示されない場合、原因はツールではなくアカウントにあります。フィールドは正しくリクエストされており、フォーマッターは数値をでっち上げずに表示を調整します。

---

出力形式

• markdown - 画像、リンク付きタイトル、価格、免責事項です。ブログエディターにそのまま貼り付けられます。タイトルは省略されません。
• html-deals - サイトの CSS を引き継ぐ構造化された商品行です。上記を参照してください。記事にはこちらを使用してください。
• html-card - スタイルがインラインで記述された、自己完結型の <article class="amzn-card"> です。タイトルは titleMaxChars で指定した文字数に制限されます。価格がない場合は、カードからクリックできる場所がなくならないよう、目立たない「Amazonで価格を確認」リンクが表示されます。
• html-grid - 検索結果やリスト向けの、これらのカードのレスポンシブグリッドです。価格のない商品はデフォルトで除外されます。
• json - パース済みのレスポンスを整形して表示します。Amazon が実際に返した内容を確認したいときに使います。

HTML をまったく扱いたくない場合は、markdown が最も手軽です。これを指定すると、投稿にそのまま貼り付けられる次の形式が得られます。

[![Fanatec CSL DD Direct Drive Wheel Base (5 Nm)](https://m.media-amazon.com/images/…jpg)](https://www.amazon.com/dp/B0EXAMPLE01?tag=yourtag-20)
**[Fanatec CSL DD Direct Drive Wheel Base (5 Nm)](https://www.amazon.com/dp/B0EXAMPLE01?tag=yourtag-20)**
Brand: Fanatec · 4.7★ (1,284 reviews)
**£349.95** — save £40.00 (10% off) _(as of 20 Jul 2026, 15:24 UTC)_
ASIN: `B0EXAMPLE01`

> *As an Amazon Associate we earn from qualifying purchases. Prices and availability are accurate as of the time shown and are subject to change.*

Claude Desktop では、公式の MCP Apps プロトコルを使ってカードがコピー前にインライン表示されます。サンドボックス内のプレビューなので、内容を確認せずに貼り付けることはありません。プレビューには Copy HTML ボタンがあり、埋め込み可能な部分だけをコピーします。つまり、html-deals の断片はそのまま、カードやグリッドの場合は <!doctype>／<html> のラッパーを除いた <style> と本文のマークアップだけをコピーします。まだ MCP Apps に対応していないホストでも、HTML はプレーンテキストとして表示されるため、結局貼り付けるものをそのまま取得できます。何も失われません。

---

カードのスタイル設定

カード内の表示要素にはそれぞれ安定したクラスフックがあるため、コードに触れることなく、会話を通じてカード全体のスタイルを変更できます。

.amzn-card                    .amzn-card__image              .amzn-card__title
.amzn-card__meta              .amzn-card__brand              .amzn-card__rating
.amzn-card__price             .amzn-card__price--unavailable .amzn-card__savings
.amzn-card__cta               .amzn-card__disclosure         .amzn-grid

たとえば、次のように指定できます。

「CTA をホットピンクにして、カードを角丸のダークな長方形にしてください。」

{
  "keywords": "coffee grinder",
  "format": "html-card",
  "customStyles": ".amzn-card{background:#0f172a;color:#f1f5f9;border-radius:20px} .amzn-card__cta{background:hotpink;color:#111}"
}

customStyles はデフォルトのスタイルシートの後に追加されるため、ルールの優先順位で指定したスタイルが適用されます。サイトの見た目に合わせて一度調整すれば、以降のすべての表示で同じ CSS を再利用できます。

---

アソシエイト・プログラムの遵守

Amazon の商品データを表示する際にはルールがあり、違反すると責任を問われるのはあなたのアカウントです。そのため、サーバーは面倒でも重要な項目をあらかじめ組み込んでいます。

• AMAZON_PARTNER_TAG はすべての外部リンクに付与されます。Amazon が返すタグ付きの detailPageURL があればそれを優先し、必要に応じて /dp/ASIN?tag=… リンクにフォールバックします。
• すべてのリンクに rel="nofollow sponsored noopener" が設定されます。
• 価格を表示するときは、取得時刻（as of <timestamp>）も表示されます。
• すべてのカードとグリッドの末尾にアソシエイト・プログラムの免責事項が表示されます。

これらはアソシエイト・プログラム運営契約で義務付けられているため、覚えておく必要がないよう自動で適用されます。

---

開発

git clone https://github.com/houtini-ai/amazon-creators-api-mcp
cd amazon-creators-api-mcp
npm install
npm run build

コマンド	内容
npm run build	すべてをビルドします（ビューアーバンドル＋TypeScript）
npm run build:viewer	MCP Apps ビューアーの HTML バンドルのみをビルドします
npm run dev	サーバーの TypeScript をウォッチモードで実行します
npm run test	vitest（ユニットテストと統合テスト、計 103 件）
npm run typecheck	型チェックのみを行い、出力は生成しません
npm run lint	ESLint

有効な認証情報があれば、npx tsx scripts/smoke-auth.ts を実行すると、実際のトークン取得と searchItems の呼び出しが行われます。キーが一連の処理で正しく機能するかを手早く確認できます。

アーキテクチャと把握しておくべき API の注意点については、SCOPE.md を参照してください。

---

トラブルシューティング

起動時に「Credential version rejected」と表示される - v2.x の Cognito 認証情報を使用しています。Associates Central → Creators API で新しい Login with Amazon アプリを作成し、AMAZON_CREDENTIAL_VERSION にお使いのリージョンに応じて 3.1、3.2、または 3.3 を設定してください。

401 または 403 エラーが発生する - 通常、原因は次のいずれかです。過去 30 日間に条件を満たす売上が 10 件ないか、アカウントで Creators API へのアクセスがまだ有効になっていません。どちらも Associates Central で確認できます。

起動時にリージョンの不一致エラーが発生する - 認証情報のバージョンとマーケットプレイスのリージョンが異なります（たとえば、3.1 の NA キーを www.amazon.co.uk に対して使用している場合です）。呼び出すマーケットプレイスと同じリージョンで発行された認証情報を使用してください。

プレビュー画像が Claude Desktop に表示されない - ビューアーで許可されているのは、Amazon 独自の画像 CDN のみです。ポリシーがより厳しいホストではプレビュー画像が読み込まれない場合がありますが、プレーンな HTML 出力には問題ありません。サイトに貼り付けると表示されます。

「項目が間違った順序で返される」 - これは想定どおりです。get_items は項目を任意の順序で返すことがあり、見つからない ASIN は別の errors 配列に格納します。asin フィールドで照合してください。要約時には Claude がこれを行います。

---

ライセンス

MIT。詳細は LICENSE をご覧ください。

---

Model Context Protocol コミュニティ向けに Houtini が開発しました。houtini-ai MCP スイートの一部です。