Communitygithub.com

benjaminb10/viewlify-mcp

Claude 및 AI 에이전트를 위한 TikTok 데이터: MCP 서버 (크리에이터의 일반 조회수를 넘는 인기 동영상, 트렌드, 해시태그, 사운드), 3가지 스킬을 갖춘 Claude Code 플러그인, 그리고 viewlify CLI.

viewlify-mcp란 무엇인가요?

Viewlify MCP는 Claude 및 AI 에이전트가 TikTok 데이터를 활용하여 특정 니치에서 진정한 인기 동영상을 식별하고 분석할 수 있도록 하는 강력한 도구입니다. 각 동영상을 해당 크리에이터의 일반 조회수와 비교하여 '배수(multiple)'라는 고유한 지표를 제공합니다. 예를 들어, 2K 조회수의 계정에서 50K 조회수를 기록한 동영상은 돌파(breakout)로 간주됩니다. 이 서버는 Claude Code, Cursor, claude.ai 등 다양한 MCP 클라이언트와 호환되는 원격 Streamable HTTP 서버로 제공되며, 로컬 설치가 필요 없습니다. 주요 기능으로는 트렌딩 동영상, 해시태그, 사운드 검색, 아웃라이어(outlier) 분석, 크리에이터 프로필 조회 등이 있으며, 무료 미리보기와 유료 API 키를 통해 사용할 수 있습니다. 또한 'outlier research', 'video ideas', 'trend watch'의 세 가지 특화된 Claude Code 스킬이 포함되어 있어, 마케터, 콘텐츠 제작자 및 연구자가 TikTok 트렌드를 깊이 있게 파고들 수 있도록 지원합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/benjaminb10/viewlify-mcp/tree/main

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Viewlify MCP: Claude 및 AI 에이전트를 위한 TikTok 데이터

Claude에게 특정 니치에서 진짜 인기 있는 TikTok 동영상과 그 이유를 물어보세요. Viewlify는 공개 TikTok 동영상을 추적하고 각 동영상을 해당 크리에이터의 일반 조회수와 비교합니다. 50K 조회수의 동영상은 평소 500K를 받는 계정에게는 실패작이지만, 평소 2K를 받는 계정에게는 돌파(breakout)입니다. 이 비율, 즉 **배수(multiple)**가 이 서버가 반환하는 핵심 데이터이며, 니치별로 가장 빠르게 조회수를 얻는 동영상, 해시태그 및 사운드도 함께 제공됩니다.

이 저장소는 Claude Code, Claude, Cursor 또는 모든 MCP 클라이언트에서 Viewlify를 사용하는 데 필요한 모든 것을 포함합니다:

  • 원격 MCP 서버 구성 (https://viewlify.app/api/mcp),
  • 이를 기반으로 구축된 세 가지 스킬을 갖춘 Claude Code 플러그인,
  • npm에 게시된 viewlify 명령줄 도구의 소스 코드.

서버는 Viewlify가 호스팅하며, 로컬에서 실행할 항목은 없습니다.

빠른 시작

Claude Code, 플러그인으로 (MCP 서버 및 세 가지 스킬):

/plugin marketplace add benjaminb10/viewlify-mcp
/plugin install viewlify@viewlify

설치 시 Claude Code가 Viewlify API 키를 요청합니다. 선택 사항입니다(아래 참조): 무료 미리보기를 위해 비워 두세요.

Claude Code, MCP 서버만:

claude mcp add --transport http viewlify https://viewlify.app/api/mcp --header "Authorization: Bearer vf_live_YOUR_KEY"

Claude (claude.ai 또는 Desktop): 설정 > 커넥터 > 사용자 정의 커넥터 추가, URL https://viewlify.app/api/mcp.

Cursor 및 기타 클라이언트: https://viewlify.app/api/mcp에 있는 Streamable HTTP 서버, 헤더 Authorization: Bearer vf_live_YOUR_KEY 포함.

터미널: npx viewlify login, 그 다음 npx viewlify search "skincare" --sort outlier --limit 5. npx viewlify mcp는 키와 함께 claude mcp add 명령어를 출력합니다.

API 키 및 가격

키는 선택 사항입니다. 키 없이 공개 도구는 IP당 하루 20회 호출로 5개 결과 미리보기를 제공합니다.

키를 사용하면 전체 결과, 아웃라이어 배수, 조회수 1,000회당 공유 수, Viewlify가 기록한 조회 기록, 그리고 전체 베이스의 모든 동영상 검색을 이용할 수 있습니다. 모든 Viewlify 계정은 설정 > API 및 MCP에서 키를 생성할 수 있으며, 무료 요금제도 포함되며 $1의 무료 크레딧이 제공됩니다. 이후에는 선불 크레딧(5~100 USD 충전)에서 호출당 $0.005가 차감되거나, Pro 및 Agency 요금제에 포함됩니다. 가격: viewlify.app/tiktok-data-api.

도구

도구키반환 내용
get_trending선택지금 니치별로 인기 있는 동영상, 해시태그 및 사운드
get_outliers선택크리에이터의 일반 조회수를 가장 큰 격차로 넘는 동영상, 니치 또는 검색 기준
get_trending_hashtags선택인기 동영상에 반복적으로 나타나는 해시태그, 니치별
get_creator선택한 크리에이터: 팔로워, 일반 조회수, 참여율, 최고 돌파작, 최적 게시 요일, 상위 해시태그 및 사운드, 배수가 포함된 동영상
search_trending_videos필수키워드, @creator 또는 #hashtag로 전체 베이스 검색; 트렌딩, 아웃라이어, 조회수, 최신, 참여율 또는 공유 순 정렬
get_balance, top_up필수API 크레딧 및 추가 충전을 위한 결제 링크
list_my_accounts, get_account_growth, get_account_videos, get_my_niche_watch, get_my_video_checksPro 또는 Agency사용자가 추적하는 계정, 성장 및 동영상, 니치 워치 및 AI 동영상 검사

니치: 뷰티, 게임, 푸드, 피트니스, 패션, 코미디, 댄스, 반려동물, 축구, 스포츠, 음악, 여행, 기술, 자동차, 금융, 학습, 홈, 아트, 자기계발, 애니메이션. 읽기 전용: 서버는 절대 게시하거나 변경하지 않습니다.

스킬

스킬사용 목적
tiktok-outlier-research니치에서 진짜 인기 있는 것과 그 배경 패턴 찾기
tiktok-video-ideas실제 돌파작을 모델로 한 후크가 포함된 5가지 동영상 아이디어 얻기
tiktok-trend-watch떠오르는 포맷, 해시태그 및 사운드에 대한 한 화면 주간 요약

스킬은 claude.ai에서도 작동합니다: 스킬 폴더를 다운로드하고 설정 > 기능 > 스킬에서 추가하세요.

예시 프롬프트

  • "이번 달 피트니스 TikTok에서 인기 있는 것은 무엇이며, 그 동영상들의 공통점은 무엇인가요?"
  • "집에서 촬영하는 요리 계정을 위해, 현재 잘 통하는 것을 기반으로 5가지 동영상 아이디어를 주세요."
  • "뷰티와 패션 주간 트렌드 요약."
  • "아웃라이어 기준으로 정렬된, 지난 30일간 단백질 바에 관한 TikTok 동영상을 검색해 줘."

데이터

공개 TikTok 데이터만 포함: 동영상, 캡션, 해시태그, 사운드 및 공개 카운터, 매일 업데이트. Viewlify는 TikTok과 제휴 관계가 아닙니다.

저장소 구조

.claude-plugin/   Claude Code용 플러그인 및 마켓플레이스 매니페스트
.mcp.json         플러그인이 연결하는 MCP 서버 (설치 시 API 키 요청, 선택 사항)
server.json       공식 MCP 레지스트리 항목
skills/           세 가지 스킬

라이선스

MIT. 이슈 및 풀 리퀘스트를 환영합니다. Viewlify가 제작했습니다.

관련 스킬