threads · fetch · postsolari:read

solari fetch threads post search

키워드에 대한 Threads top 게시물을 라이브로 검색합니다.

MCP 도구: solari_fetch_threads_post_search
CLI: solari fetch threads post search
권한: solari:read체험을 포함해 모든 SOLARI 플랜에서 쓸 수 있습니다. 성공한 호출 1번에 1 크레딧입니다.체험을 포함해 모든 SOLARI 플랜에서 쓸 수 있습니다. 성공한 호출 1번에 1 크레딧입니다.
이용 가능 플랜: 유료 플랜 또는 체험
크레딧: 1

개요

키워드로 Threads에 직접 게시물을 검색해서 Threads의 top 결과를 받습니다. 한 페이지(20개 안팎)를 Threads의 관련도 순으로 주고, 게시물마다 전체 필드와 assets가 옵니다. Threads에는 catalog가 없어서 키워드 검색은 이 도구뿐입니다. 맞는 게시물은 수집해서 저장하니, fetch threads post로 어느 것이든 답글과 함께 열 수 있습니다.

언제 쓰나요 — 어떤 주제, 브랜드, 문구에 대해 사람들이 Threads에 무엇을 올리는지 보고 싶은데 시작할 핸들이 없을 때 쓰세요.

돌려주는 값 — Threads 결과 한 페이지에서 최대 limit개 게시물이 관련도 순으로 오고, 첫 게시물을 답글과 함께 여는 fetch 명령이 옵니다.

파라미터

querystring필수: 검색할 키워드나 문구≤ 100 chars
limitinteger선택: 결과 한 페이지에서 최대 몇 개까지≥ 1

응답

Response

querystring: 검색에 쓴 키워드입니다
itemsobject[]: 맞는 게시물입니다. Threads 관련도 순입니다
totalinteger: 돌아온 게시물 수입니다
fetched_on_demandboolean: 항상 true입니다. 검색은 매번 라이브로 수집합니다
notestring | null: 주의할 점이 있을 때만 옵니다. 예를 들어 맞는 게시물이 없을 때입니다
nextstring: 첫 게시물을 답글과 함께 여는 fetch 명령입니다. 결과가 있을 때만 옵니다

items[]

post_iduuid: Threads 게시물 id입니다. Instagram, TikTok id와 바꿔 쓸 수 없습니다
codestring | null: 퍼머링크 코드입니다. URL에서 /post/ 뒤에 오는 부분입니다
urlstring | null: 공개 퍼머링크입니다
account_iduuid | null: 작성자 account_id입니다
usernamestring | null: 작성자 핸들입니다
textstring | null: 게시물 본문입니다
posted_attimestamp | null: 게시 시각 (UTC)
like_countinteger | null: 좋아요 수입니다
reply_countinteger | null: Threads가 보여 주는 답글 수입니다. 돌아온 답글보다 많을 수 있습니다
repost_countinteger | null: 리포스트 수입니다
quote_countinteger | null: 인용 수입니다
reshare_countinteger | null: 공유 수입니다
counts_hiddenboolean | null: 작성자가 참여 수치를 숨겼으면 true입니다
hashtagsstring[]: 해시태그입니다. #는 없습니다
mentionsstring[]: 멘션된 핸들입니다. @는 없습니다
link_urlsstring[]: 게시물에 붙은 링크입니다
is_replyboolean | null: 다른 게시물에 단 답글이면 true입니다
reply_to_usernamestring | null: 이 게시물이 답한 상대 핸들입니다. 상위 게시물이면 null입니다
is_paid_partnershipboolean | null: 유료 파트너십 표시입니다
topicstring | null: Threads가 붙인 토픽 태그입니다. 있을 때만 옵니다
languagestring | null: 본문의 언어 코드입니다
quoted_postobject | null: 인용한 게시물입니다. username, text, like_count, posted_at, url이 있습니다. 인용 게시물이 아니면 null입니다
assetsobject[]: 게시물의 미디어 파일입니다. 순서대로 오고, 각각 asset_url, media_type, video_duration이 있습니다
assets[].asset_urlstring | null: 원본 크기 이미지나 영상을 바로 받을 수 있는 링크입니다. 저장된 파일이 없으면 null입니다

예시

요청

$ solari fetch threads post search query="Meta AI" limit=1

응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다.

{
  "query": "Meta AI",
  "items": [
    {
      "post_id": "019f3a5c-2b7e-7c41-9d0e-5a1f2c3b4d64",
      "code": "Dd008mwipTJ",
      "url": "https://www.threads.com/@meta.ai/post/Dd008mwipTJ",
      "account_id": "019f3a5c-2b7e-7c41-9d0e-5a1f2c3b4d7b",
      "username": "meta.ai",
      "text": "Từng tháng âm:\n\n1. Tháng Giêng - Cung Phu Thê (Sửu): Có Hồng Loan, Thanh Long. Tháng khởi duyên, dễ có người mai mối, gặp gỡ nơi đông người. Tài chính hao nhẹ do Đầu Quân.\n\n2. Tháng 2 - Cung Huynh Đệ (Tý): Liêm Trinh Thi…",
      "posted_at": "2026-09-28T09:08:17.000Z",
      "like_count": 0,
      "reply_count": 2,
      "repost_count": 0,
      "quote_count": 0,
      "reshare_count": 0,
      "counts_hidden": false,
      "hashtags": [],
      "mentions": [],
      "link_urls": [],
      "is_reply": true,
      "reply_to_username": "meta.ai",
      "is_paid_partnership": false,
      "topic": null,
      "language": null,
      "quoted_post": null,
      "assets": []
    }
  ],
  "total": 1,
  "fetched_on_demand": true,
  "note": null,
  "next": "solari fetch threads post url=https://www.threads.com/@meta.ai/post/Dd008mwipTJ"
}

MCP 호출

{
  "name": "solari_fetch_threads_post_search",
  "arguments": {
    "query": "Meta AI",
    "limit": 1
  }
}

주의사항

Threads의 top 탭만 됩니다. 한 페이지뿐이고 recent 탭도, 다음 페이지도 없습니다. 같은 키워드로 다시 호출하면 같은 페이지가 옵니다.
결과는 Threads의 관련도 랭킹이라 느슨하게만 관련된 게시물이나 답글이 섞일 수 있습니다. 쓰기 전에 text와 username을 확인하세요.
맞는 게시물은 저장됩니다. fetch threads post로 어느 것이든 답글과 함께 열고, fetch threads account로 작성자를 읽을 수 있습니다.
호출마다 Threads에 라이브로 물어봅니다. 몇 초 걸리고, cache 없이 1 크레딧입니다. items가 비어 있고 note가 있으면 맞는 공개 게시물이 없다는 뜻입니다.

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

개요

파라미터

응답

예시

주의사항

관련 도구