# solari fetch tiktok posts

> Collect one TikTok account's posts into the catalog.

- **CLI**: `solari fetch tiktok posts`
- **MCP ツール**: `solari_fetch_tiktok_posts`
- **アクセス権**: `solari:read` — サインイン済みの SOLARI アカウントであれば利用できます。
- **Required plan**: Free
- **Credit**: 0

Collect posts for one TikTok account into the SOLARI catalog by exact username. This is not a post listing. If the handle is already stored, nothing is scraped.

**どんなときに使うか** — When catalog posts does not know an exact handle you already have.

**何が返るか** — Whether it was ingested, how many posts came back, and the catalog command to read them.

## パラメータ

- `username` (string, 必須, ≤ 64 chars) — TikTok username.

## レスポンス

### `Response`

- `ingested` (boolean) — true if this call collected it live.
- `already_tracked` (boolean) — true if it was already in the catalog.
- `fetched_on_demand` (boolean) — Same as ingested.
- `found` (boolean) — false if the handle could not be collected.
- `account_id` (uuid) — The ingested account.
- `username` (string) — Resolved handle.
- `total` (integer) — Posts available so far.
- `note` (string) — What to expect next.
- `next` (string) — Catalog command to read the result.

## 例

```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"
  }
}
```

## 注意点

- Do not use this to list stored posts. Use catalog tiktok account posts for that.
- A first-time ingest can take 10 to 40 seconds. Only recent posts exist until the crawl finishes.

## 関連ツール

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