API ・ MCP
당신의 Agent에게도,Threads의 눈을.
명령어 한 줄로 Throk을 Claude, Cursor 또는 직접 만든 프로그램에 연결하세요. Agent는 바이럴 게시물을 검색하고, 트렌드를 조회하고, 계정을 읽습니다. 모든 답 뒤에는 검증된 숫자가 있습니다.
terminal
streamable http・stateless
# 명령어 한 줄로 Claude Code에 연결
claude mcp add --transport http throk \
https://premium-api.throk.ai/mcp \
--header "Authorization: Bearer sk-throk-..."개발자, AI 에이전트, Threads 데이터를 연동하려는 제품을 위한 것입니다.
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%가 아직 퇴사하지 않은 관망층에서 나오는데, 이들은 대변인을 찾고 있습니다.
전체 도구 목록
6개 도구, 하나의 키
키워드 검색, 인기 랭킹, 트렌드부터 사용자 프로필과 팔로워 히스토리까지.
| 도구 | 반환 | 상한 |
|---|---|---|
| search_posts | 키워드로 공개 게시물 검색 | 25건 / 회 |
| get_hot_posts | 인기 게시물 랭킹 | 50건 |
| get_keyword_trend | 키워드 일별 게시량 | 10단어 × 90일 |
| get_user | 사용자 프로필과 최근 게시물 | 각 25건 |
| get_user_top_threads | 사용자의 좋아요 상위 게시물 | 최대 720일 |
| get_user_follower_history | 팔로워 수 히스토리 | 최대 365일 |
연결 방법
MCP 또는 REST
Agent에는 MCP, 서비스에는 REST.
MCP Server
Claude, Cursor 등 MCP 지원 클라이언트에 명령어 한 줄로 연결.
{
"throk": {
"url": "https://premium-api.throk.ai/mcp",
"headers": {
"Authorization": "Bearer sk-throk-..."
}
}
}REST API
GET · POST · Bearer auth
# 또는 REST를 직접 호출
curl "https://premium-api.throk.ai/post/hot?size=30" \
-H "Authorization: Bearer sk-throk-..."자주 묻는 질문
- API 크레딧은 Throk 구독제와 같나요?
- 아닙니다. 개발자 플랫폼에는 독립된 API 요금제와 크레딧이 있으며, 웹 버전의 Free／Creator／Creator+ 구독과 완전히 분리되어 서로 호환되지 않습니다. 개발자 콘솔에서 별도로 구독해야 합니다.
- 무료 한도가 있나요? 요금은?
- API 액세스에는 무료 한도가 없습니다. 요금제는 월 크레딧 한도로 나뉘며, API Lite(월 15,000 크레딧)부터 Premium(월 6,000,000 크레딧)까지 개발자 콘솔에서 구매할 수 있습니다.
- 크레딧은 언제 만료되나요? 추가 구매할 수 있나요?
- 크레딧은 구매일로부터 1개월간 유효하며, 다 쓰지 않아도 다음 기간으로 이월되지 않습니다. API Standard 이상 요금제는 언제든 추가 구매할 수 있고, 추가 크레딧은 해당 기간 요금제와 함께 만료됩니다.
- MCP와 REST 중 무엇을 쓰나요? 지원 클라이언트는?
- AI 에이전트에 쓰려면 MCP를 사용하세요. Claude, Cursor 등을 지원하며 명령어 한 줄로 연결됩니다. 직접 서비스에서 호출하려면 REST를 쓰세요. 모든 기능은 양쪽 모두 지원됩니다.
- 데이터 범위는?
- Threads 공개 게시물의 검색, 인기 랭킹, 키워드 트렌드, 사용자 프로필, 팔로워 히스토리를 다루며, 지역에 따라 번체 중국어·일본어·한국어 시장을 지원합니다.
- 어떻게 시작하나요?
- developer.throk.ai에서 가입하고 API 키를 발급한 뒤 요금제를 선택하면 호출을 시작할 수 있습니다.