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、play/like/comment/share/collectの各カウント、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任意: 検索対象のリージョン。インデックスがあるのはこの4リージョンのみ。既定値 "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: 投稿の各種IDと公開リンク。
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

概要

パラメータ

レスポンス

例

注意点

関連ツール