# solari fetch threads account search

> Threads アカウントを名前でライブ検索します。

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

名前やハンドルの一部で Threads 自体にアカウントを問い合わせます。ヒットはハンドル、表示名、認証バッジ、プロフィール画像、URL だけの薄い一覧で、Threads の順序どおりです。Threads には catalog がないため、これが唯一のアカウント検索です。何も保存せず、account_id もありません。1 件選んだら fetch threads account でプロフィール全体を読みます。

**どんなときに使うか** — 名前やハンドルの一部は分かるが、正確な Threads ハンドルが分からないときに使います。

**返される内容** — Threads の順序で最大 limit 件の候補と、最初の候補のプロフィールを読む fetch コマンドです。

## パラメータ

- `query` (string, 必須, ≤ 100 chars) — 名前またはハンドルの一部。@ はあってもなくても構いません。
- `limit` (integer, 任意, ≥ 1) — 最大何件まで。

## レスポンス

### `Response`

- `query` (string) — 検索に使った文字列。@ を除いた値。
- `items` (object[]) — 一致したアカウント。Threads の順序。
- `total` (integer) — 返った候補の数。
- `next` (string) — 最初の候補のプロフィールを読む fetch コマンド。候補があるときだけ。

### `items[]`

- `username` (string) — ハンドル。小文字で、@ なし。
- `full_name` (string | null) — 表示名。
- `is_verified` (boolean | null) — 認証バッジ。
- `profile_pic_url` (string | null) — プロフィール画像の URL。
- `url` (string | null) — 公開プロフィールの URL。

## 例

```console
$ solari fetch threads account search query=nike limit=1
```

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

```json
{
  "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 で呼び出す場合

```json
{
  "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 に一致するアカウントがありません。

## 関連ツール

- [`solari_fetch_threads_account`](https://finder-dev-pub.bzine.co/docs/tools/fetch-threads-account.md?lang=ja)
- [`solari_fetch_threads_posts`](https://finder-dev-pub.bzine.co/docs/tools/fetch-threads-posts.md?lang=ja)
- [`solari_fetch_threads_post_search`](https://finder-dev-pub.bzine.co/docs/tools/fetch-threads-post-search.md?lang=ja)