solari instagram account posts
1つのアカウントの投稿を新しい順にページングします。
- MCP ツール
- solari_instagram_account_posts
- CLI
- solari instagram account posts
- アクセス権
- solari:readサインイン済みの SOLARI アカウントであれば利用できます。サインイン済みの SOLARI アカウントであれば利用できます。
概要
追跡中の1つのInstagramアカウントの投稿を新しい順に返します。ページネーションとフィルタに対応します。アカウントはaccount_id（solari_instagram_account_searchが返すUUID）またはusername（Instagramハンドル）で指定します。各アイテムはpost_id（SOLARIの投稿UUID）、slugとurl（Instagramの公開パーマリンク）、post_type（reel、video、photo、carousel）、posted_at、キャプションのテキスト、like/comment/playの各カウント、media_count、is_paid_partnership、medias配列（投稿のすべてのメディアをカルーセル順に格納し、それぞれがmedia_type、media/thumbnailのURL、video_duration、tags（そのメディアにタグ付けされたアカウントとハッシュタグ。タグ付けされたアカウントが追跡中の場合はaccount_idを含む）を持つ）、および代表のthumbnail_urlを持ちます。レスポンスはfound、account_id、username、total、has_more、itemsを含みます。limitとoffsetでページングし、since/until（UTCの日付、両端を含む）とpost_typeで絞り込みます。未追跡のusernameは最初のリクエスト時にライブ取得されます（数秒かかります）。fetched_on_demand=trueは、現時点で直近の投稿のみ利用できることを示します。found=falseは、そのハンドルがInstagramに存在しないことを意味します。サインイン済みのSOLARIアカウントであれば利用できます。
どんなときに使うか — プロフィールのプレビューより深く掘り下げるとき、または期間とフォーマットで絞り込んだ生の行を取得するとき。
何が返るか — 各投稿のすべてのメディアを含む投稿。メディアにタグ付けされたアカウントとハッシュタグも含みます。
パラメータ
- account_idstring任意
- アカウントのaccount_id（SOLARIアカウントUUID）。これかusernameのいずれかを指定してください。uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
- usernamestring任意
- Instagramハンドル。先頭の@はあってもなくてもかまいません。account_idが指定されている場合は無視されます。≤ 64 chars
- limitinteger任意
- 1ページあたりの投稿数。デフォルトは12。200を超える値は200に上限で切り詰められます。≥ 1
- offsetinteger任意
- ページネーションのオフセット。デフォルトは0。既定値
0≥ 0 - sincestring任意
- このUTC日付以降の投稿のみ。YYYY-MM-DD形式で、当日を含みます。pattern ^\d{4}-\d{2}-\d{2}$
- untilstring任意
- このUTC日付以前の投稿のみ。YYYY-MM-DD形式で、当日を含みます。pattern ^\d{4}-\d{2}-\d{2}$
- post_typeenum任意
- このフォーマットの投稿のみ。reelはショート形式の単一動画、videoはreel以外の動画。値
reelvideophotocarousel
レスポンス
Response
- foundboolean
- falseは、そのハンドルがInstagramに存在しないことを意味します。
- account_id / usernamestring
- 解決されたアカウント。
- totalinteger
- フィルタに一致した投稿数。
- has_moreboolean
- 次のページが存在するかどうか。
- itemsobject[]
- 投稿。新しい順。
- fetched_on_demandboolean
- 現時点で直近の投稿のみ利用できる場合はtrue。
items[]
- post_iduuid
- SOLARIの投稿id。
- slugstring
- Instagramのショートコード。
- urlstring
- 公開パーマリンク。
- post_typestring
- reel、video、photo、またはcarousel。
- posted_attimestamp
- 投稿日時（UTC）。
- textstring
- キャプションのテキスト。
- like_count / comment_count / play_countinteger
- エンゲージメントのスナップショット。
- media_countinteger
- 投稿内のメディア数。
- is_paid_partnershipboolean | null
- Instagram自身が付けるタイアップ投稿ラベル。
- mediasobject[]
- カルーセル順のすべてのメディア。それぞれmedia_type、media/thumbnailのURL、video_durationを持ちます。
- medias[].tagsobject[]
- そのメディアにタグ付けされたアカウントとハッシュタグ。タグ付けされたアカウントをSOLARIが追跡している場合はaccount_idを持ちます。
- thumbnail_urlstring
- 代表のサムネイル。
例
リクエスト
$ solari instagram account posts username=innisfreeofficial limit=2レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"found": true,
"account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
"username": "innisfreeofficial",
"fetched_on_demand": false,
"total": 4196,
"has_more": true,
"items": [
{
"post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
"slug": "DcyMAmUh6FZ",
"url": "https://www.instagram.com/p/DcyMAmUh6FZ/",
"post_type": "reel",
"posted_at": "2026-09-02T12:00:06+00:00",
"text": "Deeply hydrated skin—NO OFF HOURS. 💚\nwherever the day takes MINGYU (@min9yu_k)—his hydration stays SUPERCHARGED ⚡️\n\nGreen Tea Ceramide Milk: Lightweight milky toner that won‘t clog your pores\nGreen Tea Ceramide Mist: Tou …",
"like_count": 3224,
"comment_count": 57,
"play_count": 22467,
"media_count": 1,
"is_paid_partnership": false,
"medias": [
{
"media_type": "video",
"media_url": "https://smr-images-b.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.mp4",
"thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=0ms/https://smr-images.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.m …",
"video_duration": 23.868000030517578,
"tags": []
}
],
"thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=0ms/https://smr-images.bzine.co/users/018cabce-14cc-7544-8890-7811ec33ef74/posts/01a06275-d974-7fda-98ee-dd3ee15b4dcf/medias/01a06275-db2b-77f7-a020-b4beb744771f.m …"
},
"… 1 more"
]
}MCP 呼び出しとして
{
"name": "solari_instagram_account_posts",
"arguments": {
"username": "innisfreeofficial",
"limit": 2
}
}注意点
- 1ページあたり最大200件。大量に取得する場合は、メモリ上の大きなページよりも--ndjsonでファイルに追記する方法を選んでください。
- sinceとuntilはUTCの日付で、両端を含みます。
- post_type=reelはショート形式の単一動画、videoはreel以外の動画。