콘텐츠로 이동

Throk API·MCP 업데이트 내역

Throk API(premium-api.throk.ai)와 MCP 도구의 업데이트 내역입니다. 최신 항목이 맨 위에 있습니다. MCP 표시가 있는 항목은 해당 MCP 도구에도 적용됩니다.

  • 새 기능: 키워드 트렌드(/post/keyword-trend, MCP get_keyword_trend)에 include_engagement 매개변수가 추가되었습니다. 일별 게시물 수와 함께 해당 게시물들의 좋아요 수, 답글 수, 리포스트 수, 공유 수 합계도 반환합니다. 사용하면 키워드당 하루 4크레딧(기존 3크레딧)이며, 사용하지 않으면 응답과 요금 모두 이전과 같습니다.
  • 개선: 대량의 계정 일괄 조회가 다른 실시간 조회를 느리게 만들지 않습니다.
  • 새 기능: /post/search와 MCP search_postsmin_age_hours, max_age_hours가 추가되어 「게시 후 몇 시간」으로 검색 범위를 바로 지정할 수 있습니다(최대 90일).
  • 개선: /post/{code}/chain이 실시간으로 수집한 답글을 합쳐 반환하므로, 아직 수집되지 않은 게시물도 조회할 수 있습니다.
  • 개선: /user와 계정 일괄 조회에서 데이터가 부족하면 실시간 계정 데이터를 사용합니다.
  • 개선: /live/posts 응답에 media_urlreshare_count가 추가되었습니다. MCP get_live_posts는 항상 미디어 URL을 반환합니다.
  • 개선: 바이럴 예측(/post/forecast, MCP forecast_posts)을 게시 후 1시간부터 사용할 수 있으며(기존 2시간), 예측 모델도 업데이트되었습니다. 게시 후 1–2시간 된 게시물도 이제 과금됩니다.
  • 새 기능: GET /live/posts, GET /live/users와 MCP get_live_posts, get_live_users. Threads에서 게시물과 계정의 현재 수치를 실시간으로 읽어 오며, 게시 시점이나 계정에 제한이 없습니다. 게시물 또는 계정 1개당 3크레딧이며, Threads가 조회수를 숨긴 경우 1크레딧입니다. 읽기에 실패하면 과금하지 않습니다.
  • 개선: /user/{username}/top-threads에서 긴 기간을 조회할 때 속도가 크게 빨라졌습니다.
  • 수정: 빈 결과를 반환하면서 크레딧을 차감하는 문제가 더 이상 발생하지 않습니다. 백엔드를 일시적으로 사용할 수 없을 때는 503을 반환합니다.
  • 수정: 인기 게시물, 게시물 답글 체인, 시맨틱 검색, 랭킹, 계정 게시물의 post_timestamp가 실제보다 8시간 이르게 표시되던 문제를 수정했습니다.
  • 개선: 바이럴 예측에서 쉼표로 구분한 여러 게시물 코드를 받을 수 있으며, 오류 메시지가 더 명확해졌습니다. 예측 가능 기간을 벗어난 게시물은 과금하지 않습니다.
  • 수정: Webhook 테스트 이벤트 엔드포인트가 500을 반환하던 문제를 수정했습니다.
  • 새 기능: GET /post/forecast와 MCP forecast_posts(바이럴 예측). 게시물의 현재 조회수와 조회수 기준별 도달 확률, 예상 도달 시간을 반환합니다. 게시물당 10크레딧.
  • 새 기능: 새 지역 값 zh, tw, hk, cn, jp, kr. 검색, 인기 게시물, 키워드 트렌드, 랭킹, Webhook에 적용됩니다. twcn은 번체와 간체를 구분합니다. 기존 chinese, japanese, korean도 계속 사용할 수 있습니다. 자세한 내용은 지역과 언어를 참고하세요.
  • 개선: 시맨틱 검색 REST API가 한 번에 최대 3000개 게시물을 반환할 수 있습니다. 좋아요 수와 답글 수 기준은 의미 매칭 이후에 적용됩니다.
  • 개선(MCP): 모든 도구 설명에 가격이 표시됩니다. 사다리 계열 도구에서 지역을 지정할 수 있습니다.
  • 새 기능: GET /post/semantic-search와 MCP semantic_search_posts(시맨틱 검색). 주제를 한 문장으로 설명하면 최근 30일 안에서 의미가 가장 가까운 게시물을 찾아 주며, 각 결과에 관련도 점수가 붙습니다. 처음 10개에 30크레딧, 이후 1개당 2크레딧. 자세한 내용은 시맨틱 검색을 참고하세요.
  • 새 기능: Webhook 규칙에 조회수(view_count) 기준을 설정할 수 있습니다(07-23).
  • 새 기능: Webhook 규칙을 언어나 시장별로 필터링할 수 있습니다(07-15).
  • 개선: 인기 게시물, 게시물 답글 체인, 상세 정보 포함 검색, 계정 조회, 계정 인기 게시물이 조회수 impression_count를 반환합니다(07-13).
  • 수정: 인기 게시물을 조회수순으로 정렬하면서 홍콩이나 언어 필터를 함께 쓸 때 발생하던 문제를 수정했습니다(07-15).
  • 개선(MCP): 도구 호출이 60초를 넘으면 멈춰 있지 않고 안내 메시지를 반환합니다(07-11).
  • 변경: Webhook을 만들려면 API Standard 이상 요금제가 필요합니다.
  • 변경: Webhook 규칙에 최소 좋아요 수와 답글 수 기준이 적용됩니다.
  • 새 기능: 검색, 인기 게시물, 키워드 트렌드에 language 매개변수(chinese, hk, japanese, korean)가 추가되었습니다.
  • 새 기능: REST 랭킹·통계 엔드포인트. /leaderboard/cool-replies(명댓글), /leaderboard/post-like-growth(바이럴 게시물), /leaderboard/follower-growth(팔로워 증가), /stats/follower-ladder, /stats/like-ladder, /stats/power-hours, /post/inspiration(영감 검색).
  • 새 기능(MCP): get_cool_replies, get_post_like_growth, get_follower_growth, get_follower_ladder, get_like_ladder, get_power_hours, get_inspiration 도구가 추가되었습니다.
  • 새 기능(MCP): MCP 서버 https://premium-api.throk.ai/mcp 출시. REST API와 같은 키와 가격을 사용합니다. 첫 도구: search_posts, get_hot_posts, get_keyword_trend, get_user, get_user_top_threads, get_user_follower_history, get_balance. 설정 방법은 AI 어시스턴트에서 사용하기(MCP)를 참고하세요.
  • 새 기능: Webhook 「인기 임계값」 규칙. 키워드를 비워 둘 수 있으며, 조회 기간을 1–72시간으로 설정할 수 있습니다.