# solari fetch instagram hashtag search

> Find hashtags by keyword, with their sizes.

- **CLI**: `solari fetch instagram hashtag search`
- **MCP ツール**: `solari_fetch_instagram_hashtag_search`
- **アクセス権**: `solari:read` — サインイン済みの SOLARI アカウントであれば利用できます。
- **Required plan**: Free
- **Credit**: 0

Look hashtags up on Instagram by keyword and see how many posts each one has. Nothing is stored.

**どんなときに使うか** — When you need the exact spelling or the biggest variant of a tag before reading or collecting it.

**何が返るか** — Up to 20 hashtags with the post count Instagram reports.

## パラメータ

- `query` (string, 必須, ≤ 100 chars) — Keyword, with or without #.

## レスポンス

### `Response`

- `query` (string) — The keyword the lookup ran on.
- `hashtags` (object[]) — Matching hashtags, best match first.
- `found` (integer) — Hashtags returned.

### `hashtags[]`

- `name` (string) — Hashtag without #.
- `post_count` (integer | null) — Posts Instagram reports under it.

## 例

```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 is Instagram's own total, not the number of posts SOLARI has collected.
- There is no pagination: Instagram returns at most 20 candidates.

## 関連ツール

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