# solari catalog tiktok content search

> 収集済みの TikTok のキャプションと動画の文字起こしを、期間を指定して検索します。

- **CLI**: `solari catalog tiktok content search`
- **MCP ツール**: `solari_catalog_tiktok_content_search`
- **アクセス権**: `solari:read`
- **対象プラン**: 無料トライアル · Plus · Pro · Enterprise
- **クレジット**: 1

KR・JP・US・TW で収集済みの TikTok 投稿を、キーワードで検索します。対象はおよそ直近 6 か月です。TikTok のカタログは小さいので、まず fetch tiktok post search から始め、期間の指定が必要なときにこのツールを使います。

**どんなときに使うか** — 特定の期間の TikTok 投稿や、動画内で話されている内容から投稿を探したいとき。トピックで投稿を探すなら、まず fetch tiktok post search を使います。

**返される内容** — 関連度順の投稿。一致したテキストはハイライトされます。

## パラメータ

- `query` (string, 必須) — 検索するキーワード。
- `region` (enum, 任意, 既定値 "KR") — KR、JP、US、TW のいずれか。 値: `KR`, `JP`, `US`, `TW`.
- `limit` (integer, 任意, 既定値 20, 1–100) — 1 ページあたりの投稿数。
- `offset` (integer, 任意, 既定値 0, 0–9800) — スキップする投稿数。
- `since` (string, 任意, pattern ^\d{4}-\d{2}-\d{2}$) — この UTC 日付（YYYY-MM-DD）以降の投稿のみ。
- `until` (string, 任意, pattern ^\d{4}-\d{2}-\d{2}$) — この UTC 日付（YYYY-MM-DD）以前の投稿のみ。

## レスポンス

### `Response`

- `query / region` (string) — 適用したクエリと地域。
- `total` (integer) — 一致した総件数。10,000 件までは正確で、それを超えると 10,000 件で止まります。
- `took_ms` (integer) — 検索にかかった時間。
- `items` (object[]) — 検索結果（スコアの高い順）。

### `items[]`

- `post_id / video_id / url` (string) — 投稿の識別子と公開リンク。
- `account_id / username` (string) — 投稿したアカウント。
- `caption` (string) — キャプション。
- `user_bio` (string) — 投稿者のプロフィール文。
- `transcription_text` (string | null) — 動画の文字起こし。検索対象のテキストに含まれます。
- `transcription_language` (string | null) — 文字起こしの言語コード。
- `post_type` (string) — video または carousel。
- `posted_at` (timestamp) — 投稿日時（UTC）。
- `duration_seconds` (integer) — 動画の長さ。
- `play_count / like_count / comment_count / share_count / collect_count` (integer) — エンゲージメント。
- `follower_count` (integer) — 投稿者のフォロワー数。
- `is_ad` (boolean) — TikTok 自体の広告フラグ。
- `cover_url` (string) — カバー画像。
- `score` (number) — 関連度スコア。
- `highlight` (object) — フィールドごとの一致箇所。
- `assets` (object[]) — メディアファイル（掲載順）。それぞれに asset_url、media_type、video_duration があります。
- `assets[].asset_url` (string | null) — フルサイズの画像または動画の直接ダウンロードリンク。ファイルが保存されていない場合は null。
- `region_inferred` (boolean) — 投稿者の国が不明で、キャプションの言語から地域を決めた投稿なら true です。

## 例

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

_読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。_

```json
{
  "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 で呼び出す場合

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

## 注意点

- offset の上限は 9,800 です。それより先を見るには期間を絞り込んでください。
- total は 10,000 件まで数え、それ以上は数えません。
- 投稿者の国が不明な場合、投稿はキャプションの言語に対応する地域に入り、region_inferred=true が付きます。

## 関連ツール

- [`solari_insight_tiktok_content_aggregate`](https://clip-pub.bzine.co/docs/tools/insight-tiktok-content-aggregate.md?lang=ja)
- [`solari_catalog_tiktok_content_batch`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-content-batch.md?lang=ja)
- [`solari_catalog_instagram_content_search`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-search.md?lang=ja)