ads

広告：無料優先の有料広告監査・最適化

広告費の大半を占める主要な3つのプラットフォーム、Meta、Google、TikTokに特化した広告アカウント分析です。19個の専門サブスキルと7つのエージェント（監査3個＋クリエイティブ4個）を連携させます。初回利用時は /ads start と入力してください。コンテキストを取得し、OAuth の設定を手順に沿って案内するウィザードが起動し、すべての情報を ~/.claude-ads/profile.json に保存するため、以降のコマンドで再度質問されることはありません。

クイックリファレンス

コマンド	内容
/ads start	初回ウィザード — コンテキストの取得、各プラットフォームの OAuth/MCP 設定をライブ検証付きで案内し、Zernio と Meta Developers の登録も任意で行います。/ads start edit/status/reset として再実行できます。
/ads next	継続的なコーチ — 最近の監査 JSON と履歴を読み込み、効果 × 容易さで上位3つのクイックウィンを順位付けします。任意で1位の修正を案内します。前回の監査からの後退も検出します。
/ads audit	サブエージェントに並列委任して、複数プラットフォームを全面監査します（エージェント3個：Meta、Google、TikTok）
/ads google	Google Ads の詳細分析（検索、PMax、YouTube 動画キャンペーンを含む）
/ads meta	Meta Ads の詳細分析（FB、IG、Advantage+）— claude.ai Facebook と MCP 連携
/ads tiktok	TikTok Ads の詳細分析（クリエイティブ、Shop、Smart+、Symphony、GMV Max）
/ads creative	複数プラットフォームにわたるクリエイティブ品質監査
/ads landing	広告キャンペーン用ランディングページの品質評価
/ads budget	予算配分と入札戦略のレビュー
/ads plan <business-type>	業界別テンプレートを使った戦略的な広告プラン
/ads competitor	競合広告のインテリジェンス分析
/ads math	PPC 財務計算ツール（CPA、ROAS、損益分岐点、予算予測）
/ads test	A/B テストの設計（仮説、有意性、期間、サンプルサイズ）
/ads report	クライアント向け成果物として PDF 監査レポートを生成
/ads dna <url>	ウェブサイトからブランド DNA を抽出し、brand-profile.json を出力
/ads create	キャンペーンのコンセプトとコピーのブリーフを生成し、campaign-brief.md を出力
/ads generate	ブリーフをもとに AI 広告画像を生成し、ad-assets/ に出力
/ads photoshoot	5つのスタイル（スタジオ、浮遊、素材、使用中、ライフスタイル）で商品写真を撮影
/ads update <platform|all>	過去30日間の変更をもとに、プラットフォームごとのリファレンスを更新します（高コスト：約50～150k トークン／プラットフォーム。確認後に実行）
/ads publish	Zernio 経由で生成したクリエイティブを14以上のソーシャルネットワークに公開します（最初の2アカウントは無料。skills/ads-publish/SKILL.md を参照）

初回実行時の動作

ユーザーが /ads start、/ads math、/ads test 以外の /ads コマンドを実行した場合は、最初に以下を実行します。

python3 scripts/profile.py get

• 終了コード 2（プロファイルが見つからない）→ 次のヒントを1行で表示します。

  ヒント：まず /ads start を実行してください。以降の各コマンドで約30秒短縮できます。このままインラインで続行しますか？（Y/N） N（続行する）を選んだ場合は、下記のインラインのコンテキスト取得に切り替えます。

• 終了コード 0（プロファイルが存在する）→ JSON を解析し、保存済みの context.industry、context.monthly_spend_usd、context.primary_goal、 context.active_platforms をそのまま使用します。再度質問しないでください。フィールドが null または空の場合に限り、再度質問してください。

コンテキストの確認（フォールバック — プロフィールがなく、ユーザーが /ads start を拒否した場合のみ）

コンテキストがないと、ベンチマークは一般的なものになり、ユーザーの状況に合わない提案をしてしまう可能性があります。

最初に、次の質問をします（1つのメッセージにまとめます）。

1. 業界／ビジネスの種類：ご自身に最も当てはまるものはどれですか？ Eコマース · 地域密着型サービス · 不動産 · ヘルスケア · 金融 · 代理店 · その他 （注：B2Bエンタープライズ、SaaS、モバイルアプリ、情報商材のテンプレートは、監査対象外となったLinkedIn／Apple／YouTubeに依存していたため、v2.3.0で削除されました。代わりに generic テンプレートと、以下のプラットフォーム固有のスキルを使用してください。）
2. 月間広告費：総予算とプラットフォームごとの内訳（概算でかまいません）
3. 主な目標：販売／売上 · リード／デモ · アプリのインストール · 電話 · ブランド
4. 利用中のプラットフォーム：対応している3つ（Meta、Google、TikTok）のうち、どれに広告を出稿していますか？

ユーザーが先にデータを提示した場合（例：「Google Adsを監査してください。Eコマースで月5,000ドル使っています」）、そこからコンテキストを抽出し、質問を繰り返さずに進めます。

確認の最後に、次のように提案します：「この内容をプロフィールに保存して、次回から質問しないようにしますか？（回答を入力済みの状態で /ads start を実行します）」

提供されたコンテキストを次の目的に使用します。

• references/benchmarks.md から適切な業界ベンチマークを選択する
• 予算に応じた提案を行う（例：スマート自動入札には月15件以上のコンバージョンが必要です）
• 深刻度のスコアリングを調整する（月500ドルのアカウントと月50,000ドルのアカウントでは、優先事項が異なります）

オーケストレーションのロジック

ユーザーが /ads audit を呼び出したら、サブエージェントに並行して処理を委任します。

1. コンテキストを読み込む — python3 scripts/profile.py get を実行します。プロフィールが存在する場合は、それを使用します。終了コードが2の場合は、インラインのコンテキスト確認に切り替えます（最後に /ads start での保存を提案します）。
2. アカウントデータを収集します（エクスポート、スクリーンショット、または貼り付けられた指標。連携済みプラットフォームの場合は、保存された connections.<p>.tier を使用します）。
3. ビジネスの種類を検出し、利用中のプラットフォームを特定します（利用可能な場合は context.active_platforms から取得します）。
4. Task ツールを使い、context: fork でサブエージェントを起動します。対象は context.active_platforms に含まれるプラットフォーム（または connections.<p>.tier != "skipped" のプラットフォーム）のみです：audit-google、audit-meta、audit-tiktok
5. 検証：各サブエージェントは <platform>-audit-results.json と <platform>-audit-results.md の両方を書き出します。JSONを解析し、集約する前に references/audit-output-schema.json に照らして検証します。サブエージェントのJSONが見つからない、または無効な場合は、エラーを提示して停止します。部分的な結果を黙って集約してはいけません。
6. references/scoring-system.md のプラットフォーム別予算配分の計算式を使ってスコアを集約し、統合広告ヘルススコア（0～100）を生成します。
7. 各JSONの quick_wins と critical_issues 配列から、優先順位付きのアクションプランを作成します。
8. 履歴に保存 — 新しい監査JSONごとに、python3 scripts/profile.py save-audit <platform>-audit-results.json を実行します。これは /ads next の回帰検出に使用されます。
9. 次のステップを提案する — 優先順位付きのクイックウィンを確認するため、ユーザーに /ads next を案内します。

個別のコマンド（/ads google、/ads meta など）では、該当するサブスキルを直接読み込みます。コンテキストがまだ提供されていない場合は、プロフィールの読み込みとコンテキストの収集も行います。

/ads update <platform|all> の場合は、skills/ads-update/SKILL.md に処理を引き継ぎます。更新スキルでは、取得前にコスト確認のゲートを必ず通過します。これを回避してはいけません。理由については references/update-cost-warning.md を参照してください。

クリエイティブのワークフロー

順次実行するパイプライン（各ステップは個別に実行できます）。

1. /ads dna <url> → カレントディレクトリに brand-profile.json を作成します
2. /ads create → プロフィールと任意の監査結果を読み込み、campaign-brief.md を作成します
3. /ads generate → ブリーフとプロフィールを読み込み、ad-assets/ ディレクトリを作成します
4. /ads photoshoot → 単独で実行するか、スタイルの適用にプロフィールを読み込みます

GOOGLE_API_KEY（デフォルトのGemini）または ADS_IMAGE_PROVIDER と対応するキーが必要です。 APIキーがない場合、/ads generate と /ads photoshoot はセットアップ手順を表示して終了します。エラーを黙って無視することはありません。

業種の検出

広告アカウントのシグナルから業種を検出します。

• SaaS：trial_start／demo_request イベント、料金ページのターゲティング、長いアトリビューション期間
• E-commerce：購入イベント、商品カタログ／フィード、ショッピング／PMax キャンペーン
• Local Service：電話番号表示オプション、地域ターゲティング、店舗訪問、経路案内イベント
• B2B Enterprise：LinkedIn Ads が有効、ABM リスト、高い CPA 許容度（$50 以上）、長い営業サイクル
• Info Products：ウェビナー／コースのファネル、リード獲得フォーム、低価格オファー
• Mobile App：アプリインストールキャンペーン、アプリ内イベント、ディープリンク
• Real Estate：物件リスティングフィード、物件ごとのランディングページ、地域を重視したターゲティング
• Healthcare：HIPAA 準拠フラグ、ヘルスケア固有の広告ポリシー
• Finance：特別な広告カテゴリの申告、金融商品に関するコンプライアンス
• Agency：複数のクライアントアカウント、ホワイトラベルレポートのニーズ

品質ゲート

厳守事項（決して違反しないでください）。

• スマート自動入札を使用せずに、部分一致を推奨しないでください（Google）。
• 3x 停止ルール：CPA が目標の 3 倍を超える広告グループ／キャンペーンには、停止フラグを付けてください。
• 予算の十分性：Meta は広告セットあたり CPA の 5 倍以上、TikTok は広告グループあたり CPA の 50 倍以上
• 学習フェーズ：学習フェーズ中に編集を推奨しないでください。
• コンプライアンス：住宅／雇用／信用／金融について、必ず特別な広告カテゴリを確認してください。
• クリエイティブ：音声がオンのプラットフォームである TikTok では、音声なしの動画広告を配信しないでください。
• アトリビューション：デフォルトは 7 日間のクリック／1 日間のビュー（Meta）、データドリブン（Google）です。
• Andromeda のクリエイティブ多様性：真に異なるクリエイティブが 10 個未満の Meta アカウントにフラグを付けてください。
• プライバシーインフラのゲート：最適化を推奨する前に、必ずトラッキングスタック（Consent Mode V2、CAPI、Events API、AdAttributionKit）を確認してください。
• PDF レポートの品質ゲート：/ads report でレポートを生成する場合は、必ず最初に scripts/generate_report.py を --check とともに使用してください。レポートには、要素の重なりがない整ったレイアウト、適切な余白（0.75in）、折り返された表のセル（文字の切り抜きなし）、ページ範囲内に収まるサイズのすべてのグラフ／画像、ページ番号とセクション区切り、すべてのビジュアルのキャプション、空のセクションがないことが必要です。--output の前に --check を実行し、PDF を納品する前に警告をすべて修正してください。

参照ファイル

必要に応じてオンデマンドで読み込みます。起動時にすべて読み込まないでください。

パスの解決： すべての参照ファイルは ~/.claude/skills/ads/references/ にインストールされています。 サブスキルやエージェントが ads/references/*.md を参照する場合は、 ~/.claude/skills/ads/references/*.md に解決してください。

• references/audit-methodology.md：すべてのプラットフォームスキルが利用する共通の7ステップ監査プロセスです。監査の基本構成、チェック ID の規則、MCP 優先ルール、出力契約の参照先を一元管理しています。
• references/audit-output-schema.json：すべての audit-* エージェントが出力する正式な JSON スキーマです。オーケストレーターは、クロスプラットフォームのスコアを集計する前に、このスキーマに照らして検証します。新しい統合もこの契約に準拠します。
• references/profile-schema.json：~/.claude-ads/profile.json のスキーマです。/ads start が永続的なユーザーコンテキストを書き込み、すべてのコマンドが読み取ります。
• references/audit-history-schema.json：~/.claude-ads/history/index.json のスキーマです。/ads next が回帰検出のために読み取る監査ログです。
• references/setup-meta.md / setup-google.md / setup-tiktok.md：/ads start のフェーズ C で読み込まれる、OAuth、MCP、手動接続の手順です。
• references/setup-zernio.md / setup-meta-developers.md：オプションの統合向けアカウント作成手順です。
• references/scoring-system.md：加重スコアリングアルゴリズムと評価基準
• references/benchmarks.md：プラットフォーム別の業界ベンチマーク（CPC、CTR、CVR、ROAS）
• references/bidding-strategies.md：プラットフォーム別の入札判断ツリー
• references/budget-allocation.md：プラットフォーム選定マトリックス、拡大ルール、MER
• references/platform-specs.md：すべてのプラットフォームにおけるクリエイティブ仕様
• references/conversion-tracking.md：ピクセル、CAPI、EMQ、ttclid の実装
• references/compliance.md：規制要件、広告ポリシー、プライバシー
• references/google-audit.md：Google Ads の80項目監査チェックリスト（YouTube 動画キャンペーンを含む）
• references/meta-audit.md：Meta Ads の50項目監査チェックリスト
• references/tiktok-audit.md：TikTok Ads の28項目監査チェックリスト
• references/brand-dna-template.md：ブランド DNA のスキーマと抽出ガイド
• references/image-providers.md：プロバイダーの設定（Gemini/OpenAI/Stability/Replicate）
• references/google-creative-specs.md：PMax/RSA/YouTube の生成対応仕様
• references/meta-creative-specs.md：フィード/Reels/Stories の仕様とセーフゾーン
• references/tiktok-creative-specs.md：9:16 のみ＋セーフゾーンオーバーレイ
• references/gaql-notes.md：GAQL フィールドの互換性、重複排除パターン、フィルター範囲のベストプラクティス
• references/voice-to-style.md：画像生成におけるブランドボイスの軸から視覚属性へのマッピング
• references/copy-frameworks.md：6つの広告コピーのフレームワーク（AIDA、PAS、BAB、4P、FAB、Star-Story-Solution）
• references/mcp-integration.md：正式な MCP 統合パターンとプラットフォーム別 MCP サーバーカタログ
• references/mcp-meta-integration.md：Meta MCP のチェックとツールの対応付け（新しい MCP 統合向けテンプレート）

MCP が推奨される方法ではないプラットフォームでは、監査エージェントは scripts/api/<platform>_fetch.py が生成する <platform>-data.json を読み取ります。 これらは Meta、Google、TikTok を対象とする、標準ライブラリのみを使用した API アダプターです。 プラットフォームごとの OAuth 設定手順については、scripts/api/README.md を参照してください。

スコアリング方法

広告ヘルススコア（0～100）

プラットフォーム別スコアには、references/scoring-system.md の加重アルゴリズムを使用します。 クロスプラットフォームの総合スコアは、予算シェアに基づいて加重します。

Aggregate = Sum(Platform_Score x Platform_Budget_Share)

評価

評価	スコア	必要な対応
A	90-100	軽微な最適化のみ
B	75-89	改善の余地あり
C	60-74	目立った問題への対応が必要
D	40-59	重大な問題あり
F	<40	緊急の対応が必要

優先度

• Critical：収益／データ損失のリスク（直ちに修正）
• High：パフォーマンスを大きく損なう要因（7日以内に修正）
• Medium：最適化の機会（30日以内に修正）
• Low：ベストプラクティス。影響は軽微（バックログ）

サブスキル

このスキルは、19個の専門サブスキルを統括します。

1. ads-start：初回利用を案内するウィザード — コンテキストの収集、プラットフォームごとの OAuth／MCP 設定手順と確認、Zernio + Meta Developers への登録（任意）、プロフィールを ~/.claude-ads/profile.json に保存
2. ads-audit：Meta／Google／TikTok 間で並列に委任する、複数プラットフォームの包括的な監査
3. ads-next：継続的なコーチ — 最近の監査結果と履歴からクイックウィンを順位付けし、リグレッションを検出して、必要に応じて最優先の項目の修正をユーザーに案内
4. ads-google：Google 広告の詳細分析（検索、PMax、YouTube 動画キャンペーン — これらは同じ Google Ads API を使用）
5. ads-meta：Meta 広告の詳細分析（FB、IG、Advantage+）— claude.ai Facebook に MCP 接続
6. ads-tiktok：TikTok 広告の詳細分析（クリエイティブ、ショップ、Smart+、Symphony、GMV Max）
7. ads-creative：プラットフォーム横断のクリエイティブ品質監査
8. ads-landing：広告キャンペーン向けランディングページの品質評価
9. ads-budget：予算配分と入札戦略
10. ads-plan：業界別テンプレート（v2.3.0 で対象範囲を縮小した後、テンプレートは8種類）を使用した戦略的な広告計画
11. ads-competitor：競合広告のインテリジェンス
12. ads-dna：ウェブサイト URL からブランド DNA を抽出
13. ads-create：キャンペーンのコンセプト、コピー資料、クリエイティブブリーフ
14. ads-generate：差し替え可能なプロバイダーによる AI 画像生成
15. ads-photoshoot：5種類のプロフェッショナルスタイルによる商品撮影
16. ads-update：過去30日間の変更を反映し、プラットフォームごとの参照情報を更新
17. ads-math：PPC 財務計算ツール（CPA、ROAS、損益分岐点、LTV:CAC、MER）
18. ads-test：A/B テストの設計（仮説、サンプルサイズ、統計的有意性）
19. ads-publish：Zernio を介して14以上のソーシャルネットワークにクリエイティブを公開（最初の2アカウントは無料）

さらに、PDF の成果物を生成する /ads report もあります（scripts/generate_report.py に実装されており、SKILL.md はありません）。

サブエージェント

包括的な監査で並列分析を行うための、プラットフォームごとの専門エージェント：

• audit-google：Google 広告の80項目監査（G01-G74、G-PM*、G-AI*、G-DG*、G-CTV*、G-WS*、G-KW*、G-CT*、G-AD*）
• audit-meta：Meta 広告の50項目監査（M01-M40、M-AN*、M-AT*、M-CR*、M-ST*、M-IA*、M-TH*）— MCP 接続済み
• audit-tiktok：TikTok 広告の28項目監査（T01-T25、T-SR*）— TikTok 向けの旧 audit-creative／audit-tracking／audit-budget／audit-compliance を1つの専門エージェントに統合

クリエイティブパイプラインのエージェント（変更なし）：

• creative-strategist：ブランドプロフィールと監査結果からキャンペーンのコンセプトを作成（Opus、maxTurns: 25）
• visual-designer：generate_image.py を介したブランド要素の組み込みによる画像生成（Sonnet、maxTurns: 30）
• copy-writer：プラットフォームの制限に準拠した見出し、CTA、メインテキストの作成（Sonnet、maxTurns: 20）
• format-adapter：アセットの寸法検証と仕様準拠状況の報告（Haiku、maxTurns: 15）

---

tododeia.com が保守しています — Instagram @soyenriquerocha