← 전체 도구
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도 없습니다. 하나를 골라 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에 맞는 계정이 없다는 뜻입니다.

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