# solari catalog instagram account posts

> Instagram アカウントの投稿。

- **CLI**: `solari catalog instagram account posts`
- **MCP ツール**: `solari_catalog_instagram_account_posts`
- **アクセス権**: `solari:read`
- **対象プラン**: 無料トライアル · Plus · Pro · Enterprise
- **クレジット**: 1

Instagram アカウントの投稿を、メディア・タグ・いいね数と一緒に一覧で返します。日付や形式で絞り込めます。

**どんなときに使うか** — プロフィールのプレビューより多くの投稿が必要なとき。または期間や形式を指定したいとき。

**返される内容** — 投稿。カルーセルの各スライドと、タグ付けされたアカウント・ハッシュタグを含みます。

## パラメータ

- `account_id` (string, 任意, 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)$) — account_id か username を渡します。
- `username` (string, 任意, ≤ 64 chars) — Instagram のユーザー名。account_id を指定した場合は無視されます。
- `limit` (integer, 任意, 既定値 12, 1–200) — 1 ページあたりの投稿の件数。
- `offset` (integer, 任意, 既定値 0, ≥ 0) — スキップする投稿の件数。
- `since` (string, 任意, pattern ^\d{4}-\d{2}-\d{2}$) — この UTC の日付（YYYY-MM-DD）以降の投稿だけを返します。
- `until` (string, 任意, pattern ^\d{4}-\d{2}-\d{2}$) — この UTC の日付（YYYY-MM-DD）以前の投稿だけを返します。
- `post_type` (enum, 任意) — reel, video, photo, carousel のいずれかに絞り込みます。 値: `reel`, `video`, `photo`, `carousel`.

## レスポンス

### `Response`

- `found` (boolean) — そのユーザー名が Instagram に存在しない場合は false。
- `account_id / username` (string) — 特定したアカウント。
- `total` (integer) — フィルターに合う投稿の数。
- `has_more` (boolean) — 次のページがあるかどうか。
- `items` (object[]) — 投稿。新しい順。
- `fetched_on_demand` (boolean) — 現時点で最新の投稿しか取得できていない場合は true。
- `collected_at` (timestamp) — Instagram からプロフィールを最後に収集した時刻（UTC）。
- `posts_collected_at` (timestamp) — 保存済みの投稿がどこまで収集されているか（UTC）。それ以降の投稿はまだカタログにありません。
- `refreshes_regularly` (boolean) — 定期的に再収集されるアカウントかどうか。
- `stored_post_count / profile_post_count` (integer) — カタログに保存された投稿数と、プロフィールに表示された投稿数。保存数がかなり少ない場合は収集が不十分です。
- `refreshed` (boolean) — 1 日以上前の保存データをこの呼び出しで再収集した場合は true。
- `note` (string | null) — 結果が不完全な可能性がある理由、または found が false の理由（名前の変更や削除）。

### `items[]`

- `post_id` (uuid) — SOLARI の投稿 ID。
- `slug` (string) — Instagram のショートコード。
- `url` (string) — 公開パーマリンク。
- `post_type` (string) — reel, video, photo, carousel のいずれか。
- `posted_at` (timestamp) — 公開日時（UTC）。
- `text` (string) — キャプション。
- `like_count / comment_count / play_count` (integer) — エンゲージメント。
- `media_count` (integer) — メディアの数。
- `is_paid_partnership` (boolean | null) — Instagram の「タイアップ投稿」ラベル。
- `medias` (object[]) — すべてのメディア（カルーセルの順番どおり）。
- `medias[].tags` (object[]) — メディアにタグ付けされたアカウントとハッシュタグ。
- `thumbnail_url` (string) — サムネイル。
- `assets` (object[]) — メディアファイル（順番どおり）。それぞれに asset_url, media_type, video_duration があります。
- `assets[].asset_url` (string | null) — 元サイズの画像・動画を直接ダウンロードできるリンク。ファイルが保存されていない場合は null。

## 例

```console
$ solari catalog instagram account posts username=innisfreeofficial limit=2
```

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

```json
{
  "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,
      "likes_hidden": false,
      "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 で呼び出す場合

```json
{
  "name": "solari_catalog_instagram_account_posts",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 2
  }
}
```

## 注意点

- since と until は UTC の日付で、両端の日を含みます。
- post_type=reel はショート動画です。video はリール以外の動画です。
- カタログには抜けがあったり、古かったりすることがあります。solari fetch instagram posts username=…（再生数は type=reels）でその場で収集すると、投稿がそのまま返ります。
- 指定した日付が posts_collected_at より後の場合、結果が空でも投稿がないとは限りません。solari fetch instagram posts username=… で最新の投稿をその場で収集してください。
- likes_hidden が true のときは like_count を使わないでください。投稿者がいいね数を非表示にしているため、null か、実際の値ではない可能性があります。

## 関連ツール

- [`solari_catalog_instagram_account_profile`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-profile.md?lang=ja)
- [`solari_catalog_instagram_content_detail`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-detail.md?lang=ja)
- [`solari_catalog_instagram_content_history`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-history.md?lang=ja)
- [`solari_catalog_tiktok_account_posts`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-posts.md?lang=ja)