npm.io
1.0.2 • Published 3d agoCLI

@pluto90/wecandeo-v4-analytics-mcp

Licence
MIT
Version
1.0.2
Deps
2
Size
26 kB
Vulns
0
Weekly
6
DeprecatedThis package is deprecated
SummaryDependencyVersions

Wecandeo VideoPack v4 Analytics MCP Server

위캔디오 비디오팩 통계(Analytics) 기능을 위한 MCP 서버입니다. @pluto90/wecandeo-v4-mcp 와 동일한 구조를 따르며, 통계 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 @pluto90/wecandeo-v4-analytics-mcp
{
  "mcpServers": {
    "wecandeo-v4-analytics": {
      "command": "npx",
      "args": ["-y", "@pluto90/wecandeo-v4-analytics-mcp"],
      "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 서버 응답 확인

Keywords

mcpwecandeovideopackanalyticsstatisticsv4