Ambil URL publik sebagai pengunjung dari negara tertentu dengan tanda terima Ed25519 yang ditandatangani untuk membuktikan asal permintaan.
Juga dikenal sebagai regionfetch/regionfetch, mcp, regionfetch-mcp
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.1.1
- Commit terakhir
- 1 Sep 2026
- Lisensi
- MIT
Apa itu Region Fetch MCP?
Ambil URL publik sebagai pengunjung dari negara tertentu dengan tanda terima Ed25519 yang ditandatangani untuk membuktikan asal permintaan.
Ringkasan dibuat dari README proyek
Tentang Region Fetch MCP server
Region Fetch menyediakan cara untuk melihat URL HTTPS publik dari perspektif pengunjung di negara tertentu. Tool ini menggunakan satu tool bernama regionfetch untuk mengambil konten web sekaligus menyediakan tanda terima Ed25519 yang ditandatangani untuk membuktikan asal permintaan tersebut. Server ini dirancang untuk developer yang perlu memverifikasi tampilan website di berbagai lokasi geografis seperti US, DE, JP, BR, atau IN.
Server ini berjalan melalui transport stdio menggunakan Node 20.11 atau versi yang lebih tinggi. Anda dapat melakukan setup menggunakan npx atau dengan mengonfigurasi environment variables. Untuk penggunaan berkelanjutan, mode wallet yang direkomendasikan memerlukan REGION_FETCH_WALLET_PRIVATE_KEY dan batas REGION_FETCH_MAX_PAYMENT. Mode signature statis tersedia untuk pengujian tetapi hanya mengizinkan satu kali permintaan. Tool ini mendukung mode http dan browser untuk mengambil data.
Apa yang bisa Anda lakukan dengannya
- 1Verifikasi konten website regionalMinta URL tertentu untuk melihat tampilannya bagi pengguna yang berlokasi di Jepang.
- 2Buktikan asal permintaanDapatkan tanda terima yang ditandatangani untuk mengonfirmasi bahwa data diambil dari negara tertentu.
- 3Uji kompatibilitas permintaan tunggalLakukan pengecekan satu kali menggunakan satu tanda tangan otorisasi yang sudah dibuat sebelumnya.
- 4Validasi integritas responsPastikan body yang dikembalikan sesuai dengan tanda terima yang ditandatangani menggunakan field verifikasi.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Region Fetch MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Region Fetch MCP di Claude Code
$ claude mcp add --env 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' --env 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' mcp -- npx -y regionfetch-mcpInstal Region Fetch MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Instal Region Fetch MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Instal Region Fetch MCP di VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","regionfetch-mcp"],"env":{"REGION_FETCH_PAYMENT_SIGNATURE":"<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>","REGION_FETCH_WALLET_PRIVATE_KEY":"<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"}}'Instal Region Fetch MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Instal Region Fetch MCP di Codex
$ codex mcp add mcp --env 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' --env 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' -- npx -y regionfetch-mcpInstal Region Fetch MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "regionfetch-mcp"] [mcp_servers.mcp.env] REGION_FETCH_PAYMENT_SIGNATURE = "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>" REGION_FETCH_WALLET_PRIVATE_KEY = "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
Instal Region Fetch MCP di Gemini CLI
$ gemini mcp add -s user -e 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' -e 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' mcp npx -- -y regionfetch-mcpInstal Region Fetch MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Konfigurasi
REGION_FETCH_PAYMENT_SIGNATURERahasiaA single pre-made x402 authorization. Funds exactly one request, so this is for one-shot testing only; prefer the wallet key.
REGION_FETCH_WALLET_PRIVATE_KEYRahasiaPrivate key of a funded Base wallet. The server signs one fresh x402 authorization per tool call. Keep it in the host's env block; it is never a tool argument.
REGION_FETCH_BASE_URLDeployment origin.
REGION_FETCH_MAX_PAYMENTPer-payment ceiling, for example "$0.10". Use "off" to disable the cap.
| Nama | Deskripsi | Tipe |
|---|---|---|
| REGION_FETCH_PAYMENT_SIGNATURE | A single pre-made x402 authorization. Funds exactly one request, so this is for one-shot testing only; prefer the wallet key. | Rahasia |
| REGION_FETCH_WALLET_PRIVATE_KEY | Private key of a funded Base wallet. The server signs one fresh x402 authorization per tool call. Keep it in the host's env block; it is never a tool argument. | Rahasia |
| REGION_FETCH_BASE_URL | Deployment origin. | |
| REGION_FETCH_MAX_PAYMENT | Per-payment ceiling, for example "$0.10". Use "off" to disable the cap. |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauregionfetch/regionfetch is public and reachablegithub.com/regionfetch/regionfetch ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaregionfetch-mcp names regionfetch/regionfetch as sourcenpmjs.com/package/regionfetch-mcp ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-09-01github.com/regionfetch/regionfetch ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from regionfetch-mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya117 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubregionfetch-mcp
MCP server for Region Fetch — fetch a public HTTPS URL as a visitor in a specific country would see it, with a signed Ed25519 receipt proving where the retrieval came from.
Pre-release. Not yet published to npm. Build from source: https://github.com/regionfetch/regionfetch
npx -y regionfetch-mcp
Node 20.11+. stdio transport. Exposes exactly one tool: regionfetch.
Configuration
Wallet mode (recommended)
{
"mcpServers": {
"regionfetch": {
"command": "npx",
"args": ["-y", "regionfetch-mcp"],
"env": {
"REGION_FETCH_BASE_URL": "https://regionfetch.dev",
"REGION_FETCH_WALLET_PRIVATE_KEY": "0x...",
"REGION_FETCH_MAX_PAYMENT": "$0.10"
}
}
}
}
The server signs one fresh x402 authorization per tool call. This is the only configuration that keeps working past the first request.
Static signature (testing only)
"env": { "REGION_FETCH_PAYMENT_SIGNATURE": "<one x402 authorization>" }
One authorization funds one request, so the second tool call will fail. The server says so on stderr at startup. Useful for a one-shot compatibility check, not for a running server.
Wallet mode wins when both are configured.
Environment variables
| Variable | Default | Purpose |
|---|---|---|
REGION_FETCH_BASE_URL |
https://regionfetch.dev |
Deployment origin. A trailing /api is stripped. |
REGION_FETCH_WALLET_PRIVATE_KEY |
— | Funded Base wallet key. Enables wallet mode. |
REGION_FETCH_MAX_PAYMENT |
$0.10 |
Per-payment ceiling. off disables it. |
REGION_FETCH_PAYMENT_SIGNATURE |
— | A single pre-made authorization. |
REGION_FETCH_RPC_URL |
— | RPC endpoint for on-chain reads during payment construction. |
REGION_FETCH_TIMEOUT_MS |
120000 |
Per-request timeout. |
REGION_FETCH_ALLOW_INSECURE_HTTP |
0 |
Permit an http:// base URL. Development only. |
Legacy GEOFETCH_BASE_URL, GEOFETCH_PAYMENT_SIGNATURE, and PAYMENT_SIGNATURE
are still read, with the canonical names taking precedence. Their use is
reported as deprecated on stderr.
The tool
regionfetch — url (https, ≤ 2048 chars), country
(US | DE | JP | BR | IN), mode (http | browser, default http).
Results use the v1 envelope:
{
"status": 200,
"ok": true,
"response": { "data": { "...": "..." }, "receipt": { "...": "..." } },
"verification": { "valid": true, "signatureValid": true, "bodyHashMatches": true }
}
verification is an additive field: the server verifies each receipt against the
deployment's published key and the returned body before handing it to the model.
Consumers reading only status, ok, and response are unaffected.
Non-2xx responses keep the upstream status and JSON body verbatim and set
isError: true. Terminal paid failures (502, 504) keep their signed
receipts — they are the evidence the paid attempt happened.
Security
- Wallet keys and payment authorizations are never accepted as tool arguments, never written to stdout or stderr, and never returned in tool output.
- stdout carries JSON-RPC only; all diagnostics go to stderr through a redacting logger. Tests assert both.
- Only the
toolscapability is advertised. No resources, prompts, or subscriptions are implemented or claimed.
Full documentation: https://github.com/regionfetch/regionfetch
MIT
Pertanyaan tentang Region Fetch MCP
Bagaimana cara menambahkan Region Fetch MCP ke Claude Code?
Jalankan claude mcp add --env 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' --env 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' mcp -- npx -y regionfetch-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Region Fetch MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Bagaimana cara menggunakan server ini untuk banyak permintaan?
Gunakan mode Wallet dengan menyediakan private key wallet Base yang sudah terisi saldo pada environment variables.
Negara mana saja yang didukung untuk pengambilan data?
Tool ini saat ini mendukung US, DE, JP, BR, dan IN.
Bisakah saya menggunakan satu tanda tangan pembayaran untuk pengujian?
Ya, Anda bisa menggunakan signature statis untuk pengecekan kompatibilitas satu kali, tetapi pemanggilan tool kedua akan gagal.