for AI agents
← 전체 도구
threads · fetchsolari:read체험을 포함해 모든 SOLARI 플랜에서 쓸 수 있습니다. 성공한 호출 1번에 1 크레딧입니다.

solari fetch threads account

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

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

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

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

파라미터

usernamestring필수
Threads 사용자명. @는 있어도 없어도 됩니다≤ 64 chars
refreshboolean선택
최근 한 시간 안의 사본이 있어도 다시 수집합니다

응답

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

관련 도구

에이전트용 문서: /docs/tools/fetch-threads-account.md