# solari fetch instagram account

> Instagram 핸들 하나를 카탈로그에 추가합니다.

- **CLI**: `solari fetch instagram account`
- **MCP 도구**: `solari_fetch_instagram_account`
- **권한**: `solari:read`
- **이용 가능 플랜**: 무료 체험 · Plus · Pro · Enterprise
- **크레딧**: 1

정확한 username으로 Instagram 계정 하나를 SOLARI 카탈로그에 추가합니다. 검색 기능이 아닙니다. 하루 안에 수집한 계정이면 새로 수집하지 않고, 그보다 오래됐으면 지금 다시 수집합니다. 태그나 언급으로 이름만 알려진 핸들이면 지금 수집합니다.

**언제 쓰나요** — 정확한 핸들을 알고 있는데 카탈로그 검색에 나오지 않을 때 쓰세요.

**돌려주는 값** — 추가됐는지 여부, account_id, 그 계정을 읽는 카탈로그 명령.

## 파라미터

- `username` (string, 필수, ≤ 64 chars) — Instagram username.

## 응답

### `Response`

- `ingested` (boolean) — 이번 호출에서 바로 수집했으면 true.
- `already_tracked` (boolean) — 이미 수집돼 있었으면 true.
- `fetched_on_demand` (boolean) — ingested와 같은 값.
- `account_id` (uuid) — 추가된 계정.
- `username` (string) — 찾은 핸들.
- `note` (string) — 다음에 일어날 일.
- `next` (string) — 결과를 읽는 카탈로그 명령.
- `refreshed` (boolean) — 하루 넘게 지난 저장본을 지금 다시 수집했으면 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"
  }
}
```

## 주의사항

- 이름을 검색하는 데 쓰지 마세요. 먼저 catalog account search를 쓰세요.
- 처음 추가할 때는 몇 초 걸릴 수 있습니다. 수집이 끝날 때까지 지표와 협업 정보는 비어 있습니다.
- 카탈로그 검색에는 안 나오고 프로필을 읽으면 비어 있는 핸들은 이름만 등록된 계정입니다. 이 호출이 그 계정을 수집합니다.

## 관련 도구

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