threads · fetchsolari:readトライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。
solari fetch threads account
Threads アカウントのプロフィールを 1 件、ライブで読みます。
- MCP ツール
- solari_fetch_threads_account
- CLI
- solari fetch threads account
- アクセス権
- solari:readトライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。トライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。
- 対象プラン
- 有料プランまたはトライアル
- クレジット
- 1
概要
正確なユーザー名で Threads アカウントのプロフィールを読みます。表示名、自己紹介(bio)、フォロワー数、認証・非公開のフラグ、bio のリンク、プロフィール画像が返ります。SOLARI では Threads は fetch 専用なので、catalog や insight の手順はなく、この呼び出しがそのままプロフィールの読み取りです。SOLARI が初めて見るハンドルはその場で収集し(5〜30 秒)、1 時間以内の再呼び出しは保存済みのコピーを使い回します。refresh=true で新しく収集します。
どんなときに使うか — 正確な Threads ハンドルがあり、そのプロフィールが欲しいときに使います。名前しか分からなければ、先に fetch threads account search を実行します。
返される内容 — プロフィール、収集した時刻、そして投稿を読む fetch コマンドです。
パラメータ
- usernamestring必須
- Threads のユーザー名。@ はあってもなくても構いません。≤ 64 chars
- refreshboolean任意
- 直近 1 時間のコピーがあっても収集し直します。
レスポンス
Response
- accountobject
- プロフィール。
- collected_attimestamp | null
- このコピーを収集した時刻。
- fetched_on_demandboolean
- この呼び出しがライブで収集したら true。
- staleboolean
- ライブ収集に失敗して古いコピーが返ったら true。collected_at がその古さを示します。
- notestring | null
- 注意点があるときだけ入ります。
- nextstring
- 投稿を読む fetch コマンド。
account
- account_iduuid
- Threads のアカウント id。Instagram や TikTok の id とは互換しません。
- usernamestring
- ハンドル。小文字で、@ なし。
- full_namestring | null
- 表示名。
- biographystring | null
- 自己紹介(bio)の文章。
- follower_countinteger | null
- 収集時点のフォロワー数。
- is_verifiedboolean | null
- 認証バッジ。
- is_privateboolean | null
- 非公開アカウント。投稿は空で返ります。
- bio_linksstring[]
- bio に載っているリンク。
- profile_pic_urlstring | null
- プロフィール画像の URL。最大サイズ。
- urlstring | null
- 公開プロフィールの URL。
例
リクエスト
$ solari fetch threads account username=zuckレスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"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 で呼び出す場合
{
"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_searchThreads アカウントを名前でライブ検索します。
- solari_fetch_threads_postsThreads アカウントの最近の投稿をライブで読みます。
- solari_fetch_threads_postThreads の投稿 1 件を最初の返信と一緒にライブで読みます。
機械可読な形式: /docs/tools/fetch-threads-account.md