自動認識トラブルシューティングガイド

このページでは、プラグインの「アカウント追加/編集」で 自動認識 をクリックした際に発生する、認識に時間がかかりすぎる、無限待機、認識失敗（401/403/フォーマットエラーなど）、および送信できないなどの問題のトラブルシューティングについて説明します。

認識に時間がかかりすぎる（「認識中...」のまま）

自動認識は一時的なページを開いてサイト情報を読み取る必要があるため、以下の状況では明らかに遅くなります。

サイトで Cloudflare / ファイアウォール認証が有効になっている場合：一時的なウィンドウがポップアップ表示されたかどうかを確認してください。手動で認証を選択する必要がある場合は、タイムアウトする前に認証を完了してください。
ネットワーク/サイトの応答が遅い場合：しばらく待つか、ネットワーク/プロキシを切り替えてから再試行することをお勧めします。
権限不足：拡張機能が対象サイトにアクセスできることを確認し、選択した認証方式に必要な権限を付与してください。詳しくは権限管理を参照してください。

認識失敗：まず本当にログインしていることを確認してください

自動認識は、同じブラウザで対象サイトにすでにログインしていることに依存します。

まずブラウザで対象サイトの管理画面（コンソール）ページを開きます。
ログインページにリダイレクトされていないことを確認します（ページを一度更新して検証します）。
その後、プラグインに戻り自動認識を実行します。

認識失敗：認証方法の切り替えを試してください

サイト/カスタマイズバージョンによってインターフェースとログイン状態の処理が異なるため、認識失敗時にはまず認証方法の切り替えを試してください。

アクセストークン認証失敗：Cookie認証 に切り替えてから再度自動認識を実行してください。
AnyRouter：Cookie認証 を使用する必要があります。また、Cookie は現在ログインしているアカウントのものである必要があります。Cookie認証は、同じサイトで複数のアカウントを同時に使用することをサポートしていません。

認識されたサイト種別が正しくない

自動認識は決まった順序でシグナルを取得します。まずドメイン、次にデプロイが自身について公開しているサイト名（サイトの /api/status が返す system_name）、最後にページタイトルです。そのため、画面のタイトルが標準の「New API」のままでも、その背後でカスタマイズ版が動いているデプロイは、公開されているブランド名で種別を認識できます。

認識結果が実際のサイトと一致しない場合：

「アカウント編集」で サイト種別 を正しい種別に手動で変更して保存してください。サイト種別は拡張機能がどのインターフェース群を呼ぶかを決めるため、ブランド名よりも重要です。
どれを選べばよいか分からない場合は、まずそのアカウントのチェックインを一度実行する（クイックチェックイン）か、「アカウント編集」で チェックイン方法を再検出 をクリックしてください。拡張機能がサイト自身のシグナルから種別を推定し、「アカウント編集」の通知、自動チェックインの実行結果、キー管理の失敗ヒント、「概要」の「対応が必要」リストに書き出します。
種別を変更したら、もう一度認識して、利用可能なチェックイン方法が見つかることを確認してください。

このヒントは、アカウントがその時点で記録されたサイト種別を保持している間だけ表示されます。サイト種別を変更すると古い記録は無効になり、すでに離れた種別名を表示し続けることはありません。以降の読み取りでサイトが保存された種別と一致した場合も同様に無効になります。

送信できない / 保存できない：必須項目を一つずつ確認してください

必須項目が不足している場合、送信ボタンが無効になるか、保存に失敗します。必要な項目はサイトごとに異なるため、まずサイト種別を確認し、対応する項目をチェックしてください。

New API と互換サイト：サイト名、ユーザー名、ユーザー ID、Access Token、0 より大きいチャージ金額レートを確認します。Cookie 認証を使う場合は、セッション Cookie（Header 値）を取り込むか入力します。
Sub2API：サイト名、ユーザー ID、JWT Access Token、チャージ金額レートを確認します。Cookie 認証には対応していません。「拡張機能管理セッション（複数アカウント）」を有効にした場合は、Refresh Token の取り込みまたは入力も必要です。
OpenRouter：サイト名、OpenRouter Management Key、チャージ金額レートを確認します。ユーザー ID は不要で、Cookie 認証にも対応していません。
その他のサイト：フォームに現在表示されている必須マークと、アカウント手動追加ガイドの該当サイトの説明に従ってください。

最後の手段：アカウントの手動追加

自動認識が常に完了しない場合は、手動追加 に切り替えて、情報を補完し、その後アカウントを保存することができます。

詳細はアカウント手動追加ガイドを参照してください。