pinterest-ads

Pinterest Ads

Hyper MCP が公開する Pinterest Ads API v5 の機能を介して Pinterest Ads キャンペーンを管理するための戦略的スキルです。広告グループの作成では、直接 REST 呼び出し（SDK のモデル変換を回避）を使用するため、パラメーターの型はドキュメントどおりに正確に指定する必要があります。文字列は文字列、整数は整数として送信してください。

対象外 — 他のスキルに引き継いでください

リクエスト	引き継ぎ先
Google Ads キャンペーン	google-ads
Meta（Facebook／Instagram）広告キャンペーン	meta-ads
Amazon Sponsored Products	amazon-ads
TikTok 広告キャンペーン	tiktok-ads
Meta Ads Library を使った競合広告の調査	meta-ads-library
Pinterest のオーガニック投稿	現在は提供されていません — Pinterest アプリを使用してください

要件

• Hyper MCP がインストールされ、接続されていること。 https://app.hyperfx.ai/mcp
• Pinterest Ads インテグレーションが接続されていること。 https://app.hyperfx.ai/apps（広告アカウントへのアクセス権がある Pinterest Business アカウント）。

search("pinterest_ads_ad_accounts_list") で pinterest_ads_ad_accounts_list が見つからない場合は、処理を停止し、Hyper MCP を有効にして Pinterest Ads を接続するようユーザーに伝えてください。

このスキルのツールの実行方法

このスキルの各ツールには、正規のツール名が付いています。使用するサーフェスに応じて、次の呼び出し方法で実行してください。

サーフェス	ツールを検索する	実行する
MCP クライアント（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>")、次に describe("<name>")	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>"、次に hyperai describe <name>	hyperai call <name> --json '{...}'

ツールが見つからない場合、そのインテグレーションは接続されていないか、ワークスペースで有効になっていません。処理を停止し、接続するインテグレーションをユーザーに伝えてください。

ツールの一覧

ツールグループ	ツール
アカウント	pinterest_ads_ad_accounts_list, pinterest_ads_ad_accounts_get
キャンペーン	pinterest_ads_campaigns_list, pinterest_ads_campaigns_get, pinterest_ads_campaigns_create, pinterest_ads_campaigns_update
広告グループ	pinterest_ads_ad_groups_list, pinterest_ads_ad_groups_get, pinterest_ads_ad_groups_create, pinterest_ads_ad_groups_update
広告	pinterest_ads_list, pinterest_ads_get, pinterest_ads_create, pinterest_ads_update
オーディエンス	pinterest_ads_audiences_list, pinterest_ads_audiences_create, pinterest_ads_customer_lists_create
コンバージョン	pinterest_ads_conversion_tags_list, pinterest_ads_conversion_tags_create, pinterest_ads_conversion_events_send
キーワード	pinterest_ads_keywords_create
アナリティクス	pinterest_ads_campaign_analytics_get

重要なルール

重大： すべての予算と入札額はマイクロ通貨単位です。$1.00 = 1,000,000 マイクロドルです。$50／日は 50,000,000 です。ドル単位の金額をそのまま渡さないでください。

重大： is_flexible_daily_budgets: true を使用する場合は、必ず is_campaign_budget_optimization: true も設定してください。FDB には CBO が必要です。

重大： ライフタイム CBO キャンペーンには、必ず end_time（Unix タイムスタンプ）を含めてください。

重大： キャンペーンは最初にステータス PAUSED で作成してください。ユーザーの確認なしに配信を開始しないでください。

重大： WEB_CONVERSION 広告グループでは、billable_event="IMPRESSION"（CLICKTHROUGH ではありません）を使用し、attribution_windows、conversion_event、conversion_tag_id、cpa_goal_value_in_micro_currency を含む optimization_goal_metadata を必ず指定してください。

重大： キーワードの作成には match_type が必須です。指定しない場合、API は 500 エラーを返します。

重大： CBO キャンペーンでは、キャンペーンレベルで予算を管理します。CBO キャンペーン配下の広告グループに budget_in_micro_currency を設定しないでください。

重要： retention_days は ENGAGEMENT オーディエンスでは非推奨です。オーディエンスのルールから省略してください。

コアプロセス

ディスカバリー → アカウントを監査 → 調査（目標、オーディエンス、アセット）→ 戦略を確認 → キャンペーンを作成（PAUSED）→ 広告グループを作成 → 広告を作成 → レビュー → ユーザーの承認がある場合にのみ有効化します。

すべてのリファレンスファイルは references/ にあります。 references/<file> で読み込みます（例：references/discovery.md）。

ルーティング表

ユーザーの目的…	最初に読むファイル
キャンペーンを作成する（目的は問わない）	references/discovery.md → references/campaigns.md
WEB_CONVERSION キャンペーンを作成する	references/discovery.md → references/campaigns.md（WEB_CONVERSION テンプレートを正確に使用）＋コンバージョンタグについては references/audiences-and-conversions.md
オーディエンス／顧客リストを作成または管理する	references/audiences-and-conversions.md
コンバージョントラッキングを設定する／コンバージョンイベントを送信する	references/audiences-and-conversions.md
広告グループにキーワードを追加する	references/keywords-and-analytics.md
キャンペーン分析データを取得する	references/keywords-and-analytics.md
既存のキャンペーン／広告グループ／広告を更新または一時停止する	references/keywords-and-analytics.md
目標がまだ明確でない	references/discovery.md — ディスカバリーで目標を明確にします

既知の制限事項

問題	回避策
match_type を指定しないと、キーワードの作成で 500 エラーが返される	常に match_type（BROAD、PHRASE、EXACT）を指定します。
ENGAGEMENT オーディエンスでは retention_days は非推奨	ルール辞書から省略します。
WEB_CONVERSION 広告グループには多くのパラメーターが必要	WEB_CONVERSION テンプレートを正確に使用し、optimization_goal_metadata をすべて含めます。
WEB_CONVERSION 広告グループでは IMPRESSION の billable_event を使用する必要がある	WEB_CONVERSION では CLICKTHROUGH を使用しないでください。
CBO キャンペーンでは広告グループの予算が拒否される	親キャンペーンで CBO が有効な場合、budget_in_micro_currency を設定しないでください。
cpa_goal_value_in_micro_currency は文字列である必要がある	5000000 ではなく、"5000000" として渡します。
conversion_tag_id はアカウントに実在するタグである必要がある	先にコンバージョンタグを一覧表示し、既存のタグ ID を使用します。

安全ルール

絶対に行わないでください：

• Pin ID や広告アカウント ID を推測する — 常に確認するか、検索します。
• アカウントの監査フェーズを省略する。
• 明示的な承認なしにキャンペーンを作成する。
• ユーザーの同意なしにキャンペーンを ACTIVE に設定する。
• マイクロ通貨額の代わりにドル額を渡す。
• ENGAGEMENT オーディエンスで retention_days を使用する。
• optimization_goal_metadata なしで WEB_CONVERSION 広告グループを作成する。
• WEB_CONVERSION キャンペーンで CLICKTHROUGH の billable_event を使用する（IMPRESSION を使用してください）。
• CBO キャンペーンで広告グループの予算を設定する。
• match_type を指定せずにキーワードを作成する。
• cpa_goal_value_in_micro_currency を整数で渡す（"5000000" のような文字列である必要があります）。
• WEB_CONVERSION の最適化メタデータから conversion_tag_id を省略する（先にタグを一覧表示し、実在する ID を使用します）。