Amazon Ads MCP Server

Model Context Protocol (MCP) サーバーで、Amazon Advertising API と連携するためのツールを提供します。このサーバーにより、AI アシスタントは Amazon Ads のキャンペーン、キーワード、パフォーマンスデータなどにアクセスして管理できるようになります。

機能

この MCP サーバーは以下のツールを提供します:

• get_profiles: 利用可能なすべての Amazon Ads プロファイル/アカウントを一覧表示します

• get_campaigns: ステータスとタイプによるオプションのフィルタリングで広告キャンペーンを取得します

• get_campaign_performance: キャンペーンのパフォーマンス指標（インプレッション、クリック、コスト、売上）を取得します

• get_keywords: キャンペーンまたは広告グループのキーワードを取得します

• update_keyword_bid: 特定のキーワードの入札額を更新します

• create_campaign: 新しい広告キャンペーンを作成します

• get_product_ads: キャンペーンまたは広告グループの商品広告を取得します

Related MCP server: TikTok Ads MCP Server

前提条件

1. Amazon Ads アカウント: 有効な Amazon Ads アカウントが必要です

2. API 認証情報: Amazon Ads API アクセスに登録して以下を取得します:

   • Client ID

   • Client Secret

   • Refresh Token

Amazon Ads API 認証情報の取得

ステップ 1: アプリケーションの登録

1. Amazon Advertising API にアクセスします

2. Amazon Ads アカウントでサインインします

3. Developer Center に移動して新しいアプリケーションを作成します

4. Client ID と Client Secret が発行されます - これらを保存してください!

ステップ 2: Refresh Token の取得

OAuth フローを通じて refresh token を取得するためのヘルパースクリプトを提供しています:

1. プロジェクトのルートに .env ファイルを作成します:

   AMAZON_ADS_CLIENT_ID=your_client_id_here
   AMAZON_ADS_CLIENT_SECRET=your_client_secret_here

2. OAuth ヘルパースクリプトを実行します:

   npm run get-token

3. ブラウザで Amazon の認証ページが開きます

4. サインインしてアプリケーションを承認します

5. スクリプトに refresh token が表示されます - それを .env ファイルにコピーします

ステップ 3: リージョンの確認

広告リージョンを確認します:

• NA: 北米 (amazon.com)

• EU: ヨーロッパ (amazon.co.uk、amazon.de など)

• FE: 極東 (amazon.co.jp など)

インストール

1. このリポジトリをクローンします:

git clone <your-repo-url>
cd amazonads-mcp

2. 依存関係をインストールします:

npm install

3. プロジェクトをビルドします:

npm run build

設定

環境変数

.env ファイルを作成するか、以下の環境変数を設定します:

AMAZON_ADS_CLIENT_ID=your_client_id
AMAZON_ADS_CLIENT_SECRET=your_client_secret
AMAZON_ADS_REFRESH_TOKEN=your_refresh_token
AMAZON_ADS_REGION=NA  # Options: NA, EU, FE
AMAZON_ADS_SANDBOX=false  # Set to true for testing with sandbox API

Claude Desktop の設定

このサーバーを Claude Desktop の設定ファイルに追加します:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "amazonads": {
      "command": "node",
      "args": ["/absolute/path/to/amazonads-mcp/build/index.js"],
      "env": {
        "AMAZON_ADS_CLIENT_ID": "your_client_id",
        "AMAZON_ADS_CLIENT_SECRET": "your_client_secret",
        "AMAZON_ADS_REFRESH_TOKEN": "your_refresh_token",
        "AMAZON_ADS_REGION": "NA"
      }
    }
  }
}

使用例

Claude Desktop で設定すると、Claude に以下のような依頼ができます:

• 「Amazon Ads のキャンペーンをすべて表示して」

• 「キャンペーン ID 12345 の 1月1日から1月31日までのパフォーマンス指標は?」

• 「キャンペーン 12345 のすべてのキーワードを一覧表示して」

• 「キーワード 67890 の入札額を $1.50 に更新して」

• 「日予算 $50 の新しい Sponsored Products キャンペーンを作成して」

• 「キャンペーン 12345 のすべての商品広告を表示して」

開発

プロジェクト構成

amazonads-mcp/
├── src/
│   ├── index.ts              # Main MCP server implementation
│   └── amazon-ads-client.ts  # Amazon Ads API client
├── build/                     # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

ビルド

npm run build

開発モード

変更を監視して自動的に再ビルドします:

npm run watch

サーバーのテスト

サーバーを直接実行します:

npm start

サーバーは stdio 経由で通信し、MCP プロトコルメッセージを想定しています。

API 対応状況

このサーバーは現在以下をサポートしています:

• Sponsored Products: キャンペーン、キーワード、商品広告を完全サポート

• Sponsored Brands: キャンペーン管理（部分サポート）

• Sponsored Display: キャンペーン管理（部分サポート）

• Reporting: 基本的なパフォーマンス指標（簡易実装）

重要な注意事項

1. レート制限: Amazon Ads API にはレート制限があります。現在、クライアントはレート制限のロジックを実装していません。

2. レポーティング API: get_campaign_performance ツールは簡易実装を使用しています。本番環境では、完全な非同期レポートフローを実装する必要があります:

   • レポートリクエストの作成

   • レポート完了のポーリング

   • レポートのダウンロードと解析

3. エラーハンドリング: API エラーは呼び出し元に返されます。認証エラーを避けるために、認証情報が正しく設定されていることを確認してください。

4. リージョン: Amazon Ads アカウントに基づいて正しいリージョン（NA、EU、FE）を設定してください。

セキュリティ

• .env ファイルをコミットしたり、API 認証情報を公開したりしないでください

• Refresh token は安全に保管してください

• 本番環境では認証情報のローテーションの実装を検討してください

リソース

• Amazon Ads API ドキュメント

• Model Context Protocol ドキュメント

• MCP TypeScript SDK

ライセンス

MIT

コントリビューション

コントリビューションを歓迎します! お気軽に Pull Request を送ってください。