threads · fetch · postsolari:read

solari fetch threads post search

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

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

概要

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

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

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

パラメータ

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

機械可読な形式: /docs/tools/fetch-threads-post-search.md

概要

パラメータ

レスポンス

例

注意点

関連ツール