# solari fetch threads account

> Threads 계정 프로필 하나를 라이브로 읽습니다.

- **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초), 한 시간 안의 재호출은 저장된 사본을 다시 씁니다. refresh=true면 새로 수집합니다.

**언제 쓰나요** — 정확한 Threads 핸들이 있고 그 프로필이 필요할 때 쓰세요. 이름만 안다면 fetch threads account search를 먼저 돌리세요.

**돌려주는 값** — 프로필, 수집 시각, 그리고 게시물을 읽는 fetch 명령입니다.

## 파라미터

- `username` (string, 필수, ≤ 64 chars) — Threads 사용자명. @는 있어도 없어도 됩니다
- `refresh` (boolean, 선택) — 최근 한 시간 안의 사본이 있어도 다시 수집합니다

## 응답

### `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). 한 시간 안의 재호출은 저장된 사본을 돌려주고, refresh=true면 새로 수집합니다.
- stale=true는 라이브 수집이 실패해서 예전 사본이 왔다는 뜻입니다. collected_at이 얼마나 오래됐는지 알려 줍니다.
- 수집 직후의 미디어 URL은 임시일 수 있습니다. 바로 읽어 두세요.
- Threads 프로필이 없는 핸들은 빈 결과가 아니라 에러입니다. 실패한 호출은 크레딧을 쓰지 않습니다.

## 관련 도구

- [`solari_fetch_threads_account_search`](https://finder-dev-pub.bzine.co/docs/tools/fetch-threads-account-search.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`](https://finder-dev-pub.bzine.co/docs/tools/fetch-threads-post.md?lang=ko)