Chrome拡張機能 (Beta)
FourA Chrome拡張機能は、ブラウザに2つのツールを追加します。ポップアップは、proxyポート経由でプロキシユーザーの1つを通してChromeをルーティングします。DevToolsのFourAタブは、ページが送信するあらゆるリクエストを即座に使用可能なAPI呼び出しに変換します。
この拡張機能はベータ版です。まだChromeウェブストアには公開されていないため、Chromeの開発者モードでインストールします。画面や設定は今後変更される可能性があります。Chromeバージョン116以降が必要で、Freeプランを含むすべてのプランで動作します。
インストール
ZIPファイルはダッシュボードにあります。サイドバーのToolsの下にあるExtensionを開き、Downloadをクリックします。
- ZIPファイルをダウンロードして解凍します。Chromeはこのフォルダーから拡張機能を読み込むため、フォルダーを保持してください。
chrome://extensionsを開き、右上のデベロッパーモードをオンにします。- パッケージ化されていない拡張機能を読み込むをクリックし、解凍したフォルダーを選択します。
- ツールバーのパズルアイコンからFourAをピン留めします。アイコンはFourAがオフの間はグレーで、ルーティング中は緑色のドットが表示されます。
アップデート
拡張機能は1時間に1回およびポップアップを開いたときに新しいバージョンを確認します。ポップアップのSettings内にあるVersionのCheck nowをクリックすると、即座に確認できます。新しいバージョンが利用可能な場合、ポップアップにバージョン番号とDownloadボタンが表示されます。新しいバージョンを解凍し、パッケージ化されていない拡張機能を読み込むでそのフォルダーを選択します。新しいバージョンがどのフォルダーから読み込まれても、FourAは自動的に置き換わり、設定は保持されます。現在のフォルダーに上書き解凍した場合は、FourAを再読み込みするだけで完了します。0.3.1以前からアップデートする場合は、新しいカードとして一度インストールされるため、プロキシユーザーを再度選択して古いカードを削除してください。
開始する前に
- プロキシユーザー。ダッシュボードのProxyページで作成してください。詳細はProxyを参照してください。
- 同じChrome内でダッシュボードにサインインしていること。拡張機能はダッシュボードからのみプロキシユーザー情報を読み込みます。ダッシュボードのタブが開いていない場合、バックグラウンドでタブを開いて読み込み、その後閉じます。
FourA経由でブラウジングする
ポップアップにはConnect、Location、Settingsの3つのページがあります。
Connect
- ツールバーからFourAを開き、このブラウザで使用するプロキシユーザーを選択します。
- 大きなスイッチを押します。
- Address sites seeを確認します。FourAは設定から推定するのではなく、トンネル経由でそのアドレスを実際に測定し、比較のためにその横にYour addressを表示します。
Traffic this periodには、プランのプロキシトラフィックのうち使用済みの容量が表示されます。
Location
- ネットワーク: Shared（共有プール、プラン内トラフィック）または Premium（レジデンシャル、GB単位課金）。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はIP範囲指定です。 - ローカルネットワークや自マシンをトンネルしない: ドットを含まない名前、
localhost、.local、およびプライベートIPアドレス範囲は、リストの設定に関係なくローカル接続を維持します。 - プレーンな http:// ページでローカル接続を使用する: プロキシポートは暗号化された接続のみを転送します。オフの場合、暗号化されていない
http://ページは読み込まれません。オンの場合、ローカル接続経由で読み込まれ、Webサイト側には実際のアドレスが表示されます。 - WebRTCによるプロキシのバイパスを防止: トンネル稼働中にWebページが実際のアドレスを取得するために使用できる経路を遮断します。
- シークレット ウィンドウ: シークレット ウィンドウでもトンネルを使用します。
chrome://extensions、FourA、詳細、シークレット モードでの実行を許可する を有効にした場合のみ、FourA はシークレット ウィンドウ内でプロキシ認証を自動処理できます。許可するまでは、Chrome がシークレット ウィンドウでパスワードの入力を求めます。 - 他ツール用プロキシアドレス: 選択されたプロキシユーザー情報をパスワード付きのプロキシURLとして表示します。対応する任意のクライアントに貼り付けて使用できます。パスワードと同様に扱ってください。
- プロキシユーザー: Reload from dashboard は、作成または変更したプロキシユーザー情報を再取得します。Forget on this computer は、このブラウザからそれらを削除します。
アイコンが赤色に変わった場合
数字付きの赤いアイコンは、直近1分間にプロキシがその回数分の接続を拒否したことを示します。理由を確認するには FourA を開いてください。主な原因は以下のとおりです。
- Too many connections at once: プランのオープントンネル制限です。接続が閉じるとページの一部が再度読み込まれます。
- Too many new connections this minute: プランの1分あたりの新規トンネル制限です。すべてのリトライもカウントされるため、1分待ってから再読み込みしてください。
- This period's proxy traffic is used up または Premium traffic is used up: Billing ページでトラフィックを追加するか、次の期間までお待ちください。
- The proxy is not in your plan: Billing ページでプランをご確認ください。
- The proxy did not accept the password: プロキシユーザーがダッシュボードでローテーションまたは削除された可能性があります。再度選択してください。
- Another extension controls the proxy: 他の拡張機能がChromeのプロキシ設定を保持している間、FourAはルーティングを行いません。該当の拡張機能をオフにし、スイッチを一度オフにしてから再度オンにしてください。
ご利用プランの現在の制限は Usage & Limits ページに記載されています。
Turn a Request Into an API Call
- 任意のページで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）とオプションの Exit country を選択し、呼び出しをcURL、Python、Node、またはMCPとしてコピーします。呼び出しにはページで使用されたヘッダーとcookieが含まれます。
- Open in the playground をクリックしてダッシュボードの Playground に呼び出しを読み込むか、Run through FourA をクリックして実行します。実行後、The browser got と FourA got にページの応答と当サービスの応答が並んで表示されます。
リクエストを右クリックすると同様のコピー操作に加えて、Copy URL、Copy response、Open in a new tab も利用できます。
The API Key for Runs
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は、そのキーがアカウントに属している場合、同じキーが選択された状態で開きます。それ以外の場合はキーの選択を求められます。
What It Costs
拡張機能は無料です。当サービスの出口を経由して送信されるトラフィックは、プロキシポート上の他のクライアントと同様に、プランのプロキシ許容量に対してカウントされます。DevToolsから実行する呼び出しには通常のAPI料金が適用されます。Plans and Metering をご覧ください。
What It Stores and Sends
- 選択したproxyユーザー名とパスワードはこのコンピューター上に保持されます。
- DevToolsタブで選択したAPIキーは、Chromeを閉じるまで、または指定した場合にこのコンピューター上に保持されます。
- アクセスしたページに関する情報は保存されず、弊社に送信されることもありません。
- 拡張機能は単独で動作する場合、サイト側から見えるアドレスをipinfo.io（ビジー状態の場合はCloudflare、次にapi.ipify.org）に問い合わせ、最新バージョンを確認するために1時間に1回および起動時にfoura.aiに問い合わせ、ダッシュボードからproxyユーザーと国リストを読み取り、dns.googleまたはCloudflareからproxyのアドレスを検索します。それ以外の処理は、ボタンを押したときにのみ実行されます。
- cookieを含めてコピーされた呼び出しは、サインイン中のセッションを再現します。パスワードと同様に扱い、公開された場所に貼り付けないでください。
制限事項
- ブラウザはトンネル経由で独自の暗号化接続を確立するため、サイト側には弊社のアドレスとお客様のブラウザが表示されます。リクエスト元を検証するページや完全なブラウザレンダリングはAPIによって処理されます。詳細はサイトチェックを参照してください。
- この拡張機能はChrome向けにのみ構築およびテストされています。