tiktok · contentsolari:read

solari tiktok content search

TikTok 캡션과 영상 전사문을 가로지르는 키워드 검색.

MCP 도구: solari_tiktok_content_search
CLI: solari tiktok content search
권한: solari:read로그인한 SOLARI 계정이면 쓸 수 있어요.로그인한 SOLARI 계정이면 쓸 수 있어요.

개요

추적 중인 TikTok 포스트에 대한 렉시컬 키워드 검색. 캡션과 영상 전사문에 매칭하며(한국어 분석 + n-gram 부분 일치), 관련도 순으로 정렬되고 매치 하이라이트가 함께 와요. 각 item은 post_id, video_id, url, 작성자 account_id/username, caption, transcription_text, post_type, posted_at, 재생/좋아요/댓글/공유/저장 수, follower_count, duration_seconds, is_ad, cover_url, score, highlight를 담아요. post_id는 solari_tiktok_content_detail이나 solari_tiktok_content_batch에, 계정 참조는 solari_tiktok_account_* 툴에 넘기면 돼요. 커버리지: KR, JP, US, TW 리전만 검색할 수 있고 대략 최근 6개월치 포스트를 담아요. total은 10,000까지 정확하고 거기서 포화해요. since/until(UTC 날짜)로 범위를 좁혀요. 로그인된 SOLARI 계정이면 누구나 사용할 수 있어요.

언제 쓰나 — 주제로, 또는 화면에서 실제로 말한 내용으로 TikTok 포스트를 찾을 때.

무엇이 돌아오나 — 관련도 순 히트. 하이라이트와 전사문 텍스트 포함.

파라미터

querystring필수: 캡션과 영상 전사문에 매칭되는 자유 텍스트 키워드 쿼리.
regionenum선택: 검색할 리전. 이 네 개 리전만 인덱싱되어 있어요.기본값 "KR"값KRJPUSTW
limitinteger선택: 최대 히트 수, 기본값 20. 100을 넘는 값은 100으로 잘려요.≥ 1
offsetinteger선택: 페이지네이션 offset, 기본값 0. 9800을 넘는 값은 9800으로 잘려요.기본값 0≥ 0
sincestring선택: 이 UTC 날짜 이후(당일 포함, YYYY-MM-DD)의 포스트만. 약 6개월보다 오래된 데이터는 인덱싱되지 않아요.pattern ^\d{4}-\d{2}-\d{2}$
untilstring선택: 이 UTC 날짜 이전(당일 포함, YYYY-MM-DD)의 포스트만.pattern ^\d{4}-\d{2}-\d{2}$

응답

Response

query / regionstring: 적용된 query와 region.
totalinteger: 전체 매치 수. 10,000까지 정확하고 그 뒤로는 포화해요.
took_msinteger: 검색 소요 시간.
itemsobject[]: 히트 목록. score 내림차순.

items[]

post_id / video_id / urlstring: 포스트 식별자와 공개 링크.
account_id / usernamestring: 작성 계정.
captionstring: 캡션 텍스트.
user_biostring: 작성자 bio.
transcription_textstring | null: 음성 전사문 — 검색 대상 텍스트에 포함돼요.
transcription_languagestring | null: 전사문 언어 코드.
post_typestring: video 또는 carousel.
posted_attimestamp: 게시 시각(UTC).
duration_secondsinteger: 영상 길이.
play_count / like_count / comment_count / share_count / collect_countinteger: 인게이지먼트 스냅샷.
follower_countinteger: 작성자 팔로워 수.
is_adboolean: TikTok 자체 광고 플래그.
cover_urlstring: 커버 이미지.
scorenumber: 관련도 점수.
highlightobject: 필드별 매치된 조각.

예시

요청

$ solari tiktok content search query="올리브영 세일" limit=3

응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였어요.

{
  "query": "올리브영 세일",
  "region": "KR",
  "total": 4041,
  "took_ms": 29,
  "items": [
    {
      "post_id": "01a05c46-9a08-7e92-a40e-b1a039103118",
      "video_id": "7679484556189207815",
      "url": "https://www.tiktok.com/@flos_bonita/video/7679484556189207815",
      "account_id": "0196cb39-87a7-7be3-ac4a-4a80b7818a90",
      "username": "flos_bonita",
      "caption": "태닝한 산리오 키링이라니…☀️🥹💗 푸드올로지 X 산리오 콜라보 실물 너무 귀엽잖아!! 헬로키티·쿠로미·한교동·마이멜로디까지🎀 제품마다 다른 키링이라 산리오 덕후들 취향 제대로 저격💘 올영 세일 시작했으니 얼른 구경해봐요👀🛒 #푸드올로지 #태닝키티 #올리브영추천템 #올영세일",
      "user_bio": "화미 프로필 링크",
      "transcription_text": "살리오 덕후라면 절대 그냥 넘길 수 없는 영상 오늘부터 시작인 올리브영 세일과 함께 푸드올로지와 살리오 콜라보 나왔어요 이번 콜라보는 젤리 폼 앰플 젤리 3 종으로 피디아렌 앰플 젤리 글루타치원 씨 앰플 젤리 히알루론산 앰플 젤리까지 제품마다 귀여운 살리오 굿즈도 함께 만나 볼 수 있는데 헬로키티 크로미 한교동부터 마이 멜로디까지 저는 역시 헬로키티 더 쿠답게 키티 키링으로 폼구 최애 캐릭터 …",
      "transcription_language": "ko",
      "post_type": "video",
      "posted_at": "2026-08-29T16:02:22Z",
      "duration_seconds": 37,
      "play_count": 955,
      "like_count": 26,
      "comment_count": 0,
      "share_count": 0,
      "collect_count": 5,
      "follower_count": 1345,
      "is_ad": true,
      "cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-p-0037/oEu4VAolaEBAAYjMAjBtiyCIAABiPp9TOCAME~tplv-tiktokx-origin.image?dr=10395&x-expires=1788426000&x-signature=FAP0C10M1M1gEwD4YMB03pYd0YA%3D&t=4d5b0474&ps=13740610&sh …",
      "score": 53.787056,
      "highlight": {
        "caption": [
          "헬로키티·쿠로미·한교동·마이멜로디까지🎀 제품마다 다른 키링이라 산리오 덕후들 취향 제대로 저격💘 올<mark>영</mark> <mark>세일</mark> 시작했으니 얼른 구경해봐요👀🛒 #푸드올로지 #태닝키티 #올리브영추천템 #올영세일"
        ],
        "user_bio": [],
        "transcription_text": [
          "살리오 덕후라면 절대 그냥 넘길 수 없는 영상 오늘부터 시작인 <mark>올리브</mark><mark>영</mark> <mark>세일</mark>과 함께 푸드올로지와 살리오 콜라보 나왔어요 이번 콜라보는 젤리 폼 앰플 젤리 3 종으로 피디아렌 앰플 젤리 글루타치원 씨 앰플 젤리 히알루론산 앰플 젤리까지 제품마다 귀여운 살리오 굿즈도 함께",
          "… 1 more"
        ]
      }
    },
    "… 2 more"
  ]
}

MCP 호출로 쓰면

{
  "name": "solari_tiktok_content_search",
  "arguments": {
    "query": "올리브영 세일",
    "limit": 3
  }
}

주의사항

인덱스는 KR, JP, US, TW를 대략 최근 6개월치로 커버해요.
offset은 9,800에서 상한이 걸려요. 더 깊이 보려면 날짜 범위를 좁혀 다시 검색해 보세요.
total은 10,000까지 정확하고 거기서 멈춰요.

기계가 읽는 형식: /docs/tools/tiktok-content-search.md

개요

파라미터

응답

예시

주의사항

관련 도구