# solari fetch instagram post

> URL を指定して Instagram の投稿を 1 件収集し、投稿者を確認します。

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

公開 URL またはショートコードを指定して、Instagram の投稿を 1 件 SOLARI のカタログに収集し、投稿者も確認します。すでに保存済みの投稿の場合は何も取得しません。

**どんなときに使うか** — 投稿のリンクがあり、catalog content detail が item=null を返し、投稿者がわからないとき。

**返される内容** — 収集したかどうか、投稿者付きの投稿、その投稿者をクロールする fetch コマンド。

## パラメータ

- `url` (string, 任意, ≤ 512 chars) — 投稿の公開 URL（/p/、/reel/、/tv/）。
- `slug` (string, 任意, pattern ^[A-Za-z0-9_-]{3,20}$) — Instagram のショートコード。url より優先されます。

## レスポンス

### `Response`

- `ingested` (boolean) — この呼び出しでその場で収集した場合は true。
- `already_tracked` (boolean) — すでにカタログにあった場合は true。
- `fetched_on_demand` (boolean) — ingested と同じ。
- `found` (boolean) — その指定に該当する公開投稿が Instagram にない場合は false。
- `post_id` (uuid) — 保存された投稿。
- `account_id` (uuid) — 投稿者のアカウント。
- `username` (string) — 投稿者のハンドル。
- `item` (object | null) — メディアファイルを含む投稿。
- `note` (string) — この後に起きること。
- `next` (string) — 投稿者をクロールする fetch コマンド。

### `item`

- `post_id` (uuid) — ほかのコンテンツ系ツールで使う投稿 ID。
- `slug` (string) — 公開 URL に含まれるショートコード。
- `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) — 動画の再生数。画像の場合は null。
- `like_count` (integer | null) — いいね数。
- `text` (string | null) — キャプション。
- `media_url` (string) — メディアの URL。
- `thumbnail_url` (string) — サムネイルの URL。
- `score` (number | null) — ランキングのスコア。ランキング形式の一覧以外では null。
- `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) — 項目の種類。常に "content"。
- `content_source` (string | null) — 投稿の出どころのフィード。フィード経由でなければ null。
- `is_saved` (boolean | null) — SOLARI でこの投稿を保存したか。不明な場合は null。
- `updated_at` (timestamp | null) — 指標を最後に更新した日時。
- `assets` (object[]) — メディアファイル（掲載順）。それぞれに asset_url、media_type、video_duration があります。
- `assets[].asset_url` (string | null) — フルサイズの画像または動画の直接ダウンロードリンク。ファイルが保存されていない場合は null。

## 例

```console
$ solari fetch instagram post url=https://www.instagram.com/p/DcyMAmUh6FZ/
```

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

```json
{
  "ingested": true,
  "already_tracked": false,
  "fetched_on_demand": true,
  "found": true,
  "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "item": {
    "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "item_type": "content",
    "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
    "author_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "username": "innisfreeofficial",
    "slug": "DcyMAmUh6FZ",
    "posted_at": "2026-09-02T12:00:06Z",
    "media_type": "video",
    "play_count": 22467,
    "like_count": 3224
  },
  "note": "Collected live and stored now. The author is known by name only: run next to crawl their profile and posts.",
  "next": "solari fetch instagram account username=innisfreeofficial"
}
```

## MCP で呼び出す場合

```json
{
  "name": "solari_fetch_instagram_post",
  "arguments": {
    "url": "https://www.instagram.com/p/DcyMAmUh6FZ/"
  }
}
```

## 注意点

- 投稿者は名前だけのアカウントとして登録されます。プロフィールと投稿をクロールするには、next（fetch instagram account）を実行してください。
- 初回の収集には数秒かかります。

## 関連ツール

- [`solari_fetch_instagram_post_assets`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-post-assets.md?lang=ja)
- [`solari_catalog_instagram_content_detail`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-detail.md?lang=ja)
- [`solari_fetch_instagram_account`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-account.md?lang=ja)
- [`solari_fetch_instagram_posts`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-posts.md?lang=ja)