# 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 하루에 한 점만 남기고, 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://pub.brandazine.ai/docs/tools/catalog-instagram-account-profile.md?lang=ko)
- [`solari_catalog_instagram_content_history`](https://pub.brandazine.ai/docs/tools/catalog-instagram-content-history.md?lang=ko)
- [`solari_fetch_instagram_account`](https://pub.brandazine.ai/docs/tools/fetch-instagram-account.md?lang=ko)