# キーワードの例とリスト（API と MCP）

このページでは、キーワードでどの投稿がヒットし、どれがヒットしないかを実例で説明します。ルールの詳しい説明は[検索ルール](/ja/api/guides/search-rules/)をご覧ください。

## まず覚えておきたい 3 つのこと

1. **中国語は文字単位で照合**：キーワードの文字が順番どおりに連続して出現する必要があります。
2. **英語は単語単位で照合**：大文字・小文字は区別しませんが、単語の「一部分」にはヒットしません。
3. **カタカナと韓国語は語単位で照合**：語の後ろに別のカタカナや韓国語の助詞が続くと、別の語として扱われます。

## 英語

| 検索 | 投稿の内容 | ヒットする？ | 理由 |
| --- | --- | --- | --- |
| `AI` | 用 AI 寫文案 | ✅ | 独立した単語 |
| `AI` | AI繪圖教學 | ✅ | 英語が中国語に隣接していても、独立した単語として扱われる |
| `AI` | #AI #行銷 | ✅ | `#` は無視される |
| `AI` | ai 工具推薦 | ✅ | 大文字・小文字を区別しない |
| `AI` | AI-generated 圖片 | ✅ | ハイフンで単語が区切られる |
| `AI` | I paid for it | ❌ | 「ai」は paid の一部にすぎない |
| `AI` | Taiwan 必吃 | ❌ | 「ai」は Taiwan の一部にすぎない |
| `AI` | OpenAI 發表新模型 | ❌ | OpenAI で 1 つの単語 |
| `gram` | Instagram 限時動態 | ❌ | gram は Instagram の一部にすぎない |
| `app` | 3 個好用的 apps | ❌ | 単数形と複数形はまとめて扱われない |
| `top` | top10 必吃清單 | ❌ | 英語と数字が続いていると「top10」という 1 つの単語になる |
| `top 10` | Top 10 必吃美食 | ✅ | 2 つの単語が順番どおりに出現 |
| `work from home` | Work From Home 一年心得 | ✅ | 3 つの単語が順番どおりに出現 |
| `work from home` | #workfromhome 日常 | ❌ | 続けて書くと別の単語になる |

:::tip[「OpenAI」も「AI」も探したいときは？]
両方をキーワードとして送信します：`keywords=AI&keywords=OpenAI`。複数のキーワードは「または」の関係で、投稿がいずれか 1 つに一致すれば結果に含まれます。
:::

## 中国語

| 検索 | 投稿の内容 | ヒットする？ | 理由 |
| --- | --- | --- | --- |
| `蛋白` | 高蛋白質早餐 | ✅ | 「蛋白」の 2 文字が連続して出現 |
| `減脂` | 減脂期間怎麼吃 | ✅ | そのまま出現 |
| `減脂` | 減少脂肪攝取 | ❌ | 「減」と「脂」が連続していない |
| `減肥` | 减肥餐推荐 | ❌ | 繁体字と簡体字は区別される。「减」と「減」は別の文字 |
| `減脂` | 減，脂，成功！ | ✅ | 文字の間の句読点や空白は無視される |
| `CP值` | 這家CP值很高 | ✅ | 英語と中国語はそれぞれ照合され、順番どおりに出現すればよい |
| `5G手機` | 5G手機推薦 | ✅ | 英数字と中国語が順番どおりに出現 |
| `貓` | 熊貓好可愛 | ✅ | 1 文字だと、その文字を含むすべての投稿にヒットする |

:::caution[1 文字だけのキーワードは避けましょう]
`貓` や `茶` のような 1 文字のキーワードは、「熊貓」「茶几」など無関係な投稿に大量にヒットします。できるだけ 2 文字以上のキーワードを使ってください。
:::

## 日本語

| 検索 | 投稿の内容 | ヒットする？ | 理由 |
| --- | --- | --- | --- |
| `お金` | お金持ちになりたい | ✅ | ひらがなと漢字は中国語と同じく文字単位で照合 |
| `コーヒー` | コーヒーを飲む | ✅ | カタカナ語が「を」の手前で終わっている |
| `コーヒー` | コーヒー豆 | ✅ | カタカナ語が「豆」の手前で終わっている |
| `コーヒー` | アイスコーヒー | ❌ | 「アイスコーヒー」で 1 つのカタカナ語 |
| `コーヒー` | コーヒーショップ | ❌ | 同上 |

## 韓国語

| 検索 | 投稿の内容 | ヒットする？ | 理由 |
| --- | --- | --- | --- |
| `꿀팁` | 오늘의 꿀팁 | ✅ | 前後にスペースがあり、独立した語 |
| `꿀팁` | 꿀팁! | ✅ | 句読点は影響しない |
| `꿀팁` | 꿀팁을 공유합니다 | ❌ | 助詞「을」が後ろに付いて、「꿀팁을」という別の語になる |
| `꿀팁` | 꿀팁이 있어요 | ❌ | 同上（助詞「이」） |

## 実践練習：キーワードを漏れなく洗い出す

`/post/search` は一度に最大 30 個のキーワードを送信でき、キーワード同士は「または」の関係です。そのため、リスト全体をまとめて送信できます。

```bash
curl -G 'https://premium-api.throk.ai/post/search' \
  -H 'Authorization: Bearer sk-throk-...' \
  --data-urlencode 'keywords=珍珠奶茶' \
  --data-urlencode 'keywords=珍奶' \
  --data-urlencode 'keywords=波霸奶茶' \
  --data-urlencode 'keywords=粉圓奶茶' \
  --data-urlencode 'max_age_hours=168'
```

`/post/keyword-trend` では、キーワードごとに個別のトレンドラインが作成されるため（最大 10 個）、表記ごとの言及量を比較しやすくなります。

### 1. 言い方がたくさんある話題を追う

「珍珠奶茶」（タピオカミルクティー）に関する話題を追いたいとします。キーワードはそのままの形で出現する必要があるため、`珍珠奶茶` だけで検索すると、略称や別の言い方を取りこぼします。

おすすめのリスト：

```text
珍珠奶茶、珍奶、波霸奶茶、粉圓奶茶
```

### 2. 「AI」の話題を追う

`AI` だけで検索すると、「OpenAI」や「人工智慧」としか書かれていない投稿は見つかりません。

おすすめのリスト：

```text
AI、人工智慧、OpenAI、ChatGPT、Claude、Gemini
```

### 3. 台湾と中国の表記を両方カバーする

繁体字と簡体字は区別されるため、両方の表記を挙げる必要があります。

```text
減肥、减肥
```

### 4. 韓国語のキーワード

よく使われる助詞の付いた形もまとめて挙げます。

```text
맛집、맛집에서、맛집은、맛집이、맛집을
```

### 5. 日本語のカタカナ

よく使われる複合語もまとめて挙げます。

```text
コーヒー、アイスコーヒー、コーヒーショップ
```

## 送信前のチェックリスト

- [ ] **ほかの表記**はない？略称、正式名称、スペースの有無や続け書きの違い（大文字・小文字は気にしなくて OK）
- [ ] 英語のキーワードが、実は**別の単語の一部**になっていない？必要ならその単語も別途リストに加える
- [ ] **簡体字**の表記も必要？
- [ ] 韓国語に**助詞付き**の形はない？カタカナに**複合語**はない？
- [ ] キーワードが**1 文字だけ**になっていない？短すぎるとノイズが大量にヒットする
- [ ] **対象期間**は十分？`/post/search` のデフォルトは直近 3 時間のみ