Wecandeo VideoPack v4 Analytics MCP Server

위캔디오 비디오팩 통계(Analytics) 기능을 위한 MCP 서버입니다. @wecandeo/mcp-videopack-v4 와 동일한 구조를 따르며, 통계 API 전용으로 구성됩니다.

• API 가이드: 통계 시스템 개요

인증 및 사용 정책

• 인증: API 키를 x-api-key 헤더로 전송합니다. (비디오팩 본 API의 key 쿼리 파라미터와 다름)
• 호스트: https://api.v4.wecandeo.com (/report/statistics/...)
• 통계 API 사용에는 사전 API-KEY 등록이 필요하며, 허용된 계정에만 제공됩니다. (담당 AM 문의)
• 요청 제한: 초당 10회, 일 100회(UTC 00:00 초기화), 계정당 동시 1요청.
• 재생(playback) 통계의 검색 기간(sdate ~ edate)은 최대 10일입니다. 사용량(usage) 통계는 더 긴 기간을 허용하며, AI 사용량은 최대 1년(최근 3년 이내)까지 조회됩니다.
• 응답 최대 1000건(pageSize 기본 30). 데이터는 실시간이 아니며 최대 약 2시간 지연될 수 있습니다.
• 페이징: 응답의 requestId 와 nextToken 을 동일 도구에 전달해 다음 페이지를 조회합니다.

환경 변수

| 변수 | 설명 | |---|---| | WECANDEO_API_KEY | Wecandeo API 키 (필수) | | WECANDEO_STATS_BASE_URL | 통계 API 호스트 (선택, 기본 https://api.v4.wecandeo.com) |

실행

WECANDEO_API_KEY=your_key npx @wecandeo/mcp-analytics-v4

{
  "mcpServers": {
    "wecandeo-v4-analytics": {
      "command": "npx",
      "args": ["-y", "@wecandeo/mcp-analytics-v4"],
      "env": {
        "WECANDEO_API_KEY": "your_api_key_here"
      }
    }
  }
}

제공 도구

재생 통계 (Playback)

| 도구 | 설명 | |---|---| | wecandeo_stats_playback_video | 동영상별 재생수/재생시간 (packageId 필수) | | wecandeo_stats_playback_package | 패키지별 재생수/재생시간 | | wecandeo_stats_playback_date | 날짜별 | | wecandeo_stats_playback_time | 특정일 시간대별(00~23) | | wecandeo_stats_playback_country | 국가별 | | wecandeo_stats_playback_country_detail | 국가→도시 상세 (country 필수) | | wecandeo_stats_playback_domain | 도메인별 | | wecandeo_stats_playback_domain_detail | 도메인→URL 상세 (domain 필수) | | wecandeo_stats_playback_device | 디바이스별 | | wecandeo_stats_playback_device_detail | 디바이스 상세 (device 필수) | | wecandeo_stats_playback_os | OS별 | | wecandeo_stats_playback_os_detail | OS 버전 상세 (os 필수) | | wecandeo_stats_playback_browser | 브라우저별 | | wecandeo_stats_playback_browser_detail | 브라우저 버전 상세 (browser 필수) | | wecandeo_stats_playback_section | 재생 구간별(10~100%) (packageId+accessKey 필수) |

사용량 통계 (Usage)

| 도구 | 설명 | |---|---| | wecandeo_stats_usage_storage | 스토리지 사용량(일별) | | wecandeo_stats_usage_traffic | 트래픽 사용량(일별) | | wecandeo_stats_usage_encoding | 인코딩 사용량(일별) | | wecandeo_stats_usage_onetime_key | 원타임 키 조회 API 사용량(일별) | | wecandeo_stats_usage_contents | 콘텐츠 리소스 접근 요청 수(일별) | | wecandeo_stats_usage_ai | AI 자막(생성/번역/요약) 사용량(일별) |

공통

| 도구 | 설명 | |---|---| | wecandeo_stats_query | 임의 통계 엔드포인트 범용 조회 (경로 + 기간 직접 입력) | | ping | 서버 응답 확인 |