# solari instagram account ad posts

> クリエイターが投稿した広告投稿を行単位で返し、各行にターゲットブランドを付けます。

- **CLI**: `solari instagram account ad posts`
- **MCP ツール**: `solari_instagram_account_ad_posts`
- **アクセス権**: `solari:read` — サインイン済みの SOLARI アカウントであれば利用できます。

1 人のクリエイターが投稿した、判定済みの広告投稿を行単位でページネーションして新しい順に返します。各行にはターゲットブランドが付きます。1 行が 1 つの投稿とブランドの組み合わせなので、複数ブランドの投稿はターゲットごとに 1 回ずつ現れます。各アイテムは post_id、slug と url、post_type、posted_at、キャプションのテキスト、like/comment/play の各カウント、media_count、is_paid_partnership、target_account_id / target_username を持ちます。target (ブランドの account_id または Instagram ハンドル) で 1 ブランドに絞り込めます。months で遡る期間を広げられます (デフォルト 3、最大 24)。同じ履歴をブランド単位でまとめる solari_instagram_account_collabs の行単位版。クリエイターは account_id (SOLARI アカウントの UUID) または username (Instagram ハンドル) で指定します。不明な指定は not-found エラーになります。サインイン済みの SOLARI アカウントであれば利用できます。

**どんなときに使うか** — コラボレーション履歴を生の行として分析するとき。複数ブランドをタグ付けした投稿はターゲットごとに 1 回ずつ現れるため、各行は投稿とブランドの組み合わせになります。

**何が返るか** — 広告投稿を新しい順に返します。

## パラメータ

- `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 (SOLARI アカウントの UUID)。これか username のいずれかを指定してください。
- `username` (string, 任意, ≤ 64 chars) — Instagram ハンドル。先頭の @ はあってもなくてもかまいません。account_id が指定されている場合は無視されます。
- `months` (integer, 任意, ≥ 1) — 遡る期間を月数で指定、デフォルトは 3。24 を超える値は上限の 24 に切り詰められます。
- `limit` (integer, 任意, ≥ 1) — 1 ページあたりのアイテム数、デフォルトは 50。200 を超える値は上限の 200 に切り詰められます。
- `offset` (integer, 任意, 既定値 0, ≥ 0) — ページネーションの offset、デフォルトは 0。
- `target` (string, 任意, ≤ 64 chars) — 任意のターゲットブランドのフィルタ。ブランドの account_id (SOLARI アカウントの UUID) または Instagram ハンドル。

## レスポンス

### `Response`

- `account_id / username` (string) — 解決されたクリエイター。
- `months` (integer) — 適用された遡及期間。
- `total` (integer) — 行の総数。
- `has_more` (boolean) — 次のページが存在するかどうか。
- `items` (object[]) — 投稿とブランドの組み合わせ。

### `items[]`

- `post_id / slug / 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 のタイアップ投稿 (paid partnership) ラベル。
- `target_account_id / target_username` (string) — この行が帰属するブランド。

## 例

```console
$ solari instagram account ad posts username=beinny_motd months=6 limit=2
```

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

```json
{
  "account_id": "018ecc75-55d8-70a7-a348-d370aa504ed9",
  "username": "beinny_motd",
  "months": 6,
  "total": 12,
  "has_more": true,
  "items": [
    {
      "post_id": "01a05575-7c9b-7232-8519-4a38fa061389",
      "slug": "DcpugJ2kzv8",
      "url": "https://www.instagram.com/p/DcpugJ2kzv8/",
      "post_type": "carousel",
      "posted_at": "2026-08-30T05:08:56Z",
      "text": "#광고 무겁지 않은 가을 데일리 팔레트 로즈밀크티 . .🫖🤎\n차분하고 미지근한 로즈핑크 팔레트인데\n부드러운 밀크티 무드라서 분위기가 넘 예뻐요..🥺\n\n데이지크에서 올리브영 X 산리오 콜라보\n시티팝 에디션으로 미니섀도우팔레트 4종이 출시되는데\n그 중 자주 추천드렸던 로즈밀크티, 밀크라떼가 있더라구요 !\n\nNEW 컬러 피치레코드, 모브카세트도 출시되어요🤍\n도시의 아침과 저녁 무드를 담은 데일리한 …",
      "like_count": 878,
      "comment_count": 19,
      "play_count": 0,
      "media_count": 15,
      "is_paid_partnership": null,
      "target_account_id": "018cab85-8ef8-7dc9-ab0a-7044d463f65e",
      "target_username": "dasique_official"
    },
    "… 1 more"
  ]
}
```

## MCP 呼び出しとして

```json
{
  "name": "solari_instagram_account_ad_posts",
  "arguments": {
    "username": "beinny_motd",
    "months": 6,
    "limit": 2
  }
}
```

## 注意点

- target は 1 ブランドに絞り込むフィルタで、その account_id かハンドルのどちらでも受け付けます。
- months のデフォルトは 3 で、最大 24 まで遡れます。account collabs より長いです。
- 同じ履歴をブランド単位でまとめて見るには account collabs をお使いください。

## 関連ツール

- [`solari_instagram_account_collabs`](https://solari.sh/docs/tools/instagram-account-collabs.md?lang=ja)
- [`solari_instagram_brand_ad_posts`](https://solari.sh/docs/tools/instagram-brand-ad-posts.md?lang=ja)