hookradar-agent-skill은(는) 무엇을 하나요?
AI 에이전트를 HookRadar에 연결하여 MCP 표준을 통해 경쟁사 크리에이티브 리서치를 자동화하고 광고 성과 데이터를 분석합니다.
개요
이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 HookRadar의 광고 인텔리전스 데이터에 접근할 수 있도록 합니다. MCP(Model Context Protocol)를 사용하여 에이전트와 HookRadar API 간의 원활한 통신을 가능하게 합니다.
기능
- 경쟁사 크리에이티브 리서치: 특정 광고주 또는 업계의 최신 광고 크리에이티브 검색
- 성과 데이터 분석: 노출, 클릭, CTR, 전환율 등 주요 지표 조회 및 분석
- 트렌드 탐색: 시간 경과에 따른 광고 트렌드 및 패턴 식별
- 필터링 및 정렬: 날짜, 플랫폼, 광고 유형 등 다양한 기준으로 데이터 필터링
설치
# npm을 통해 설치
npm install hookradar-agent-skill
또는 에이전트 설정에 직접 추가:
{
"mcpServers": {
"hookradar": {
"command": "npx",
"args": ["-y", "hookradar-agent-skill"],
"env": {
"HOOKRADAR_API_KEY": "your-api-key-here"
}
}
}
}
사용법
에이전트에게 명령하기
다음과 같은 자연어 명령을 사용할 수 있습니다:
- "최근 일주일간 가장 높은 CTR을 기록한 광고 크리에이티브를 찾아줘"
- "경쟁사 A의 페이스북 광고 성과를 분석해줘"
- "이번 분기 트렌드 크리에이티브 유형을 알려줘"
API 엔드포인트
| 메서드 | 경로 | 설명 |
|---|---|---|
GET | /creatives | 크리에이티브 목록 검색 |
GET | /creatives/:id | 특정 크리에이티브 상세 정보 |
GET | /analytics | 성과 분석 데이터 조회 |
GET | /trends | 트렌드 데이터 조회 |
환경 변수
| 변수명 | 필수 | 설명 |
|---|---|---|
HOOKRADAR_API_KEY | 예 | HookRadar API 키 |
HOOKRADAR_BASE_URL | 아니요 | API 기본 URL (기본값: https://api.hookradar.com) |
지원 플랫폼
- Claude Code
- Cursor
- Codex
- MCP 호환 모든 에이전트
라이선스
MIT