# solari fetch threads post search

> キーワードに対する Threads のトップ投稿をライブ検索します。

- **CLI**: `solari fetch threads post search`
- **MCP ツール**: `solari_fetch_threads_post_search`
- **アクセス権**: `solari:read` — トライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。
- **対象プラン**: 有料プランまたはトライアル
- **クレジット**: 1

キーワードで Threads 自体の投稿を検索し、Threads のトップ結果を受け取ります。1 ページ(20 件前後)を Threads の関連度順で返し、投稿ごとに全フィールドと assets が付きます。Threads には catalog がないため、これが唯一のキーワード検索です。一致した投稿は収集して保存されるので、fetch threads post でどれでも返信付きで開けます。

**どんなときに使うか** — あるテーマ、ブランド、フレーズについて人々が Threads に何を投稿しているか知りたいが、起点となるハンドルがないときに使います。

**返される内容** — Threads の結果 1 ページから最大 limit 件の投稿を関連度順で、そして最初の投稿を返信付きで開く fetch コマンドです。

## パラメータ

- `query` (string, 必須, ≤ 100 chars) — 検索するキーワードやフレーズ。
- `limit` (integer, 任意, ≥ 1) — 結果 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 のトップタブだけが使えます。1 ページのみで、recent タブも次のページもありません。同じキーワードで再度呼ぶと同じページが返ります。
- 結果は Threads の関連度ランキングなので、ゆるく関連するだけの投稿や返信が混ざることがあります。使う前に text と username を確認してください。
- 一致した投稿は保存されます。fetch threads post でどれでも返信付きで開き、fetch threads account で投稿者を読めます。
- 呼び出しごとに Threads へライブで問い合わせます。数秒かかり、cache はなく、1 クレジットです。items が空で note があれば、一致する公開投稿がありません。

## 関連ツール

- [`solari_fetch_threads_post`](https://finder-dev-pub.bzine.co/docs/tools/fetch-threads-post.md?lang=ja)
- [`solari_fetch_threads_account`](https://finder-dev-pub.bzine.co/docs/tools/fetch-threads-account.md?lang=ja)
- [`solari_fetch_threads_account_search`](https://finder-dev-pub.bzine.co/docs/tools/fetch-threads-account-search.md?lang=ja)