skill-amazon-ads

Amazon Ads API スキル

OpenClaw エージェントから Amazon スポンサープロダクトキャンペーンを管理します。プロファイルの一覧表示、キャンペーンの確認、予算のチェック、パフォーマンスデータの取得ができます。

---

セットアップ

1. 認証情報ファイルを作成する

{
  "lwaClientId": "amzn1.application-oa2-client.YOUR_CLIENT_ID",
  "lwaClientSecret": "YOUR_CLIENT_SECRET",
  "refreshToken": "Atzr|YOUR_REFRESH_TOKEN",
  "profileId": "YOUR_ADS_PROFILE_ID",
  "region": "eu"
}

amazon-ads-api.json として保存します。AMAZON_ADS_PATH 環境変数を設定してファイルのパスを指定してください（デフォルト：./amazon-ads-api.json）。

リージョンとエンドポイント：

• na → advertising-api.amazon.com
• eu → advertising-api-eu.amazon.com
• fe → advertising-api-fe.amazon.com

2. Profile ID を取得する

node scripts/ads.js --profiles

ブランド／マーケットプレイスの profileId をコピーし、認証情報ファイルに追加します。

---

スクリプト

ads.js — キャンペーンと概要

node scripts/ads.js --profiles                # list all advertiser profiles
node scripts/ads.js --campaigns               # list all SP campaigns
node scripts/ads.js --summary                 # active campaigns + budgets summary
node scripts/ads.js --campaigns --out c.json  # save to file

---

認証情報のスキーマ

フィールド	説明
lwaClientId	広告アプリのクライアント ID（SP-API とは別）
lwaClientSecret	広告アプリのクライアントシークレット
refreshToken	LWA リフレッシュトークン
profileId	広告プロファイル ID（--profiles から取得）
region	na、eu、または fe

---

注意事項

• Ads API では SP-API とは別の LWA アプリを使用します。クライアント ID／シークレットも異なります。
• すべてのキャンペーン操作で Profile ID が必要です。
• トークンはリクエストごとに新しく取得されます（CLI での使用時にキャッシュによるオーバーヘッドはありません）。
• 本番環境や高頻度での使用では、トークンのキャッシュを追加してください。

関連項目

• skill-amazon-spapi — 注文、在庫、出品情報