# solari fetch tiktok account

> TikTok のハンドルを 1 件カタログに取り込みます。

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

正確なユーザー名を指定して、TikTok アカウントを 1 件 SOLARI のカタログに追加します。検索ではありません。すでに保存済みの場合は何も取得しません。

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

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

## パラメータ

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

## レスポンス

### `Response`

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

## 例

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

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

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

## MCP で呼び出す場合

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

## 注意点

- 名前の検索には使わないでください。先にカタログのアカウント検索を使います。
- 初回の取り込みには 10〜40 秒かかることがあります。クロールが終わるまでは、最近の投稿しかありません。

## 関連ツール

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