# solari fetch instagram account

> Instagram のハンドルを 1 件カタログに取り込みます。

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

正確なユーザー名を指定して、Instagram アカウントを 1 件 SOLARI のカタログに追加します。検索ではありません。1 日以内に収集したアカウントは再取得せず、それより古い場合はこの呼び出しで再収集します。タグやメンションで名前だけがカタログに載っているハンドルは、この呼び出しでクロールします。

**どんなときに使うか** — 正確なハンドルがわかっているのに、カタログ検索で見つからないとき。

**返される内容** — 取り込んだかどうか、account_id、結果を読むためのカタログコマンド。

## パラメータ

- `username` (string, 必須, ≤ 64 chars) — Instagram のユーザー名。

## レスポンス

### `Response`

- `ingested` (boolean) — この呼び出しでその場で収集した場合は true。
- `already_tracked` (boolean) — すでにクロール済みだった場合は true。
- `fetched_on_demand` (boolean) — ingested と同じ。
- `account_id` (uuid) — 取り込んだアカウント。
- `username` (string) — 特定したハンドル。
- `note` (string) — この後に起きること。
- `next` (string) — 結果を読むためのカタログコマンド。
- `refreshed` (boolean) — 1 日以上前の保存データをこの呼び出しで再収集した場合は true。
- `collected_at` (timestamp) — 保存済みプロフィールを収集した時刻（UTC）。

## 例

```console
$ solari fetch instagram account username=innisfreeofficial
```

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

```json
{
  "ingested": false,
  "already_tracked": true,
  "fetched_on_demand": false,
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "note": "Already in the SOLARI catalog. Nothing was scraped.",
  "next": "solari catalog instagram account profile username=innisfreeofficial"
}
```

## MCP で呼び出す場合

```json
{
  "name": "solari_fetch_instagram_account",
  "arguments": {
    "username": "innisfreeofficial"
  }
}
```

## 注意点

- 名前の検索には使わないでください。先にカタログのアカウント検索を使います。
- 初回の取り込みには数秒かかることがあります。クロールが終わるまで、指標とコラボレーションは空のままです。
- カタログ検索では見つからないのにプロフィールが空で返ってくるハンドルは、名前だけが登録された仮のアカウントです。この呼び出しでクロールします。

## 関連ツール

- [`solari_catalog_instagram_account_search`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-search.md?lang=ja)
- [`solari_catalog_instagram_account_profile`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-profile.md?lang=ja)
- [`solari_fetch_instagram_posts`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-posts.md?lang=ja)