mapa-calor は何をしますか？
相互補完する2つの診断：
| パート | 答える質問 | ソース | スクリプト |
|---|---|---|---|
| 動画 | 私の広告の何秒目で人が離脱するのか？ | Meta Graph API（GETのみ） | scripts/retencion_videos.py |
| ランディング | 人はスクロールして読み、タップするのか、それとも上で離脱するのか？ | Microsoft Clarity Data Export API | scripts/landing_clarity.py |
| 接続 | すべてが連携しているか？ | 上記両方 | scripts/conexion.py |
スクリプトは、このスキルのフォルダ内の scripts/ フォルダにあります（Claude Code では「Base directory for this skill」として表示され、通常は ~/.claude/skills/mapa-calor です）。以下のコマンドでは $SK がそのフォルダを表します。python3 を使用します（Windows では python）。
依頼内容に応じた操作
/mapa-calor引数なし、または初回 → conexion を実行し、その後、動画・ランディング・両方のいずれを実行するかユーザーに確認します。/mapa-calor conexion→python3 "$SK/scripts/conexion.py"を実行します。何か不足している場合は、README（「Conectar Meta」/「Conectar Clarity」セクション）に従ってステップバイステップでガイドします。act_が不明な場合：python3 "$SK/scripts/conexion.py" --cuentasを実行します。/mapa-calor videos→python3 "$SK/scripts/retencion_videos.py"を実行します（過去7日間、アクティブな広告）。オプション：--periodo last_14d、--desde AAAA-MM-DD --hasta AAAA-MM-DD、--todos（停止済みも含む）、--png mapa.png、--video archivo.mp4（最初の4秒間のフレームシート、0.5秒ごとに1コマ）。/mapa-calor landing→python3 "$SK/scripts/landing_clarity.py"を実行します。オプション：--url /products/x、--meta（リンクのCTRやMetaのカートデータとクロス分析）、--solo-cache、--cuota。/mapa-calor todo→ 最初に動画、次に--meta付きでランディングを実行し、最後に統合診断を提供します。- 接続がない場合や練習用の場合 →
--entrada <archivo.json>を付けてどちらかを実行します（リポジトリのejemplos/にサンプルデータがあります）。
解釈方法（数字とともにシンプルな言葉で説明する）
動画
- マップの 3秒 列を見ます：これは3秒時点で視聴を続けている人の割合です。
- < 25 % → フックが機能していません。具体的な推奨事項：最初の2.5秒を作り直す。
- 25–39 % → 普通。最初のフレームに商品を入れたバージョンを試す。
- ≥ 40 % → フックは機能しています。次の離脱ポイントを探します（スクリプトが「pasado el gancho…」とマークします）。
- 商品（または解決する課題）は2.5秒前に登場する必要があります。 0秒で商品を表示する動画の方が維持率が高いです。ユーザーが動画ファイルを持っている場合は、
--videoを提案し、フレームシートを確認（画像ツールで読み取る）して、離脱が発生している瞬間に何が映っているかを伝えます。 - 0秒から1秒で大きく落ちるのはフィードでは正常です：動画同士を比較し、100%と比較しないでください。
- インプレッション数が100未満 → 結論を出さない。 明確に伝え、その動画を停止または拡大するよう推奨しないでください。
- 維持率と売上を関連付けます：良いフック + 購入0 → ランディングに問題がある可能性があります（
/mapa-calor landingを提案）。
ランディング
- pierde_arriba（中央スクロール < 21 %）→ 最初の画面を修正：明確な見出し、使用中の商品写真、ベネフィットと価格をスクロールなしで表示。リンクのCTRが1.5%以上の場合は、広告は人を呼べています：問題はページです。
- friccion（怒りクリック > 5%、デッドクリック > 20%、またはクイックバック > 25%）→ Clarity でビジュアルヒートマップを開き（レポートにリンクが表示されます）、タップしている箇所と反応しない箇所を探します。
- retiene / oferta_precio（スクロール ≥ 30% だが、ビュー100あたりのカート追加が4未満）→ 問題はオファーか価格です。
- creativo（ページは良好、CTR < 1.5%）→ 広告のフックを変更し、ページは変更しない。
- muestra_chica（訪問者数 < 30）→ 結論を出さない。
- ヒートマップの画像（どこをタップしているか、どこまでスクロールしているか）は Clarity → Heatmaps パネルでのみ表示されます。スキルは数値とリンクを提供します。画像が何を示しているかをでっち上げないでください。
常に 最大3つの具体的なアクション を影響度順に提示し、その後に何を測定すべきかを伝えます（「3日後にもう一度 /mapa-calor videos を実行し、3秒列が上昇したか確認してください」）。
絶対に破らないルール
- トークンを絶対に表示、コピー、保存しない。
echo $META_TOKENを実行しない、.envを読み上げない、トークンをリポジトリのファイルに貼り付けない。ユーザーがチャットでトークンを貼り付けた場合は、キーチェーンまたは~/.mapa-calor/.envに保存し、安全のため後で再生成するように伝えてください。 - 読み取り専用。 このスキルは広告を作成、一時停止、編集することはありません。Meta で何かを変更するよう依頼された場合は、広告マネージャで行う方法を説明し、自分では行わないでください。
- Clarity のクォータ（1プロジェクトあたり1日10回のAPI呼び出し）に注意する。 スクリプトはキャッシュ（3時間）を保存し、8回で停止します。ユーザーから明示的に依頼があり、1回の呼び出しを消費することを理解している場合を除き、
--forzarは使用しないでください。同じデータを再度確認するには--solo-cacheを使用します。残り回数を確認するには：--cuota。 - サンプルサイズが小さい場合（動画はインプレッション数100未満、ランディングは訪問者数30未満）は結論を出さないでください。
- スクリプトが失敗した場合は、メッセージ（既にスペイン語で解決策とともに出力されています）を読み、ユーザーをガイドしてください。よくあるエラーは README（「Errores comunes」）に記載されています。