Chrome拡張機能 (Beta)
FourA Chrome拡張機能は、ブラウザに2つのツールを提供します。ポップアップは、proxyポート経由で設定済みのproxyユーザーの1つを通してChromeを接続します。DevToolsのFourAタブは、ページが行うあらゆるrequestをすぐに使えるAPI呼び出しに変換します。
この拡張機能はベータ版です。まだChromeウェブストアには公開されていないため、Chromeの開発者モードでインストールします。画面や設定は今後変更される可能性があります。Chromeバージョン116以降が必要で、Freeプランを含むすべてのプランで動作します。
インストール
zipファイルはダッシュボードにあります。サイドバーのTools配下にあるExtensionを開き、Downloadをクリックしてください。
- zipファイルをダウンロードして解凍します。Chromeはこのフォルダーから拡張機能を読み込むため、フォルダーは削除しないでください。
chrome://extensionsを開き、右上のデベロッパーモードをオンにします。- パッケージ化されていない拡張機能を読み込むをクリックし、解凍したフォルダーを選択します。
- ツールバーのパズルアイコンからFourAを固定します。アイコンはFourAがオフの間はグレー表示され、ルーティング中は緑色のドットが表示されます。
アップデート
拡張機能は1時間に1回、およびポップアップを開いたときに新しいバージョンを確認します。ポップアップのSettings内のVersion配下にあるCheck nowをクリックすると、すぐに確認できます。新しいバージョンがある場合、ポップアップにバージョン番号とDownloadボタンが表示されます。新しいバージョンを解凍し、パッケージ化されていない拡張機能を読み込むでそのフォルダーを選択してください。新しいバージョンがどのフォルダーから読み込まれても、FourAは設定を保持したまま自身を置き換えます。現在のフォルダーに上書き解凍した場合は、Reload FourAをクリックするだけで完了します。0.3.1以前から更新する場合は、新しいカードとして一度インストールされるため、proxyユーザーを再度選択して古いカードを削除してください。
開始前の確認事項
- proxyユーザーが必要です。ダッシュボードのProxyページで作成してください。Proxyを参照してください。
- 同じChrome内でダッシュボードにサインインしている必要があります。拡張機能はダッシュボードからのみproxyユーザー情報を読み取ります。ダッシュボードのタブが開いていない場合、拡張機能は情報を読み取るためにバックグラウンドでタブを開き、読み取り後に閉じます。
FourA経由でのブラウジング
ポップアップには、Connect、Location、Settingsの3つのページがあります。
接続
- ツールバーからFourAを開き、このブラウザで使用するproxyユーザーを選択します。
- 大きなスイッチを押します。
- Address sites seeを確認します。FourAは設定値から推測するのではなく、トンネル経由でそのアドレスを実際に測定し、比較のためにその横にYour addressを表示します。
Traffic this periodには、プランのproxyトラフィックのうち使用済みの容量が表示されます。
ロケーション
- ネットワーク: Shared (共有プール、プランのトラフィック) または Premium (住宅用アドレス、プランのプレミアムトラフィックから消費)。Shared の場合、Use premium when shared cannot carry a page を有効にすると、共有ネットワークでリクエストを処理できない場合にプレミアムの出口ノードを使用します。プランにプレミアムトラフィックが含まれ、残量がある場合のみ動作します。
- 国: デフォルトでは任意の国。最近使用した国は1クリックで選択できます。
- 地域、都市、ネットワーク事業者: 国を選択した後の Premium 限定オプションです。
- アドレス: Keep one は同じ出口ノードを保持し、New every request はリクエストごとに変更し、New address は直ちに新しいアドレスを取得します。Premium で Keep one を選択した場合、Hold it for でアドレスを保持する期間 (分または時間単位) を設定します。
これらの選択肢に対応するスイッチは、Proxy Port で説明されているプロキシポートの設定と同じです。
設定
- トンネルを通す対象: リスト以外の Everything except、または指定した項目のみの Only these。
example.comはサブドメインを含み、*はワイルドカードとして機能し、203.0.113.0/24は範囲指定です。 - ローカルネットワークまたはこのマシンをトンネルしない: ドットのない名前、
localhost、.local、およびプライベートアドレス範囲は、リストの設定にかかわらずローカル接続のままになります。 - 通常の http:// ページでローカル接続を使用する: プロキシポートは暗号化された接続のみを中継します。オフの場合、通常の
http://ページは読み込まれません。オンの場合、ローカル接続経由で読み込まれ、サイトには実際のアドレスが表示されます。 - WebRTC によるプロキシのバイパスを防止: トンネルが有効な間にページが実際のアドレスを読み取る経路を遮断します。
- シークレットウィンドウ: シークレットウィンドウでもトンネルが使用されます。FourA がプロキシパスワードを自動入力できるようにするには、
chrome://extensions、FourA、詳細、シークレットモードでの実行を許可する の順に設定する必要があります。設定するまで、Chrome はシークレットモードでパスワードの入力を求めます。 - テーマ: ポップアップ用に System、Light、または Dark。
- 他のツール用プロキシアドレス: 選択したプロキシユーザーをパスワード付きのプロキシ URL として表示し、対応するクライアントに貼り付けて使用できます。パスワードと同様に扱ってください。
- プロキシユーザー: Reload from dashboard は、作成または変更したプロキシユーザーを反映します。Forget on this computer は、このブラウザからそれらを削除します。
アイコンが赤くなった場合
数字付きの赤いアイコンは、プロキシが直近1分間にその回数分の接続を拒否したことを示します。理由を確認するには FourA を開いてください。主な原因は以下のとおりです。
- 同時接続数が多すぎます: ご利用プランのオープン接続上限です。接続が閉じられるにつれてページの一部が再読み込みされます。
- この1分間の新規接続数が多すぎます: ご利用プランにおける1分あたりの新規接続上限です。再試行もカウントされるため、1分待ってから再読み込みしてください。
- 今期のプロキシトラフィック上限超過 または Premium traffic is used up: Billing ページでトラフィックを追加するか、次の請求期間をお待ちください。
- プロキシがプランに含まれていません: Billing ページでプラン内容をご確認ください。
- プロキシがパスワードを受け付けませんでした: プロキシユーザーがダッシュボード上でローテーションまたは削除された可能性があります。再度選択してください。
- 別の拡張機能がプロキシを制御しています: 別の拡張機能が Chrome のプロキシ設定を占有している間、FourA はルーティングを行いません。その拡張機能を無効にし、スイッチをオフにしてから再度オンにしてください。
ご利用プランの現在の制限事項は Usage & Limits ページで確認できます。
リクエストを API 呼び出しに変換
- 任意のページで DevTools を開き、Network の隣にある FourA タブを選択します (DevTools の幅が狭い場合は
»の後ろにあります)。FourA のインストール時に DevTools が開いていた場合は、一度閉じてから再度開いてください。 - ページを再読み込みします。このタブには Network と同様にページのリクエストが一覧表示されます。Hide ads and analytics はデフォルトで有効になっており、This site only でページ自身のリクエストのみに絞り込めます。
- ページ上に表示されているテキストを Find in responses に入力し、そのテキストを含むリクエストを特定します。リクエストを選択すると、その Headers、Payload、および Response が表示されます。
- FourA call の下でエンジン (Single、Proxy Finder、または Browser) を選択し、Proxy Finder の場合はオプションで Exit country を指定して、cURL、Python、Node、または MCP として呼び出しをコピーします。この呼び出しには、ページで使用された header と cookie が含まれます。Present the same browser and system as this window はデフォルトで有効になっています。呼び出しはこの Chrome に一致するブラウザプロファイルを要求するか、Browser の場合はこのウィンドウの User-Agent を送信します。
- Open in the playground をクリックしてダッシュボードの Playground に呼び出しを読み込むか、Run through FourA をクリックして実行します。実行後、The browser got と FourA got にページの応答と当システムの応答が並んで表示されます。
リクエストを右クリックすると、同様のコピー操作に加えて、Copy URL、Copy response、および Open in a new tab も利用できます。
実行用の API キー
Run through FourA は API キーとそのクレジットを使用します。タブの Settings で設定してください。
- Choose from your dashboard をクリックしてキーを選択するか、Or paste an API key にキーを貼り付けます。
- Chrome を閉じた後も保持する場合は、Keep the key on this computer にチェックを入れます。チェックしない場合、Chrome を閉じるまでのみ保持されます。
- Forget the key をクリックするとキーが削除されます。
Playground は、キーがアカウントに属している場合、同じキーが選択された状態で開きます。それ以外の場合はキーの選択を求められます。
料金
拡張機能自体は無料です。出口を経由して送信されるトラフィックは、proxyポート上の他のクライアントと同様に、プランのproxy割り当て量としてカウントされます。DevToolsから実行する呼び出しには、APIの通常料金が適用されます。プランと従量制課金を参照してください。
保存および送信されるデータ
- 選択したproxyユーザー名とパスワードは、このコンピューター内にのみ保持されます。
- DevToolsタブで選択したAPI keyは、Chromeを閉じるまで保持されるか、指定した場合はこのコンピューターに保存されます。
- 閲覧したページに関する情報は、一切保存されず、当社にも送信されません。
- 拡張機能は独自に、サイトから見えるアドレスを確認するためにipinfo.io(ビジー時はCloudflare、次にapi.ipify.org)へ問い合わせ、最新バージョンを確認するために1時間ごとおよび起動時にfoura.aiへ問い合わせ、ダッシュボードからproxyユーザーと国リストを読み込み、dns.googleまたはCloudflareからproxyのアドレスを解決します。それ以外の動作はすべて、ユーザーがボタンを押したときにのみ実行されます。
- cookieを含めてコピーした呼び出しは、サインイン中のセッションを再現します。パスワードと同様に扱い、公開された場所に貼り付けないでください。
- スイッチがオンの状態で設定を変更すると、FourAはChromeに保存されたproxy認証情報をクリアし、新しい設定がproxyに反映されるようにします。このクリアはproxy自体のアドレスにのみ適用されます。cookieやダッシュボードのサインイン状態は維持されます。
制限事項
- ブラウザはトンネル経由で独自の暗号化接続を確立するため、サイト側には当社のIPアドレスとお使いのブラウザ情報が認識されます。リクエスト元を厳密に検証するページや、完全なブラウザレンダリングが必要な処理はAPI側で処理されます。詳細はサイトチェックを参照してください。
- この拡張機能は、Chrome専用にビルドおよびテストされています。