hookradar-agent-skill は何をしますか？
AIエージェントをHookRadarに接続し、MCP標準を使用して競合のクリエイティブリサーチを自動化し、広告パフォーマンスデータを分析します。
概要
このスキルは、HookRadar（広告クリエイティブのインテリジェンスプラットフォーム）とAIエージェント（Claude Code、Cursor、Codexなど）間のブリッジとして機能するMCPサーバーを提供します。MCP（Model Context Protocol）標準を使用することで、AIエージェントはHookRadarのデータにアクセスし、競合分析、トレンドの特定、パフォーマンス指標の抽出を自然言語で実行できます。
主な機能
- 競合クリエイティブリサーチ: 指定した業界やブランドの最新広告クリエイティブを自動取得
- パフォーマンスデータ分析: エンゲージメント率、クリック率、コンバージョン指標などの分析
- トレンド検出: プラットフォーム全体の広告トレンドを特定
- カスタムレポート: AIエージェントによる自然言語クエリからの動的レポート生成
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他のMCP対応AIエージェント
セットアップ
前提条件
- HookRadar APIキー（管理者から取得）
- Node.js 18以上
インストール
npm install @anagogic-blastinggelatin157/hookradar-agent-skill
設定
環境変数を設定します：
export HOOKRADAR_API_KEY=your_api_key_here
export HOOKRADAR_BASE_URL=https://api.hookradar.com/v1
使用方法
AIエージェント内で、以下のコマンドを使用してスキルを起動します：
{
"mcpServers": {
"hookradar": {
"command": "npx",
"args": ["-y", "@anagogic-blastinggelatin157/hookradar-agent-skill"],
"env": {
"HOOKRADAR_API_KEY": "your_api_key_here"
}
}
}
}
使用例
プロンプト例：
- 「最近のSaaS企業のトップパフォーマンス広告クリエイティブを教えて」
- 「競合ブランドXのFacebookキャンペーンのクリック率を分析して」
- 「今四半期のトレンドクリエイティブテーマを要約してレポートを作成」
APIエンドポイント
このスキルは以下のHookRadar APIエンドポイントを公開します：
list_creatives: フィルター条件に基づきクリエイティブを一覧表示get_creative_analytics: 特定のクリエイティブのパフォーマンス分析を取得search_competitors: 競合ブランドのアクティブな広告を検索get_trends: プラットフォーム全体の現在のトレンドデータを取得
トラブルシューティング
- APIキーエラー:
HOOKRADAR_API_KEYが正しく設定されていることを確認 - レート制限: HookRadar APIのレート制限に達した場合、リクエスト間隔を調整
- 接続の問題: インターネット接続とHookRadarサービスの状態を確認
ライセンス
MIT
サポート
問題や機能リクエストは、GitHubリポジトリで報告してください。