# solari fetch tiktok posts

> TikTok アカウント 1 件の投稿をカタログに収集します。

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

正確なユーザー名を指定して、TikTok アカウント 1 件の投稿を SOLARI のカタログに収集します。投稿の一覧を返すツールではありません。すでに保存済みのハンドルの場合は何も取得しません。

**どんなときに使うか** — 正確なハンドルがわかっているのに、カタログの投稿一覧で見つからないとき。

**返される内容** — 取り込んだかどうか、返ってきた投稿の件数、結果を読むためのカタログコマンド。

## パラメータ

- `username` (string, 必須, ≤ 64 chars) — TikTok のユーザー名。

## レスポンス

### `Response`

- `ingested` (boolean) — この呼び出しでその場で収集した場合は true。
- `already_tracked` (boolean) — すでにカタログにあった場合は true。
- `fetched_on_demand` (boolean) — ingested と同じ。
- `found` (boolean) — ハンドルを収集できなかった場合は false。
- `account_id` (uuid) — 取り込んだアカウント。
- `username` (string) — 特定したハンドル。
- `total` (integer) — 現時点で取得できる投稿。
- `note` (string) — この後に起きること。
- `next` (string) — 結果を読むためのカタログコマンド。

## 例

```console
$ solari fetch tiktok posts username=innisfree_official
```

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

```json
{
  "ingested": false,
  "already_tracked": true,
  "fetched_on_demand": false,
  "found": true,
  "account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
  "username": "innisfree_official",
  "total": 12,
  "note": "Already in the SOLARI catalog. Nothing was scraped.",
  "next": "solari catalog tiktok account posts username=innisfree_official"
}
```

## MCP で呼び出す場合

```json
{
  "name": "solari_fetch_tiktok_posts",
  "arguments": {
    "username": "innisfree_official"
  }
}
```

## 注意点

- 保存済みの投稿を一覧表示する用途には使わないでください。その場合は catalog tiktok account posts を使います。
- 初回の取り込みには 10〜40 秒かかることがあります。クロールが終わるまでは、最近の投稿しかありません。

## 関連ツール

- [`solari_fetch_tiktok_account`](https://clip-pub.bzine.co/docs/tools/fetch-tiktok-account.md?lang=ja)
- [`solari_catalog_tiktok_account_posts`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-posts.md?lang=ja)
- [`solari_catalog_tiktok_account_search`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-search.md?lang=ja)