# solari fetch threads post search

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

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

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

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

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

## 파라미터

- `query` (string, 필수, ≤ 100 chars) — 검색할 키워드나 문구
- `limit` (integer, 선택, ≥ 1) — 결과 한 페이지에서 최대 몇 개까지

## 응답

### `Response`

- `query` (string) — 검색에 쓴 키워드입니다
- `items` (object[]) — 맞는 게시물입니다. Threads 관련도 순입니다
- `total` (integer) — 돌아온 게시물 수입니다
- `fetched_on_demand` (boolean) — 항상 true입니다. 검색은 매번 라이브로 수집합니다
- `note` (string | null) — 주의할 점이 있을 때만 옵니다. 예를 들어 맞는 게시물이 없을 때입니다
- `next` (string) — 첫 게시물을 답글과 함께 여는 fetch 명령입니다. 결과가 있을 때만 옵니다

### `items[]`

- `post_id` (uuid) — Threads 게시물 id입니다. Instagram, TikTok id와 바꿔 쓸 수 없습니다
- `code` (string | null) — 퍼머링크 코드입니다. URL에서 /post/ 뒤에 오는 부분입니다
- `url` (string | null) — 공개 퍼머링크입니다
- `account_id` (uuid | null) — 작성자 account_id입니다
- `username` (string | null) — 작성자 핸들입니다
- `text` (string | null) — 게시물 본문입니다
- `posted_at` (timestamp | null) — 게시 시각 (UTC)
- `like_count` (integer | null) — 좋아요 수입니다
- `reply_count` (integer | null) — Threads가 보여 주는 답글 수입니다. 돌아온 답글보다 많을 수 있습니다
- `repost_count` (integer | null) — 리포스트 수입니다
- `quote_count` (integer | null) — 인용 수입니다
- `reshare_count` (integer | null) — 공유 수입니다
- `counts_hidden` (boolean | null) — 작성자가 참여 수치를 숨겼으면 true입니다
- `hashtags` (string[]) — 해시태그입니다. #는 없습니다
- `mentions` (string[]) — 멘션된 핸들입니다. @는 없습니다
- `link_urls` (string[]) — 게시물에 붙은 링크입니다
- `is_reply` (boolean | null) — 다른 게시물에 단 답글이면 true입니다
- `reply_to_username` (string | null) — 이 게시물이 답한 상대 핸들입니다. 상위 게시물이면 null입니다
- `is_paid_partnership` (boolean | null) — 유료 파트너십 표시입니다
- `topic` (string | null) — Threads가 붙인 토픽 태그입니다. 있을 때만 옵니다
- `language` (string | null) — 본문의 언어 코드입니다
- `quoted_post` (object | null) — 인용한 게시물입니다. username, text, like_count, posted_at, url이 있습니다. 인용 게시물이 아니면 null입니다
- `assets` (object[]) — 게시물의 미디어 파일입니다. 순서대로 오고, 각각 asset_url, media_type, video_duration이 있습니다
- `assets[].asset_url` (string | null) — 원본 크기 이미지나 영상을 바로 받을 수 있는 링크입니다. 저장된 파일이 없으면 null입니다

## 예시

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

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

```json
{
  "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 호출

```json
{
  "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가 있으면 맞는 공개 게시물이 없다는 뜻입니다.

## 관련 도구

- [`solari_fetch_threads_post`](https://pub.brandazine.ai/docs/tools/fetch-threads-post.md?lang=ko)
- [`solari_fetch_threads_account`](https://pub.brandazine.ai/docs/tools/fetch-threads-account.md?lang=ko)
- [`solari_fetch_threads_account_search`](https://pub.brandazine.ai/docs/tools/fetch-threads-account-search.md?lang=ko)