# solari fetch instagram hashtag search

> 키워드로 해시태그와 게시물 수를 찾습니다.

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

키워드로 Instagram 해시태그를 찾고, 해시태그마다 게시물이 몇 개인지 보여 줍니다. 아무것도 저장하지 않습니다.

**언제 쓰나요** — 태그를 읽거나 수집하기 전에 정확한 철자나 게시물이 가장 많은 표기를 알아야 할 때 쓰세요.

**돌려주는 값** — 최대 20개 해시태그와 Instagram이 알려 주는 게시물 수.

## 파라미터

- `query` (string, 필수, ≤ 100 chars) — 키워드. #은 붙여도 되고 빼도 됩니다.

## 응답

### `Response`

- `query` (string) — 검색에 쓴 키워드.
- `hashtags` (object[]) — 일치한 해시태그 목록. 가장 잘 맞는 순.
- `found` (integer) — 돌려받은 해시태그 수.

### `hashtags[]`

- `name` (string) — #을 뺀 해시태그.
- `post_count` (integer | null) — Instagram이 알려 주는 이 해시태그의 게시물 수.

## 예시

```console
$ solari fetch instagram hashtag search query=skincare
```

_읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다._

```json
{
  "query": "skincare",
  "hashtags": [
    {
      "name": "skincare",
      "post_count": 128000000
    },
    {
      "name": "skincareroutine",
      "post_count": 31000000
    },
    {
      "name": "skincaretips",
      "post_count": 9400000
    }
  ],
  "found": 3
}
```

## MCP 호출

```json
{
  "name": "solari_fetch_instagram_hashtag_search",
  "arguments": {
    "query": "skincare"
  }
}
```

## 주의사항

- post_count는 Instagram이 집계한 전체 수입니다. SOLARI가 수집한 게시물 수가 아닙니다.
- 페이지 나누기는 없습니다. Instagram이 후보를 최대 20개까지만 줍니다.

## 관련 도구

- [`solari_fetch_instagram_hashtag_posts`](https://clip-pub.bzine.co/docs/tools/fetch-instagram-hashtag-posts.md?lang=ko)
- [`solari_catalog_instagram_tag_search`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-tag-search.md?lang=ko)