threads · fetch · accountsolari:readトライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。
solari fetch threads account search
Threads アカウントを名前でライブ検索します。
- MCP ツール
- solari_fetch_threads_account_search
- CLI
- solari fetch threads account search
- アクセス権
- solari:readトライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。トライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。
- 対象プラン
- 有料プランまたはトライアル
- クレジット
- 1
概要
名前やハンドルの一部で Threads 自体にアカウントを問い合わせます。ヒットはハンドル、表示名、認証バッジ、プロフィール画像、URL だけの薄い一覧で、Threads の順序どおりです。Threads には catalog がないため、これが唯一のアカウント検索です。何も保存せず、account_id もありません。1 件選んだら fetch threads account でプロフィール全体を読みます。
どんなときに使うか — 名前やハンドルの一部は分かるが、正確な Threads ハンドルが分からないときに使います。
返される内容 — Threads の順序で最大 limit 件の候補と、最初の候補のプロフィールを読む fetch コマンドです。
パラメータ
- querystring必須
- 名前またはハンドルの一部。@ はあってもなくても構いません。≤ 100 chars
- limitinteger任意
- 最大何件まで。≥ 1
レスポンス
Response
- querystring
- 検索に使った文字列。@ を除いた値。
- itemsobject[]
- 一致したアカウント。Threads の順序。
- totalinteger
- 返った候補の数。
- nextstring
- 最初の候補のプロフィールを読む fetch コマンド。候補があるときだけ。
items[]
- usernamestring
- ハンドル。小文字で、@ なし。
- full_namestring | null
- 表示名。
- is_verifiedboolean | null
- 認証バッジ。
- profile_pic_urlstring | null
- プロフィール画像の URL。
- urlstring | null
- 公開プロフィールの URL。
例
リクエスト
$ solari fetch threads account search query=nike limit=1レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"query": "nike",
"items": [
{
"username": "nike",
"full_name": "Nike",
"is_verified": true,
"profile_pic_url": "https://scontent-gmp1-1.cdninstagram.com/v/t51.2885-19/467733497_2299328197118830_1129133478722126916_n.jpg?…",
"url": "https://www.threads.com/@nike"
}
],
"total": 1,
"next": "solari fetch threads account username=nike"
}MCP で呼び出す場合
{
"name": "solari_fetch_threads_account_search",
"arguments": {
"query": "nike",
"limit": 1
}
}注意点
- 順序とランキングは Threads 自身のものなので、公式アカウントが常に先頭とは限りません。選ぶ前に is_verified と full_name を確認してください。
- 何も保存せず、ヒットに account_id はありません。選んだ username で fetch threads account を呼ぶとフォロワー数、bio、bio のリンクを、fetch threads posts を呼ぶと投稿を読めます。
- 呼び出しごとに Threads へライブで問い合わせます。1〜2 秒かかり、cache はなく、1 クレジットです。items が空なら Threads に一致するアカウントがありません。