Virlo API를 사용해 AI 기반 트렌드 분석 도구를 만들었습니다 (작동 원리)
Source: Dev.to
위 링크에 있는 전체 글을 번역하려면 해당 텍스트를 제공해 주시겠어요?
코드 블록, URL 및 마크다운 형식은 그대로 유지하면서 내용만 한국어로 번역해 드리겠습니다.
Source:
So here’s the thing
내 친구는 트렌드를 타면서 동기부여 페이지를 키우려고 했어. 그는 매번 트렌드를 놓친다고 계속 얘기했지. 트렌드가 뭔가를 알게 될 때쯤이면 이미 정점은 지나가 버렸어. 그는 다가올 주제에 대해 크리에이터들이 수백만 뷰를 기록하는 걸 보았지만, 자신이 올릴 때쯤엔 그 순간이 지나버렸어.
나는 어떻게 하면 트렌드를 더 일찍 잡을 수 있을지 조사하기 시작했어. 그가 사용하던 도구들은 이미 인기 있는 것을 보여줄 뿐이었어. “이 해시태그에 230만 개의 포스트가 있다”라고는 알려줬지만, 다음에 무엇을 해야 할지 결정하는 데는 도움이 안 됐지.
- 사용해야 할까?
- 이미 경쟁이 너무 치열한가?
- 더 좋은 각도가 있을까?
데이터는 이런 질문에 답을 주지 못했어.
문제는 데이터가 부족해서가 아니라 의미가 부족해서였어.
나는 이론을 별로 좋아하지 않아. 뭔가가 나를 괴롭히면, 나는 무언가를 만든다. 그래서 실제로 도움이 될 작은 무언가를 만들기로 했어—숫자만 보여주는 것이 아니라 실행 가능한 다음 단계로 트렌드를 전환해 주는 도구 말이야.
트렌드를 보는 것과 활용하는 것 사이의 격차
트렌딩 콘텐츠를 보여주는 대부분의 도구는 바로 그걸 보여줄 뿐이야: 무엇이 트렌드인지. 그게 전부야.
- 해시태그 분석 플랫폼은 어떤 태그에 포스트가 가장 많은지 알려준다.
- 동영상 대시보드는 조회수를 보여준다.
- 트렌드 집계기는 급증하는 주제를 표면에 드러낸다.
모두 유용한 정보지만, 거기서 멈춘다.
대부분의 대시보드는 데이터를 보는 용도로 만들어졌을 뿐, 그 데이터를 결정에 활용하도록 설계되지 않았어. 행과 열, 필터는 보여주지만, 다음에 무엇을 해야 할지는 알려주지 않는다.
크리에이터는 다르게 생각한다. 그들은 알고 싶어한다:
- 오늘은 무엇을 올려야 할까?
- 어떤 해시태그를 사용해야 할까?
- 이 트렌드를 내 니치와 어떻게 연결할 수 있을까?
- 최대 도달을 위해 언제 올려야 할까?
나는 생각 파트너처럼 행동하는 무언가를 원했어—크리에이터가 실제로 묻는 질문, ***다음에 무엇을 해야 할까?***에 답해 주는 도구 말이야.
Source: …
내가 원하던 것을 만들었다
ContentCompass 라는 이름을 붙였다. 트렌드를 탐색하도록 도와준다. 그게 전부다.
Python과 Streamlit 으로 만들었다. 이유는 간단하다: 빠르기 때문이다!
Streamlit은 프론트엔드 프레임워크를 다루지 않고도 Python으로 인터랙티브 웹 앱을 만들 수 있게 해준다. Python만 쓰면 UI가 나온다. 사이드 프로젝트에 딱 맞다. 며칠이나 몇 주가 아니라 몇 시간 안에 기능적인 것을 만들 수 있었다.
작동 방식
앱은 네 개의 레이어로 구성된다:
1. 인식 레이어 – The Trend Hub
- 현재 플랫폼 전반에서 무슨 일이 일어나고 있는지 보여준다.
- 트렌드를 핫, 안정, 신흥 세 가지 버킷으로 정리한다.
- 이 구분이 중요한 이유는 트렌드마다 필요한 전략이 다르기 때문이다.
2. 맥락 레이어 – The Video Vault
- 실제 임베드된 동영상으로 무엇이 성공하고 있는지 보여준다.
- 동영상을 시청하고, 구조를 살펴보며, 패턴을 파악할 수 있다.
- 해당 동영상이 성공한 해시태그도 함께 제공한다.
3. 기획 레이어 – The Weekly Blueprint
- 트렌드를 5일짜리 콘텐츠 플랜으로 변환한다.
- 구체적인 영상 아이디어, 훅, 해시태그 전략, 게시 시간을 제안한다.
- 빈 캘린더를 바라보는 대신 시작점 다섯 개를 제공한다.
4. 실행 레이어 – The Brief Creator
- 어떤 트렌드나 아이디어든 공유 가능한 브리프로 변환한다.
- 트렌드가 왜 중요한지, 어떤 포맷을 써야 하는지, 어떤 해시태그를 골라야 하는지, 언제 올릴지를 포함한다.
- 편집자나 클라이언트에게 전달할 문서 형태다.
각 레이어는 이전 레이어 위에 쌓인다:
왜 AI인가?
패턴을 계획으로 전환하려면 실제 사고가 필요하다. 트렌드 탐지를 자동화할 수는 없지만, “이게 트렌드다”를 “이걸 이렇게 활용한다”로 바꾸는 과정은 자동화할 수 있다.
콘텐츠 생성(주간 플랜과 브리프) 부분—추론이 필요한 부분—에 Google Gemini 3 Flash 모델을 사용했다.
의도적으로 자동화하지 않은 부분
- 동영상 선택
- 해시태그 전략 선택
이것들은 판단이 필요한 영역이다. 앱은 옵션을 제공하지만 최종 결정은 사용자가 내린다. 이런 제약은 의도적인 선택이었다.
# Automation vs. Data
> “Much automation feels like a black box. Too little feels like a data dump.”
None of this works without good data underneath. This is where **Virlo** did the heavy lifting.데이터 출처
이 프로젝트를 시작했을 때 선택지가 있었습니다:
- 소셜 플랫폼을 직접 스크래핑한다.
- 여러 API를 사용해 연결한다.
- 자체 집계 시스템을 구축한다.
모두가 번거롭게 느껴졌습니다.
- 스크래핑은 지속적으로 깨집니다.
- 여러 API는 여러 통합과 여러 실패 지점을 의미합니다.
- 직접 집계 시스템을 구축하면 유지하고 싶지 않은 인프라를 관리해야 합니다.
제가 실제로 필요했던 것은 플랫폼 전반에 걸친 신뢰할 수 있는 트렌드 데이터—의미 있는 트렌드, 일관된 해시태그 데이터, 그리고 믿을 수 있는 영상 성과 지표였습니다. 바로 Virlo가 제공하는 것이었습니다.
Virlo의 API를 찾으면서 프로젝트 구축 방식이 바뀌었습니다.
왜 Virlo인가?
- 전 세계 최대 단편형 데이터 집계 서비스 – TikTok, YouTube Shorts, Instagram Reels에서 150만 개 이상의 영상을 분석합니다.
- 매 24시간마다 268개 이상의 트렌드가 등장합니다.
- 전 세계 1,700개 이상의 팀이 이를 활용하고 있습니다.
이는 단순한 API가 아니라 실제 인프라였습니다.
실제 플랫폼에서 온 데이터
Virlo의 API는 TikTok, YouTube, Instagram Reels 등과 연결됩니다. 스크래핑된 데이터나 추정값이 아니라, 현재 플랫폼이 생성하고 있는 실제 트렌드 신호를 제공합니다. 데이터는 하루에 두 번 새로 고침됩니다.
- Trends 엔드포인트 → Trend Hub를 구동합니다.
- Hashtags 엔드포인트 → 분석 및 통계를 제공합니다.
- Videos 엔드포인트 → 상위 성과 콘텐츠를 노출합니다.
크로스‑플랫폼의 중요성
TikTok, YouTube Shorts, Instagram Reels를 모두 집계하면 편협한 시각을 피하고, 무엇이 공감대를 형성하고 있는지 더 포괄적으로 파악할 수 있습니다.
API 사용성
API 문서는 명확하고 직관적입니다. 크레딧 기반 요금 모델을 사용합니다:
- 트렌드 조회가 해시태그 조회보다 비용이 높습니다.
- 영상 조회가 니치 검색보다 비용이 높습니다.
이 구조 덕분에 설계를 더 스마트하게 해야 했습니다. 데이터를 계속 새로 고칠 수 없었고, 캐시를 효율적으로 사용하고 사용자가 실제로 필요로 하는 데이터만 가져오도록 해야 했습니다.
개발자를 위한 핵심 요약
트렌드 데이터나 소셜 분석이 필요한 어떤 작업이든, Virlo를 한 번 살펴볼 가치가 있습니다.
내가 이것을 만들면서 배운 것
이건 트렌드에 관한 이야기가 아니었다. 모두가 숫자를 외치는 가운데 명확하게 생각하는 것이 중요했다. 트렌드는 단지 변명일 뿐이었다.
무언가를 처음 시작할 때—크리에이터 계정이든 사이드 비즈니스든— 명확함이 전부다. 하지만 명확함은 더 많은 데이터에서 오는 것이 아니라, 데이터를 처리하는 더 나은 방법에서 온다.
ContentCompass는 그 중 하나일 뿐이다. 유일한 방법도, 가장 좋은 방법도 아니다. 하지만 내가 필요로 했던 것이었다.
무언가가 흐릿하게 느껴진다면, 명확함을 기다리지 말고 렌즈를 만들어라. 작은 것이든 말이다.
왜냐하면…
명확함은 종종 배포 후에 나타난다.
📝 Table of Contents
🧐 소개
ContentCompass는 Python과 Streamlit으로 구축된 크리에이터 중심 트렌드 인텔리전스 및 콘텐츠 기획 도구입니다. 두 가지 운영 모드를 제공합니다:
| 모드 | 설명 |
|---|---|
| Demo Mode | 로컬에서 생성된 JSON 샘플 데이터를 사용합니다; 외부 API 호출이 없습니다. |
| Live Mode | Virlo API에 BYOK 인증으로 연결하여 실시간 데이터를 제공합니다. |
앱은 크리에이터에게 다음을 돕습니다:
- 트렌드가 되는 콘텐츠와 떠오르는 주제를 발견합니다.
- 해시태그 전략을 최적화합니다.
- Gemini AI를 사용해 실행 가능한 콘텐츠 브리프를 생성합니다.
주요 기능
- Trend Hub – 가장 인기 있고, 안정적이며, 떠오르는 트렌드를 탐색합니다.
- Hashtag Lab – 전략적인 해시태그 조합을 생성합니다 (안전, 높은 도달, 틈새 등).
- Content Scout – 틈새 아이디어와 상위 성과 비디오를 식별합니다.
- Weekly Planner – AI가 생성한 아이디어로 주간 콘텐츠 캘린더를 만듭니다.
- Brief Builder – 팀을 위한 전문 브리프를 작성합니다. 카피, 해시태그, 시각적 제안까지 포함합니다.
시도해 보세요!
- Code:
- Live demo: