Throk MCP 설정: Claude, Cursor에서 Threads 데이터 조회하기

Throk은 MCP(Model Context Protocol) 서버를 제공합니다. 설정을 마치면 AI 어시스턴트에게 자연어로 데이터 조회를 요청할 수 있습니다. 예:

「減脂」의 최근 30일 대만 언급량 추이를 보여 주고, 좋아요 수가 가장 많은 게시물 5개를 찾아 도입부를 어떻게 썼는지 정리해 줘.

연결 정보

항목	값
URL	https://premium-api.throk.ai/mcp
전송 방식	Streamable HTTP
인증	헤더 Authorization: Bearer sk-throk-...(REST API와 같은 키 사용)

설치

개발자 플랫폼의 MCP 서버 페이지에도 AI 도구별 설정 예시가 있어 그대로 복사해 쓸 수 있습니다.

Claude Code

claude mcp add --transport http throk \
  https://premium-api.throk.ai/mcp \
  --header "Authorization: Bearer sk-throk-..."

Claude Desktop

설정 파일의 mcpServers에 다음을 추가합니다.

{
  "mcpServers": {
    "throk": {
      "url": "https://premium-api.throk.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-throk-..."
      }
    }
  }
}

Cursor

.cursor/mcp.json에 같은 설정을 추가합니다.

{
  "mcpServers": {
    "throk": {
      "url": "https://premium-api.throk.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-throk-..."
      }
    }
  }
}

사용 가능한 도구

모든 도구는 읽기 전용입니다.

검색

도구	용도	크레딧
search_posts	키워드로 게시물 검색(최대 25건)	게시물당 1크레딧(상세 정보 포함 시 게시물당 2크레딧)
semantic_search_posts	최근 30일 게시물을 의미로 검색(최대 10건)	30크레딧
get_inspiration	고참여 엄선 게시물에서 영감 찾기(최대 10건)	30크레딧
get_hot_posts	인기 게시물(30–50건)	70크레딧부터, 1개 추가될 때마다 2크레딧 추가(조회수순 정렬 시 100크레딧부터)
get_keyword_trend	키워드 일별 언급량(최대 키워드 10개, 90일)	3크레딧 × 키워드 수 × 일수(참여 지표 포함 시 4크레딧)

계정

도구	용도	크레딧
get_user	계정 정보와 최근 게시물	1크레딧, 게시물 5개마다 1크레딧 추가
get_user_top_threads	계정에서 좋아요 수가 가장 많은 게시물	70크레딧부터
get_user_follower_history	계정의 일별 팔로워 수(최대 365일)	일수 ÷ 3(올림), 최소 1크레딧

랭킹

도구	용도	크레딧
get_cool_replies	명댓글 순위	70크레딧부터
get_post_like_growth	바이럴 게시물(좋아요가 가장 빠르게 늘어나는 게시물)	70크레딧부터
get_follower_growth	팔로워가 가장 빠르게 늘어나는 계정	70크레딧부터
get_follower_ladder	팔로워 수 사다리(구간별 기준값)	5크레딧
get_like_ladder	좋아요 수 사다리(최근 24시간)	5크레딧
get_power_hours	플랫폼 황금 시간대(최근 28일)	5크레딧

실시간 데이터와 예측

도구	용도	크레딧
forecast_posts	게시 후 1–12시간 이내 게시물이 조회수 기준에 도달할지 예측	게시물당 10크레딧
get_live_posts	게시물의 현재 수치를 실시간으로 조회(게시 시점 제한 없음)	게시물당 3크레딧(조회수가 숨겨진 경우 1크레딧)
get_live_users	계정의 현재 팔로워 수와 정보를 실시간으로 조회	계정당 3크레딧

계정 잔액

도구	용도	크레딧
get_balance	남은 크레딧 조회	무료

REST API와의 차이

• 건수 상한이 더 작습니다. 응답을 간결하게 유지하기 위해서입니다. 예: search_posts는 최대 25건, semantic_search_posts는 최대 10건. 대량의 데이터가 필요하면 REST API를 사용하세요.
• 미디어 URL과 프로필 사진 URL은 기본적으로 포함되지 않습니다. 필요하면 이 매개변수를 지원하는 도구에 include_media=true를 추가하세요.
• 호출당 타임아웃은 60초입니다.
• 검색 규칙은 REST API와 완전히 같습니다. 검색 규칙을 참고하세요.