# solari fetch threads account

> Threads アカウントのプロフィールを 1 件、ライブで読みます。

- **CLI**: `solari fetch threads account`
- **MCP ツール**: `solari_fetch_threads_account`
- **アクセス権**: `solari:read` — トライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。
- **対象プラン**: 有料プランまたはトライアル
- **クレジット**: 1

正確なユーザー名で Threads アカウントのプロフィールを読みます。表示名、自己紹介(bio)、フォロワー数、認証・非公開のフラグ、bio のリンク、プロフィール画像が返ります。SOLARI では Threads は fetch 専用なので、catalog や insight の手順はなく、この呼び出しがそのままプロフィールの読み取りです。SOLARI が初めて見るハンドルはその場で収集し(5〜30 秒)、1 時間以内の再呼び出しは保存済みのコピーを使い回します。refresh=true で新しく収集します。

**どんなときに使うか** — 正確な Threads ハンドルがあり、そのプロフィールが欲しいときに使います。名前しか分からなければ、先に fetch threads account search を実行します。

**返される内容** — プロフィール、収集した時刻、そして投稿を読む fetch コマンドです。

## パラメータ

- `username` (string, 必須, ≤ 64 chars) — Threads のユーザー名。@ はあってもなくても構いません。
- `refresh` (boolean, 任意) — 直近 1 時間のコピーがあっても収集し直します。

## レスポンス

### `Response`

- `account` (object) — プロフィール。
- `collected_at` (timestamp | null) — このコピーを収集した時刻。
- `fetched_on_demand` (boolean) — この呼び出しがライブで収集したら true。
- `stale` (boolean) — ライブ収集に失敗して古いコピーが返ったら true。collected_at がその古さを示します。
- `note` (string | null) — 注意点があるときだけ入ります。
- `next` (string) — 投稿を読む fetch コマンド。

### `account`

- `account_id` (uuid) — Threads のアカウント id。Instagram や TikTok の id とは互換しません。
- `username` (string) — ハンドル。小文字で、@ なし。
- `full_name` (string | null) — 表示名。
- `biography` (string | null) — 自己紹介(bio)の文章。
- `follower_count` (integer | null) — 収集時点のフォロワー数。
- `is_verified` (boolean | null) — 認証バッジ。
- `is_private` (boolean | null) — 非公開アカウント。投稿は空で返ります。
- `bio_links` (string[]) — bio に載っているリンク。
- `profile_pic_url` (string | null) — プロフィール画像の URL。最大サイズ。
- `url` (string | null) — 公開プロフィールの URL。

## 例

```console
$ solari fetch threads account username=zuck
```

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

```json
{
  "account": {
    "account_id": "019f3a5c-2b7e-7c41-9d0e-5a1f2c3b4d5e",
    "username": "zuck",
    "full_name": "Mark Zuckerberg",
    "biography": "Mostly superintelligence and MMA takes",
    "follower_count": 5745085,
    "is_verified": true,
    "is_private": false,
    "bio_links": [],
    "profile_pic_url": "https://scontent-gmp1-1.cdninstagram.com/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?…",
    "url": "https://www.threads.com/@zuck"
  },
  "collected_at": "2026-09-28T09:13:55Z",
  "fetched_on_demand": true,
  "stale": false,
  "note": null,
  "next": "solari fetch threads posts username=zuck"
}
```

## MCP で呼び出す場合

```json
{
  "name": "solari_fetch_threads_account",
  "arguments": {
    "username": "zuck"
  }
}
```

## 注意点

- Threads は fetch 専用です。catalog や insight の手順はないので、ハンドルで直接呼び出してレスポンスを読みます。名前からハンドルを探すには fetch threads account search を使います。
- 初回の収集は 5〜30 秒かかります(fetched_on_demand=true)。1 時間以内の再呼び出しは保存済みのコピーを返し、refresh=true なら新しく収集します。
- stale=true は、ライブ収集に失敗して古いコピーが返ったという意味です。collected_at がその古さを示します。
- 収集直後のメディア URL は一時的な場合があります。すぐに読んでください。
- Threads プロフィールのないハンドルは、空の結果ではなくエラーです。失敗した呼び出しはクレジットを消費しません。

## 関連ツール

- [`solari_fetch_threads_account_search`](https://solari.sh/docs/tools/fetch-threads-account-search.md?lang=ja)
- [`solari_fetch_threads_posts`](https://solari.sh/docs/tools/fetch-threads-posts.md?lang=ja)
- [`solari_fetch_threads_post`](https://solari.sh/docs/tools/fetch-threads-post.md?lang=ja)