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_checks | Pro 또는 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가 제작했습니다.