# solari instagram brand lookalike content

> ブランドの成績上位の広告に見た目も内容も似ている投稿。

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

ブランドの成績上位の広告投稿と視覚的・意味的に類似したInstagram投稿。ブランド自身の広告投稿を種にしたベクトル近傍検索で見つけます。ブランドはaccount_id（solari_instagram_account_searchが返すSOLARIアカウントUUID）またはusername（Instagramハンドル）で指定します。未知の参照はnot-foundエラーを返します。サインイン済みのSOLARIアカウントであれば利用できます。

**どんなときに使うか** — 参考事例を探すとき。ブランド自身の上位広告を種にしたベクトル近傍検索。

**何が返るか** — 類似（lookalike）投稿と、検索の種になったブランド自身の広告。

## パラメータ

- `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)$) — 類似（lookalike）検索の種となる広告投稿を持つブランドのaccount_id（SOLARIアカウントUUID）。これかusernameのいずれかを指定してください。
- `username` (string, 任意, ≤ 64 chars) — ブランドのInstagramハンドル。先頭の@はあってもなくても構いません。account_idが指定されている場合は無視されます。
- `limit` (integer, 任意, ≥ 1) — 返される類似（lookalike）投稿の最大数。デフォルトは30。50を超える値は50に上限で切り詰められます。
- `region` (string, 任意, 既定値 "KR") — 検索範囲を限定するリージョンコード。KR、JP、USなど。

## レスポンス

### `Response`

- `items` (object[]) — 類似（lookalike）投稿。
- `basis` (object[]) — 種として使われたブランド自身の広告投稿。
- `region` (string) — 検索の対象となったリージョン。

### `items[] · basis[]`

- `post_id` (uuid) — SOLARIの投稿id。他のコンテンツ系ツールにそのまま渡せます。
- `slug` (string) — Instagramのショートコード。公開URLの/p/または/reel/の後ろのセグメント。
- `author_id` (uuid) — 投稿したアカウントのaccount_id。
- `username` (string) — 投稿者のハンドル。
- `full_name` (string | null) — プロフィールの表示名。
- `profile_pic_url` (string | null) — プロフィール画像のURL。
- `follower_count` (integer | null) — スナップショット時点の投稿者のフォロワー数。
- `region` (string | null) — 投稿者に割り当てられたリージョンコード。
- `posted_at` (timestamp) — 投稿日時（UTC）。
- `media_type` (string) — image、video、またはcarousel。
- `play_count` (integer | null) — 動画の再生数。image投稿ではnull。
- `like_count` (integer | null) — スナップショット時点のいいね数。
- `text` (string | null) — キャプションのテキスト。
- `media_url` (string) — オリジナルメディアのURL。
- `thumbnail_url` (string) — サムネイルのURL。
- `score` (number | null) — フィードのランキングスコア。1回のレスポンス内でのみ比較できます。
- `efficiency_score` (number | null) — 投稿者のフォロワー数に対する相対的なパフォーマンス。
- `est_percentile` (number | null) — リージョン内での推定パーセンタイル。0〜1。
- `total_views_3m` (integer | null) — 投稿者の直近3か月の累計再生数。
- `median_views_3m` (integer | null) — 投稿者の直近3か月の再生数の中央値。
- `recent_collab_brands` (string[]) — 投稿者が最近コラボレーションしたブランド。
- `item_type` (string) — アイテム種別のタグ。コンテンツフィードではpost。
- `content_source` (string | null) — このアイテムを提示したパイプライン。
- `is_saved` (boolean | null) — そのアイテムがSOLARIアプリに保存されているかどうか。
- `updated_at` (timestamp | null) — 指標のスナップショットが最後に更新された日時。

## 例

```console
$ solari instagram brand lookalike content username=innisfreeofficial limit=3
```

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

```json
{
  "items": [
    {
      "item_type": "content",
      "post_id": "019ecb92-a677-7421-8ed6-752efe3d99d0",
      "author_id": "0196cb39-870a-7a76-9773-0b95789c877d",
      "username": "boo_rookie",
      "full_name": null,
      "profile_pic_url": null,
      "follower_count": null,
      "region": null,
      "posted_at": "2026-06-11T08:14:37Z",
      "media_type": "video",
      "play_count": 427258,
      "like_count": null,
      "score": null,
      "efficiency_score": null,
      "est_percentile": null,
      "updated_at": null,
      "media_url": "https://smr-images-b.bzine.co/users/0196cb39-870a-7a76-9773-0b95789c877d/posts/019ecb92-a677-7421-8ed6-752efe3d99d0/medias/019ecb92-a92e-7fc8-b644-69b930f2e197.mp4",
      "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=100ms/https://smr-images-a.bzine.co/users/0196cb39-870a-7a76-9773-0b95789c877d/posts/019ecb92-a677-7421-8ed6-752efe3d99d0/medias/019ecb92-a92e-7fc8-b644-69b930f2e1 …",
      "slug": "DZcD8KXxKwd",
      "text": null,
      "brand_match_score": null,
      "recent_collab_brands": [],
      "total_views_3m": null,
      "median_views_3m": null,
      "is_saved": null,
      "content_source": "lookalikes_by_top_ad"
    },
    "… 2 more"
  ],
  "basis": [
    {
      "item_type": "content",
      "post_id": "01a04c73-3ec3-7873-9e84-334c644abfe4",
      "author_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
      "username": "hwitto_",
      "full_name": null,
      "profile_pic_url": null,
      "follower_count": null,
      "region": null,
      "posted_at": null,
      "media_type": "video",
      "play_count": 155729,
      "like_count": null,
      "score": null,
      "efficiency_score": null,
      "est_percentile": null,
      "updated_at": null,
      "media_url": "https://smr-images-a.bzine.co/users/0196c474-c96e-71ad-aceb-61af051c81d3/posts/01a04c73-3ec3-7873-9e84-334c644abfe4/medias/01a04c73-4036-7a83-a52a-97b0058e6732.mp4",
      "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=100ms/https://smr-images.bzine.co/users/0196c474-c96e-71ad-aceb-61af051c81d3/posts/01a04c73-3ec3-7873-9e84-334c644abfe4/medias/01a04c73-4036-7a83-a52a-97b0058e6732 …",
      "slug": "DckGrZ6vZiU",
      "text": null,
      "brand_match_score": null,
      "recent_collab_brands": [],
      "total_views_3m": null,
      "median_views_3m": null,
      "is_saved": null,
      "content_source": "lookalikes_by_top_ad"
    },
    "… 5 more"
  ],
  "region": "KR"
}
```

## MCP 呼び出しとして

```json
{
  "name": "solari_instagram_brand_lookalike_content",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 3
  }
}
```

## 注意点

- limitは50に上限で切り詰められます。
- basisが空の場合、そのブランドには種にできる広告投稿がまだないことを意味します。

## 関連ツール

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