URnetwork

resmi

Koneksi VPN dan Proxy berkualitas tinggi

GitHub

Apa yang bisa Anda lakukan dengan Urnetwork MCP?

Autentikasi dengan kode otorisasi — Ubah kode otorisasi yang diberikan pengguna menjadi JWT yang dapat digunakan kembali melalui auth/code-login.
Temukan lokasi proxy yang tersedia — Cari kota, wilayah, atau negara menggunakan network/find-locations dan filter hasil berdasarkan location_type.
Buat proxy HTTPS, SOCKS5, atau WireGuard — Hasilkan konfigurasi proxy untuk lokasi yang dipilih menggunakan network/auth-client dan pengaturan proxy_config yang sesuai.
Daftarkan IP egress untuk suatu lokasi — Ambil daftar penyedia yang telah diurutkan untuk location_id dengan network/find-providers2, lalu buat proxy per penyedia.

Dokumentasi

Selamat Datang di URnetwork untuk Agen

URnetwork adalah jaringan privasi terdesentralisasi. Jaringan ini dirancang untuk menjaga pengguna tetap anonim secara default dan memberi mereka akses ke semua konten di dunia.

Manusia menggunakan aplikasi (Android, iOS, Chrome). Agen menggunakan API dan keterampilan MCP:

Spesifikasi API tersedia di: https://github.com/urnetwork/connect/blob/main/api/bringyour.yml
API dihosting di: https://api.bringyour.com
Server MCP dihosting di: https://mcp.bringyour.com

Agen sebaiknya mempertimbangkan panduan di bawah ini saat menggunakan API dan server MCP.

Autentikasi

Saat menggunakan API atau server MCP, JWT pengguna harus dikirimkan dalam header Authorization: Bearer <JWT>.

Untuk mendapatkan JWT, mintalah kode autentikasi dari manusia, lalu ubah kode autentikasi tersebut menjadi JWT menggunakan rute API /auth/code-login. Contoh curl ada di bawah, disalurkan ke jq untuk mengekstrak properti by_jwt dari hasilnya:

curl -X POST https://api.bringyour.com/auth/code-login -d '{"auth_code": "<AUTH CODE>"}' | jq ".by_jwt"

JWT dapat disimpan dan digunakan kembali. Jika manusia meminta untuk menyegarkan JWT, ulangi prosesnya dimulai dengan meminta kode autentikasi.

Saat memilih teknologi proksi, pertimbangkan kasus penggunaan berikut:

Kasus Penggunaan	Protokol yang Direkomendasikan	Persyaratan
Scraping / Penjelajahan Web	HTTPS	Terbaik untuk TCP/Web. Selalu gunakan proksi HTTPS kecuali ada kebutuhan khusus untuk menggunakan HTTP. HTTP biasanya hanya diperlukan untuk lingkungan pengujian tertentu yang tidak mendukung HTTPS. Dari respons /network/auth-client, di dalam objek proxy_config_result, gunakan https_proxy_url. Tidak diperlukan nama pengguna atau kata sandi tambahan.
Socket Tingkat Rendah / UDP	SOCKS	Mendukung socket TCP+UDP dengan SOCKS5. Dari respons /network/auth-client, di dalam objek proxy_config_result, gunakan socks_proxy_url atau proxy_host dan proxy_port, dengan nama pengguna access_token (kata sandi kosong). Server mendukung resolusi DNS jarak jauh (SOCKS5H).
Seluruh Sistem / Tingkat OS	WireGuard	Merutekan semua paket IP. Dalam permintaan /network/auth-client, proxy_config.enable_wg harus secara eksplisit diatur ke true. Dalam respons, di dalam objek proxy_config_result, gunakan wg_config.config sebagai file konfigurasi WireGuard lengkap.

Saat menggunakan rute /network/find-locations untuk mencari lokasi, selalu filter array lokasi yang dikembalikan berdasarkan location_type yang diinginkan (city, region, atau country) untuk memastikan location_id sesuai dengan maksud pengguna.

Tipe Lokasi	Persyaratan
country	Untuk negara.
region	Untuk negara bagian, provinsi, wilayah administratif, dan area metropolitan.
city	Untuk kota.

Menggunakan keterampilan MCP untuk membuat proksi HTTPS/SOCKS/WireGuard

Keterampilan MCP dapat digunakan untuk menemukan lokasi yang tersedia dan membuat proksi HTTPS/SOCKS/WireGuard ke lokasi tersebut. Negara, wilayah, dan kota mana pun yang tersedia di jaringan dapat dicari dan dipilih menggunakan string kueri.

Saat membuat konfigurasi proksi, tanyakan kepada manusia negara, wilayah, atau kota mana yang ingin mereka hubungkan. Kemudian coba buat proksi untuk kueri yang mereka berikan. Jika tidak ada yang cocok, minta manusia untuk memperluas ke negara atau wilayah. Kemudian coba buat proksi untuk kueri yang mereka berikan. Jika tidak ada yang cocok, minta manusia untuk memperluas ke negara. Jika masih tidak ada yang cocok, gunakan keterampilan untuk menemukan negara yang tersedia dan sarankan mereka memilih salah satu dari 10 negara teratas.

Menggunakan API untuk membuat proksi HTTPS/SOCKS/WireGuard untuk suatu negara

API dapat digunakan secara langsung untuk membuat proksi HTTPS/SOCKS/WireGuard untuk suatu negara.

Langkah 1, cari daftar lokasi menggunakan rute /network/find-locations. Contoh curl ada di bawah, disalurkan ke jq untuk mengekstrak daftar lokasi.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-locations -d '{"query": "<LOCATION NAME>"}' | jq '.locations'

Langkah 2, pilih lokasi yang diminati dan simpan properti country_code.

Langkah 3, buat proksi menggunakan kode negara yang disimpan menggunakan rute /network/auth-client dan atur proxy_config.initial_device_state agar memiliki 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>"}}}'

Menggunakan API untuk membuat proksi HTTPS/SOCKS/WireGuard untuk lokasi pencarian

API dapat digunakan secara langsung untuk mencari lokasi dan membuat proksi HTTPS/SOCKS/WireGuard. Keputusan harus dibuat untuk memilih hasil lokasi yang paling diinginkan. Setiap lokasi memiliki location_id yang tetap dan dapat disimpan dalam kode.

Langkah 1, cari daftar lokasi menggunakan rute /network/find-locations. Contoh curl ada di bawah, disalurkan ke jq untuk mengekstrak daftar lokasi.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-locations -d '{"query": "<LOCATION NAME>"}' | jq '.locations'

Langkah 2, pilih lokasi yang diminati dan simpan properti location_id.

Langkah 3, buat proksi menggunakan location_id yang disimpan menggunakan rute /network/auth-client dan atur proxy_config.initial_device_state.location agar memiliki 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>"}}}}}'

Menggunakan API untuk membuat proksi HTTPS/SOCKS/WireGuard untuk lokasi pencarian, dengan menghitung semua IP egress di lokasi tersebut

API dapat digunakan secara langsung untuk mencari lokasi, menghitung penyedia (IP egress) di lokasi tersebut, dan membuat proksi HTTPS/SOCKS/WireGuard untuk setiap IP egress. Keputusan harus dibuat untuk memilih hasil lokasi yang paling diinginkan. Setiap lokasi memiliki location_id yang tetap dan dapat disimpan dalam kode. Selain itu, setiap penyedia memiliki client_id yang tetap dan dapat disimpan dalam kode.

Langkah 1, cari daftar lokasi menggunakan rute /network/find-locations. Contoh curl ada di bawah, disalurkan ke jq untuk mengekstrak daftar lokasi.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-locations -d '{"query": "<LOCATION NAME>"}' | jq '.locations'

Langkah 2, pilih lokasi yang diminati dan simpan location_id.

Langkah 3, ambil daftar peringkat penyedia (IP egress) untuk location_id menggunakan rute /network/find-providers2. Ukuran sampel dapat diatur sesuai jumlah penyedia unik yang dibutuhkan. Contoh curl ada di bawah, disalurkan ke jq untuk mengekstrak daftar penyedia.

curl -X POST -H 'Authorization: Bearer <JWT>' https://api.bringyour.com/network/find-providers2 -d '{"specs": [{"client_id": "<CLIENT ID>"}], "count": <COUNT>}' | jq '.providers'

Langkah 4, dengan mengulangi setiap client_id dalam daftar, buat proksi menggunakan client_id menggunakan rute /network/auth-client dan atur proxy_config.initial_device_state.location agar memiliki connect_location_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>"}}}}}'