# 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도 없습니다. 하나를 골라 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=ko)
- [`solari_fetch_threads_posts`](https://finder-dev-pub.bzine.co/docs/tools/fetch-threads-posts.md?lang=ko)
- [`solari_fetch_threads_post_search`](https://finder-dev-pub.bzine.co/docs/tools/fetch-threads-post-search.md?lang=ko)