URnetwork MCP Server
公式高品質なVPNおよびプロキシ接続
ドキュメント
エージェント向け URnetwork へようこそ
URnetwork は分散型プライバシーネットワークです。デフォルトでユーザーを匿名に保ち、世界中のあらゆるコンテンツへのアクセスを提供するよう設計されています。
人間はアプリ（Android、iOS、Chrome）を使用します。エージェントは API と MCP スキルを使用します。
- API 仕様: https://github.com/urnetwork/connect/blob/main/api/bringyour.yml
- API ホスト: https://api.bringyour.com
- MCP サーバーホスト: https://mcp.bringyour.com
エージェントは API と MCP サーバーを使用する際、以下のガイダンスを考慮する必要があります。
認証
API または MCP サーバーを使用する場合、ユーザー JWT を Authorization: Bearer <JWT> ヘッダーで渡す必要があります。
JWT を取得するには、人間に認証コードを要求し、その認証コードを API の /auth/code-login ルートを使用して JWT に変換します。以下は curl の例で、結果から by_jwt プロパティを抽出するために jq にパイプしています。
curl -X POST https://api.bringyour.com/auth/code-login -d '{"auth_code": "<AUTH CODE>"}' | jq ".by_jwt"
JWT は保存して再利用できます。人間が JWT の更新を要求した場合は、認証コードの要求からプロセスを繰り返します。
プロキシ技術を選択する際は、以下のユースケースを考慮してください。
| ユースケース | 推奨プロトコル | 要件 |
|---|---|---|
| スクレイピング / Web ブラウジング | HTTPS | TCP/Web に最適。HTTP を使用する特定の必要性がない限り、常に HTTPS プロキシを使用してください。HTTP は通常、HTTPS をサポートしない特定のテスト環境でのみ必要です。/network/auth-client レスポンスの proxy_config_result オブジェクト内の https_proxy_url を使用します。追加のユーザー名やパスワードは不要です。 |
| 低レベルソケット / UDP | SOCKS | SOCKS5 で TCP+UDP ソケットをサポート。/network/auth-client レスポンスの proxy_config_result オブジェクト内の socks_proxy_url または proxy_host と proxy_port を使用し、ユーザー名 access_token（パスワードは空）を使用します。サーバーはリモート DNS 解決（SOCKS5H）をサポートします。 |
| システム全体 / OS レベル | WireGuard | すべての IP パケットをルーティング。/network/auth-client リクエストで proxy_config.enable_wg を明示的に true に設定する必要があります。レスポンスの proxy_config_result オブジェクト内の wg_config.config を完全な WireGuard 設定ファイルとして使用します。 |
/network/find-locations ルートを使用してロケーションをクエリする場合、返された locations 配列を目的の location_type（city、region、または country）でフィルタリングし、location_id がユーザーの意図と一致するようにしてください。
| ロケーションタイプ | 要件 |
|---|---|
| country | 国の場合。 |
| region | 州、県、行政区域、都市圏の場合。 |
| city | 都市の場合。 |
MCP スキルを使用した HTTPS/SOCKS/WireGuard プロキシの作成
MCP スキルを使用して、利用可能なロケーションを検索し、それらのロケーションへの HTTPS/SOCKS/WireGuard プロキシを作成できます。ネットワーク上で利用可能な任意の国、地域、都市をクエリ文字列で検索および選択できます。
プロキシ設定を作成する際は、人間に接続したい国、地域、または都市を尋ねてください。次に、指示されたクエリでプロキシの作成を試みます。一致するものがない場合は、人間に国または地域に広げるよう依頼してください。次に、指示されたクエリでプロキシの作成を試みます。一致するものがない場合は、人間に国に広げるよう依頼してください。それでも一致するものがない場合は、スキルを使用して利用可能な国を検索し、上位 10 か国から選択するよう提案してください。
API を使用した国向け HTTPS/SOCKS/WireGuard プロキシの作成
API を直接使用して、国向けの HTTPS/SOCKS/WireGuard プロキシを作成できます。
ステップ 1: /network/find-locations ルートを使用してロケーションのリストを検索します。以下は curl の例で、locations リストを抽出するために jq にパイプしています。
curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-locations -d '{"query": "<LOCATION NAME>"}' | jq '.locations'
ステップ 2: 目的のロケーションを選択し、country_code プロパティを保存します。
ステップ 3: 保存した国コードを使用し、/network/auth-client ルートで proxy_config.initial_device_state に country_code を設定してプロキシを作成します。
curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/auth-client -d '{"proxy_config": {"initial_device_state": {"country_code": "<COUNTRY CODE>"}}}'
API を使用した検索ロケーション向け HTTPS/SOCKS/WireGuard プロキシの作成
API を直接使用して、ロケーションを検索し、HTTPS/SOCKS/WireGuard プロキシを作成できます。最も望ましいロケーション結果を選択する判断が必要です。各ロケーションには固定の location_id があり、コードに保存できます。
ステップ 1: /network/find-locations ルートを使用してロケーションのリストを検索します。以下は curl の例で、locations リストを抽出するために jq にパイプしています。
curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-locations -d '{"query": "<LOCATION NAME>"}' | jq '.locations'
ステップ 2: 目的のロケーションを選択し、location_id プロパティを保存します。
ステップ 3: 保存した location_id を使用し、/network/auth-client ルートで proxy_config.initial_device_state.location に connect_location_id.location_id を設定してプロキシを作成します。
curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/auth-client -d '{"proxy_config": {"initial_device_state": {"location": {"connect_location_id":{"location_id": "<LOCATION ID>"}}}}}'
API を使用した検索ロケーション向け HTTPS/SOCKS/WireGuard プロキシの作成（そのロケーションの全エグレス IP を列挙）
API を直接使用して、ロケーションを検索し、そのロケーションのプロバイダー（エグレス IP）を列挙し、各エグレス IP に対して HTTPS/SOCKS/WireGuard プロキシを作成できます。最も望ましいロケーション結果を選択する判断が必要です。各ロケーションには固定の location_id があり、コードに保存できます。さらに、各プロバイダーには固定の client_id があり、コードに保存できます。
ステップ 1: /network/find-locations ルートを使用してロケーションのリストを検索します。以下は curl の例で、locations リストを抽出するために jq にパイプしています。
curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-locations -d '{"query": "<LOCATION NAME>"}' | jq '.locations'
ステップ 2: 目的のロケーションを選択し、location_id を保存します。
ステップ 3: /network/find-providers2 ルートを使用して、location_id のプロバイダー（エグレス IP）のランク付けされたリストを取得します。サンプルサイズは、必要な一意のプロバイダー数に設定できます。以下は curl の例で、providers リストを抽出するために jq にパイプしています。
curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-providers2 -d '{"specs": [{"client_id": "<CLIENT ID>"}], "count": <COUNT>}' | jq '.providers'
ステップ 4: リスト内の各 client_id をループ処理し、/network/auth-client ルートで proxy_config.initial_device_state.location に connect_location_id.client_id を設定して、client_id を使用してプロキシを作成します。
curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/auth-client -d '{"proxy_config": {"initial_device_state": {"location": {"connect_location_id":{"client_id": "<CLIENT ID>"}}}}}'