CaptchaSonic ブラウザ拡張機能は、手動でのブラウジング中や、Selenium のような自動化フレームワーク内で CAPTCHA を解決する最も簡単な方法です。このガイドでは、対応しているすべてのブラウザでのインストールと設定を説明します。

---

## 🚀 主な機能

*   **ゼロクリックでの解決**: ほとんどの主要な CAPTCHA 種別を自動で検出し、解決を開始します。
*   **非表示モード**: 視界を妨げずにバックグラウンドで動作します。
*   **幅広い互換性**: reCAPTCHA（v2/v3/非表示）、hCaptcha、GeeTest などに対応しています。
*   **ブラックリストのサポート**: 自動解決を無効にしたいドメインを指定できます。

---

## 1. 事前準備

インストールの前に、次のものが必要です。
1.  [CaptchaSonic アカウント](https://captchasonic.com)。
2.  [ダッシュボード](https://captchasonic.com/app) で取得した **API キー**。

> [!IMPORTANT]
> API キーは非公開にしてください。他人と共有したり、公開リポジトリにコミットしたりしないでください。

---

## 2. インストール

### Google Chrome の場合

拡張機能は新しい AI モデルで頻繁に更新されるため、最新の機能を使うには「パッケージ化されていない」版をインストールすることをおすすめします。

1.  **ストアからインストールする**: 最も簡単な方法です。[Chrome ウェブストア](https://chromewebstore.google.com/detail/captchasonic-automatic-ca/dkkdakdkffippajmebplgnpmijmnejlh) から直接追加してください。

または、未リリースの最新ビルドを使う場合:

1.  **ダウンロードする**: [GitHub Releases](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest) から最新の拡張機能の ZIP を入手します。
2.  **展開する**: ダウンロードしたフォルダを、ドライブ上の永続的な場所に解凍します。
3.  **拡張機能を管理する**: Chrome を開き、`chrome://extensions/` に移動します。
4.  **デベロッパーモード**: 右上の **Developer Mode** のトグルを有効にします。
5.  **パッケージ化されていない拡張機能を読み込む**: **Load unpacked** ボタンをクリックし、展開したフォルダを選択します。

![Chrome 拡張機能のセットアップ手順](/guides/BE/guide.7.png)

### Mozilla Firefox の場合

1.  **ストアからインストールする**: [Firefox アドオン](https://addons.mozilla.org/en-US/firefox/addon/captchasonic/) から直接追加します。

または、`.xpi` から手動でインストールします。

1.  **ダウンロードする**: [GitHub Releases](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest) から `.xpi` を入手します。
2.  **アドオンメニュー**: Firefox を開き、メニューボタン（三本線）をクリックして **アドオンとテーマ** を選択します。
3.  **ファイルからインストールする**: 管理中の拡張機能の上にある歯車アイコンをクリックし、**Install Add-on From File...** を選択します。
4.  **確認する**: `.xpi` ファイルを選択し、**追加** をクリックします。

---

## 3. 設定

インストールしたら、ブラウザのツールバーにある CaptchaSonic のアイコンをクリックして、設定のポップアップを開きます。

1.  **認証**: 最初のフィールドに **API キー** を貼り付け、**Save** をクリックします。
2.  **モジュールを有効にする**: 自動で解決したい CAPTCHA の種別をオンにします。
3.  **詳細オプション**:
    *   **Solving Delay**: 人間らしく見せたい場合は、遅延を設定します。
    *   **Auto-Submit**: チャレンジが解決されると、「Verify」を自動でクリックします。

![拡張機能の設定画面](/guides/BE/guide.17.png)

---

## 4. 使い方

この拡張機能は「設定したら、あとは任せる」ことを前提に設計されています。

*   **検出**: CAPTCHA のあるページを開くと、拡張機能のアイコンの状態が変わり、チャレンジを検出したことを示します。
*   **ステータス**: CAPTCHA のウィジェットの近くに、解決の進行状況を示す小さなステータスバッジが表示される場合があります。
*   **完了**: 解決が完了すると、拡張機能は結果のトークンを入力し、設定されていればフォームを送信します。

---

## 5. トラブルシューティング（FAQ）

**Q: 拡張機能が CAPTCHA を解決しません。**
*   A: [ダッシュボード](https://captchasonic.com/app) でクレジットが十分にあるか確認してください。設定に API キーが正しく貼り付けられているかも確認してください。

**Q: reCAPTCHA v3 で「Low Score」エラーが出ます。**
*   A: reCAPTCHA v3 は、ブラウザの履歴と IP の評判に依存します。高品質なプロキシを使うか、ブラウザのキャッシュを消去してみてください。

**Q: Chrome で拡張機能が「破損している」と表示されます。**
*   A: 拡張機能を読み込んだあとにフォルダを移動した場合に、よく発生します。`chrome://extensions/` から削除し、もう一度 "Load unpacked" をクリックしてください。

---

## 6. サポート

問題が解決しない場合は、[公式ダッシュボード](https://captchasonic.com/app) のライブチャットから技術チームにお問い合わせください。

---

> [!TIP]
> **開発者向けのメモ**: 大量のスクレイピングを行いますか？ 大幅に高いスループットを得るには、ブラウザ拡張機能の代わりに [REST API](/docs/api) の利用を検討してください。
