threads · fetchsolari:read

solari fetch threads posts

Threads アカウントの最近の投稿をライブで読みます。

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

概要

正確なユーザー名で Threads アカウントの最新のトップレベル投稿を、プロフィールと一緒に読みます。投稿ごとに本文、ハッシュタグ、メンション、リンク、いいね・返信・リポスト・引用・シェアの数、引用した投稿、そして直接ダウンロードできる asset_url 付きの assets が返ります。SOLARI では Threads は fetch 専用なので、catalog の手順はなく、この呼び出しがそのまま投稿一覧です。SOLARI が初めて見るハンドルはその場で収集し(5〜30 秒)、1 時間以内の再呼び出しは保存済みのコピーを使い回します。refresh=true で新しく収集します。

どんなときに使うか — 正確な Threads ハンドルがあり、最近何を投稿したか知りたいときに使います。

返される内容 — プロフィール、新しい順のトップレベル投稿を最大 limit 件、そして最新の投稿を返信付きで開く fetch コマンドです。

パラメータ

usernamestring必須: Threads のユーザー名。@ はあってもなくても構いません。≤ 64 chars
limitinteger任意: 何件まで。新しい順です。≥ 1
refreshboolean任意: 直近 1 時間のコピーがあっても収集し直します。

レスポンス

Response

accountobject: プロフィール。
postsobject[]: トップレベルの投稿。新しい順。
totalinteger: 返った投稿の数。
collected_attimestamp | null: このコピーを収集した時刻。
fetched_on_demandboolean: この呼び出しがライブで収集したら true。
staleboolean: ライブ収集に失敗して古いコピーが返ったら true。collected_at がその古さを示します。
notestring | null: 注意点があるときだけ入ります。たとえば非公開アカウント。
nextstring: 最新の投稿を返信付きで開く fetch コマンド。投稿があるときだけ。

account

account_iduuid: Threads のアカウント id。Instagram や TikTok の id とは互換しません。
usernamestring: ハンドル。小文字で、@ なし。
full_namestring | null: 表示名。
biographystring | null: 自己紹介(bio)の文章。
follower_countinteger | null: 収集時点のフォロワー数。
is_verifiedboolean | null: 認証バッジ。
is_privateboolean | null: 非公開アカウント。投稿は空で返ります。
bio_linksstring[]: bio に載っているリンク。
profile_pic_urlstring | null: プロフィール画像の URL。最大サイズ。
urlstring | null: 公開プロフィールの URL。

posts[]

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 posts username=zuck limit=2

レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。

{
  "account": {
    "account_id": "019f3a5c-2b7e-7c41-9d0e-5a1f2c3b4d5e",
    "username": "zuck",
    "full_name": "Mark Zuckerberg",
    "biography": "Mostly superintelligence and MMA takes",
    "follower_count": 5745085,
    "is_verified": true,
    "is_private": false,
    "bio_links": [],
    "profile_pic_url": "https://scontent-gmp1-1.cdninstagram.com/v/t51.82787-19/825322135_17989325280103224_1252773933700107438_n.jpg?…",
    "url": "https://www.threads.com/@zuck"
  },
  "posts": [
    {
      "post_id": "019f3a5c-2b7e-7c41-9d0e-5a1f2c3b4d60",
      "code": "Ddt7cL5EfUG",
      "url": "https://www.threads.com/@zuck/post/Ddt7cL5EfUG",
      "account_id": "019f3a5c-2b7e-7c41-9d0e-5a1f2c3b4d5e",
      "username": "zuck",
      "text": "Agrippa said it's time to get back to work 😎",
      "posted_at": "2026-09-25T16:50:21.000Z",
      "like_count": 4964,
      "reply_count": 477,
      "repost_count": 254,
      "quote_count": 45,
      "reshare_count": 136,
      "counts_hidden": false,
      "hashtags": [],
      "mentions": [],
      "link_urls": [],
      "is_reply": false,
      "reply_to_username": null,
      "is_paid_partnership": false,
      "topic": null,
      "language": null,
      "quoted_post": null,
      "assets": [
        {
          "asset_url": "https://smr-images.bzine.co/threads/…",
          "media_type": "image",
          "video_duration": null
        },
        {
          "asset_url": "https://smr-images.bzine.co/threads/…",
          "media_type": "image",
          "video_duration": null
        }
      ]
    },
    {
      "post_id": "019f3a5c-2b7e-7c41-9d0e-5a1f2c3b4d61",
      "code": "Ddpj4YZkd3P",
      "url": "https://www.threads.com/@zuck/post/Ddpj4YZkd3P",
      "account_id": "019f3a5c-2b7e-7c41-9d0e-5a1f2c3b4d5e",
      "username": "zuck",
      "text": "Here's everything I announced at Meta Connect today 👇",
      "posted_at": "2026-09-24T00:07:31.000Z",
      "like_count": 2680,
      "reply_count": 612,
      "repost_count": 164,
      "quote_count": 34,
      "reshare_count": 138,
      "counts_hidden": false,
      "hashtags": [],
      "mentions": [],
      "link_urls": [],
      "is_reply": false,
      "reply_to_username": null,
      "is_paid_partnership": false,
      "topic": null,
      "language": null,
      "quoted_post": null,
      "assets": []
    }
  ],
  "total": 2,
  "collected_at": "2026-09-28T09:13:55Z",
  "fetched_on_demand": true,
  "stale": false,
  "note": null,
  "next": "solari fetch threads post url=https://www.threads.com/@zuck/post/Ddt7cL5EfUG"
}

MCP で呼び出す場合

{
  "name": "solari_fetch_threads_posts",
  "arguments": {
    "username": "zuck",
    "limit": 2
  }
}

注意点

Threads は fetch 専用です。catalog の手順はないので、このレスポンスから投稿を読みます。
トップレベルの投稿だけを新しい順に並べます。アカウント自身の返信は含みません。fetch threads post が投稿 1 件を返信付きで読みます。
初回の収集は 5〜30 秒かかります(fetched_on_demand=true)。1 時間以内の再呼び出しは保存済みのコピーを返し、refresh=true なら新しく収集します。
stale=true は、ライブ収集に失敗して古いコピーが返ったという意味です。collected_at がその古さを示します。
非公開アカウントはプロフィールだけが返り、posts は空です。収集直後のメディア URL は一時的な場合があるので、すぐに読んでください。
Threads プロフィールのないハンドルは、空の結果ではなくエラーです。失敗した呼び出しはクレジットを消費しません。

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

概要

パラメータ

レスポンス

例

注意点

関連ツール