Spotify Ads API (v3) 用の読み取り専用CLIツール。詳細レポート、オーディエンス推定、キャンペーン分析をサポートします。
インストール＆ダウンロード
1. ClawHub CLI
レジストリから直接スキルをインストールする最速の方法です。
npx clawhub@latest install spotify-ads-cli
2. 手動インストール
スキルフォルダを以下のいずれかの場所にコピーしてください
~/.openclaw/skills/ <project>/skills/ 優先順位：ワークスペース > ローカル > バンドル
3. プロンプトのインストール
このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。
Clawhubを使って spotify-ads-cli をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください（npm i -g clawhub）。
ダウンロードをご希望ですか？
ZIPアーカイブで生のスキルファイルを取得します。
Spotify Ads CLI とは？
Spotify Ads CLIは、Spotify Ads API v3と連携するように設計された強力な技術ツールであり、開発者やマーケターがターミナルから直接詳細なパフォーマンスデータを抽出できるようにします。Openclaw Skillsライブラリへの強力な追加機能として、ビジネスアカウントのクエリ、広告費の追跡、キャンペーン階層の分析プロセスを簡素化します。このスキルは重要な広告指標への読み取り専用ゲートウェイを提供し、ライブキャンペーンを誤って変更することなく、データを安全に探索できるようにします。
このツールをOpenclaw Skillsワークフローに統合することで、集計されたパフォーマンススナップショットから複雑な人口統計的洞察レポートまで、あらゆるものにプログラムでアクセスできます。マイクロ通貨から通貨への変換や非同期CSVレポート生成など、Spotify APIの複雑さを処理するため、データ駆動型の広告戦略に不可欠なユーティリティです。
Spotify Ads CLI のユースケース
- 複数の広告アカウントにわたる日次のSpotify広告費およびパフォーマンス指標の監視。
- オーディエンス最適化のための年齢、性別、プラットフォームに基づいた人口統計的洞察の抽出。
- 特定のターゲティング基準に対するオーディエンス到達範囲および入札範囲を推定することによるキャンペーンの事前計画実行。
- キャンペーンの健全性を確保するためのクリエイティブ素材および広告ステータスの監査。
- 外部データ可視化のための大規模CSVレポートの自動生成および取得。
Spotify Ads CLI の仕組み
- ユーザーは環境変数またはローカル設定ファイルを介してSpotify OAuthアクセストークンを提供し、Spotify Ads APIを認証します。
- このスキルは、検出コマンドを使用してアクセス可能なビジネスおよび関連する広告アカウントを識別します。
- ユーザーのクエリに基づいて、CLIは集計レポート、ターゲティングオプション、資産メタデータなどの特定のデータポイントを要求します。
- レポートの場合、このスキルは継続トークンを介してページネーションを処理するか、非同期CSV生成要求を開始します。
- 取得されたすべてのデータは、美しく印刷された、またはコンパクトなJSON形式で出力され、Openclaw Skills内での分析やさらなる処理の準備が整います。
Spotify Ads CLI のセットアップ
このスキルを使用するには、まずnpmを使用してCLIをグローバルにインストールしてください：
npm install -g spotify-ads-cli
認証には、Ads APIアクセス権を持つSpotify Developer Appが必要です。環境変数を設定してスキルを構成できます：
export SPOTIFY_ADS_ACCESS_TOKEN='your_access_token'
または、~/.config/spotify-ads-cli/credentials.jsonに以下の構造の資格情報ファイルを作成してください：
{
"access_token": "your_access_token"
}
Spotify Ads CLI のデータスキーマとタクソノミー
このスキルは、Spotify Adsエンティティ階層に従ってデータを整理します。すべての出力はデフォルトでJSON形式です。
| レベル | 含まれるデータ |
|---|---|
| ビジネス | ID、名前、および関連する広告アカウントリンク。 |
| 広告アカウント | ステータス、通貨、および高レベル構成。 |
| キャンペーン / 広告セット | 予算（マイクロから変換）、スケジュール、およびターゲティング仕様。 |
| レポート | 標準単位でのインプレッション数、クリック数、到達範囲、および支出。 |
| ターゲティング | 地理、年齢、興味フィルターのためのJSONベースの仕様。 |
Spotify Ads CLI の高度な機能
- ステータス更新の自動ポーリングを含む非同期CSVレポート生成のサポート。
- 正確な予算計画のためのオーディエンスおよび入札範囲推定ツール。
- 測定ピクセルおよびデータセットの詳細な診断レポート。
- offsetおよびlimitパラメータを使用した大規模キャンペーンのページネーション管理。
- 自動化されたマーケティングレポートパイプラインのための他のOpenclaw Skillsとのシームレスな統合。
SKILL.md
ローディング
関連するOpenclawのスキル
Feishu Notifier Core
Openclaw Skillsを通じてFeishu (Lark)に自動通知を送信するための、軽量で安全なブリッジです。
Quantum Agent Memory
QAOAを使用して、AIエージェントのクラスタリング、圧縮、およびシナジーベースのリコール問題を解決する量子最適化メモリフレームワークです。
X Ads CLI
X Ads API v12 をクエリし、キャンペーンのパフォーマンスやアカウント構造を分析するための読み取り専用コマンドラインインターフェースです。
エグゼクティブ・チーフ・オブ・スタッフ
自動化されたブリーフィング、会議準備、戦略的情報収集を通じて経営層の意思決定を最適化するように設計されたAI搭載のチーフ・オブ・スタッフです。
Snapchat Ads CLI
Snapchat Marketing APIをクエリして広告パフォーマンスとアカウント構造を分析するための、包括的な読み取り専用コマンドラインインターフェースです。
Bid Monitor V2.0
建設およびEPCの入札機会をクロール、フィルタリングし、企業用コミュニケーションプラットフォームに直接プッシュする自動化されたビジネスインテリジェンスレーダーです。
特徴*
