# solari catalog instagram account history

> Instagram アカウントのフォロワー数・投稿数の推移です。

- **CLI**: `solari catalog instagram account history`
- **MCP ツール**: `solari_catalog_instagram_account_history`
- **アクセス権**: `solari:read` — トライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。
- **対象プラン**: 有料プランまたはトライアル
- **クレジット**: 1

SOLARI が記録した値で、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 があるときは無視されます。
- `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)。
- `granularity` (enum, 任意, 既定値 "day") — day は UTC の 1 日につき 1 点だけ残し、all はすべての点を返します。 値: `day`, `all`.

## レスポンス

### `Response`

- `found` (boolean) — カタログにないアカウントなら false です。
- `account_id / username` (string) — 特定したアカウント。
- `granularity` (string) — 適用された day または all。
- `since / until` (date) — 対象の UTC 日付範囲。
- `current` (object | null) — カタログの現在の値。日付範囲に関係なく付きます。
- `points` (object[]) — 記録された値です。古い順です。
- `truncated` (boolean) — 古い点が切り捨てられたとき true。since を狭めてください。

### `current`

- `follower_count / following_count / post_count` (integer | null) — カタログの現在の数値。
- `is_verified / is_private` (boolean | null) — 認証バッジと非公開かどうか。
- `collected_at` (timestamp | null) — Instagram からプロフィールを最後に収集した時刻。

### `points[]`

- `captured_at` (timestamp) — SOLARI がこの値を記録した時刻（UTC）。
- `follower_count / following_count / post_count` (integer | null) — その時点の数値。
- `is_verified / is_private` (boolean | null) — その時点の認証バッジと非公開かどうか。

## 例

```console
$ solari catalog instagram account history username=innisfreeofficial since=2025-03-01 until=2025-03-07
```

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

```json
{
  "found": true,
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "granularity": "day",
  "since": "2025-03-01",
  "until": "2025-03-07",
  "current": {
    "follower_count": 847643,
    "following_count": 17,
    "post_count": 4164,
    "is_verified": true,
    "is_private": false,
    "collected_at": "2026-09-28T05:30:38.364000Z"
  },
  "points": [
    {
      "captured_at": "2025-03-01T18:05:16.810000Z",
      "follower_count": 881841,
      "following_count": 22,
      "post_count": 3611,
      "is_verified": true,
      "is_private": false
    },
    {
      "captured_at": "2025-03-02T22:08:10.426000Z",
      "follower_count": 881784,
      "following_count": 22,
      "post_count": 3611,
      "is_verified": true,
      "is_private": false
    },
    {
      "captured_at": "2025-03-03T23:15:12.611000Z",
      "follower_count": 881711,
      "following_count": 22,
      "post_count": 3612,
      "is_verified": true,
      "is_private": false
    },
    "… 4 more"
  ],
  "truncated": false
}
```

## MCP で呼び出す場合

```json
{
  "name": "solari_catalog_instagram_account_history",
  "arguments": {
    "username": "innisfreeofficial",
    "since": "2025-03-01",
    "until": "2025-03-07"
  }
}
```

## 注意点

- since と until は UTC 日付で、両端を含みます。指定しなければ直近 90 日です。
- SOLARI がアカウントを収集したときにだけ値が残るため、途中に空白があるのは正常です。
- ほとんどのアカウントは 2025 年 8 月末から 2026 年 9 月末まで記録がありません。ほとんどのアカウントは 2026-09-28 から記録を再開しています。
- current を今日の数字として扱う前に、current.collected_at を確認してください。
- カタログだけを読みます。アカウントがない場合は、先に solari fetch instagram account username=… を呼んでください。記録はそこから始まり、過去の値は埋められません。

## 関連ツール

- [`solari_catalog_instagram_account_profile`](https://solari.sh/docs/tools/catalog-instagram-account-profile.md?lang=ja)
- [`solari_catalog_instagram_content_history`](https://solari.sh/docs/tools/catalog-instagram-content-history.md?lang=ja)
- [`solari_fetch_instagram_account`](https://solari.sh/docs/tools/fetch-instagram-account.md?lang=ja)