AGENT 실황
Agent는 이 데이터를 어떻게 쓸까?
실제 질문을 던지고, Agent가 스스로 도구를 호출해 데이터를 읽고 근거 있는 제안을 내놓기까지. 아래는 한 번의 전체 대화입니다.
mcp · throk
「이직」이라는 주제, 아직 메리트가 남아 있나요?
⚙ get_hot_posts⚙ get_keyword_trend⚙ search_posts
아직 상승 중입니다. 「이직」의 최근 7일 게시물 수가 3.1배 증가했고, 좋아요 5만을 넘는 천장 게시물은 아직 나오지 않았습니다:
6/07
6/09
6/11
6/13
추천 각도: 「퇴사했습니다」가 아니라 「남은 사람들은 어떻게 생각할까」를 쓰세요. 고참여 댓글의 38%가 아직 퇴사하지 않은 관망층에서 나오는데, 이들은 대변인을 찾고 있습니다.
연결 방법
MCP 또는 REST
Agent에는 MCP, 서비스에는 REST.
02 · REST API
REST API
또는 REST를 직접 호출
THREADS API 요금
월 US$30부터, 월 크레딧에 따라 선택하세요.
4개 요금제 모두 전체 API 엔드포인트를 제공합니다. Throk MCP와 REST API는 같은 개발자 크레딧을 사용합니다.
답할 수 있는 질문
AI Agent는 Throk으로 무엇을 조회할 수 있나요?
먼저 내려야 할 결정을 정하고 필요한 Threads 데이터를 선택하세요. 도구 이름과 제한은 기술 자료에 정리했습니다.
- 01
주제와 수요 찾기
게시물, 의미가 유사한 콘텐츠, 키워드 언급량을 검색합니다.
- 02
경쟁사와 계정 보기
최근 콘텐츠, 인기 게시물, 팔로워 변화를 확인합니다.
- 03
트렌드와 타이밍 찾기
인기·성장 랭킹과 게시 시간대를 확인합니다.
13개 도구와 조회 제한 보기＋
전체 도구 목록
13개 도구, 하나의 키
키워드·시맨틱 검색, 인기·급상승 랭킹, 신의 답글과 팔로워 증가부터 골든타임 히트맵, 팔로워·좋아요 백분위, 사용자 프로필과 팔로워 히스토리까지.
| 도구 | 반환 | 상한 |
|---|---|---|
| search_posts | 키워드로 공개 게시물 검색 | 25건 / 회 |
| get_inspiration | 주제로 고참여 게시물 시맨틱 검색 | 10건 |
| get_hot_posts | 인기 게시물 랭킹 | 50건 |
| get_keyword_trend | 키워드 일별 게시량 | 10단어 × 90일 |
| get_post_like_growth | 급상승 게시물 랭킹 | 50건 |
| get_cool_replies | 신의 답글 랭킹 | 50건 |
| get_follower_growth | 팔로워 급증 랭킹 | 50건 |
| get_power_hours | 플랫폼 골든타임 히트맵 | 최근 28일 |
| get_follower_ladder | 팔로워 수 백분위 | 백분위 |
| get_like_ladder | 좋아요 수 백분위 | 최근 24시간 |
| get_user | 사용자 프로필과 최근 게시물 | 각 25건 |
| get_user_top_threads | 사용자의 좋아요 상위 게시물 | 최대 720일 |
| get_user_follower_history | 팔로워 수 히스토리 | 최대 365일 |
자주 묻는 질문
- API 크레딧은 Throk 구독제와 같나요?
- 아닙니다. 개발자 플랫폼에는 독립된 API 요금제와 크레딧이 있으며, 웹 버전의 Free／Creator／Creator+ 구독과 완전히 분리되어 서로 호환되지 않습니다. 개발자 콘솔에서 별도로 구독해야 합니다.
- 무료 한도가 있나요? 요금은?
- API 액세스에는 무료 한도가 없습니다. 요금제는 월 크레딧 한도로 나뉘며, API Lite(월 15,000 크레딧)부터 Premium(월 6,000,000 크레딧)까지 개발자 콘솔에서 구매할 수 있습니다.
- 크레딧은 언제 만료되나요?
- 크레딧은 구매일로부터 1개월간 유효하며, 사용하지 않은 크레딧은 다음 주기로 이월되지 않습니다. 더 필요하면 상위 요금제로 업그레이드하거나 요금제 단가(API Standard US$10, Plus US$5, Premium US$4 / 10,000 크레딧)로 일회성 추가 구매를 할 수 있습니다. 추가 크레딧은 현재 청구 주기 종료 시 초기화됩니다.
- MCP와 REST 중 무엇을 쓰나요? 지원 클라이언트는?
- AI 에이전트에 쓰려면 MCP를 사용하세요. Claude, Cursor 등을 지원하며 명령어 한 줄로 연결됩니다. 직접 서비스에서 호출하려면 REST를 쓰세요. 모든 기능은 양쪽 모두 지원됩니다.
- 데이터 범위는?
- Threads 공개 게시물의 검색, 인기 랭킹, 키워드 트렌드, 사용자 프로필, 팔로워 히스토리를 다루며, 지역에 따라 번체 중국어·일본어·한국어 시장을 지원합니다.
- 어떻게 시작하나요?
- developer.throk.ai에서 가입하고 API 키를 발급한 뒤 요금제를 선택하면 호출을 시작할 수 있습니다.