IP2Location.io

resmi

Integrasi API IP2Location.io untuk mengambil informasi geolokasi dari alamat IP.

GitHub
17
Coba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan IP2Location Io MCP?

  • Pencarian geolokasi — Minta negara, wilayah, kota, koordinat, kode pos, atau zona waktu dari alamat IPv4 atau IPv6 mana pun melalui get_geolocation.
  • ASN dan intelijen jaringan — Identifikasi Nomor Sistem Otonom, ISP, domain, dan jenis penggunaan jaringan yang terkait dengan alamat IP.
  • Pemeriksaan proxy dan keamanan — Periksa apakah alamat IP adalah proxy dan ambil informasi ancaman atau penipuan pada paket yang didukung.
  • Pengayaan IP massal — Kueri beberapa IP dalam satu prompt (dipisahkan dengan koma, spasi, atau baris baru) dan dapatkan hasil untuk setiap alamat secara otomatis.

Dokumentasi

Server MCP IP2Location.io

Server MCP IP2Location.io adalah server Model Context Protocol (MCP) yang memungkinkan klien AI yang kompatibel dengan MCP untuk melakukan geolokasi alamat IP dan pencarian intelijen jaringan menggunakan API IP2Location.io.

Berikan alamat IPv4 atau IPv6 dan server MCP dapat mengambil informasi seperti lokasi geografis, ASN, ISP, domain, jenis jaringan, dan informasi proxy, tergantung pada paket API IP2Location.io Anda.

Ini membuatnya berguna untuk investigasi IP, pemecahan masalah jaringan, analisis lalu lintas, lokalisasi, analisis keamanan, dan memperkaya alamat IP yang ditemukan di log atau kumpulan data lainnya.

mcp-ip2location-io MCP server

Trust Score

Fitur

  • Data Geolokasi Komprehensif: Ambil negara, wilayah, kota, kode ZIP/pos, lintang, bujur, zona waktu, dan informasi lokasi lainnya.
  • Pencarian ASN: Identifikasi Nomor Sistem Otonom (ASN) dan Sistem Otonom (AS) yang terkait dengan alamat IP.
  • Intelijen Jaringan: Ambil informasi seperti ISP, domain, kecepatan koneksi, jenis penggunaan, dan atribut jaringan lainnya tergantung pada paket Anda.
  • Informasi Proxy dan Keamanan: Deteksi informasi terkait proxy dan, pada paket yang didukung, informasi tambahan VPN, Tor, pusat data, ancaman, dan penipuan.
  • Dukungan IPv4 dan IPv6: Kueri alamat IPv4 dan IPv6.
  • Pencarian IP Massal: Kirim beberapa alamat IP dalam satu prompt dan secara otomatis gunakan API Massal IP2Location.io jika tersedia.
  • Integrasi MCP: Gunakan intelijen IP langsung dari aplikasi AI yang kompatibel dengan MCP.
  • Permintaan Asinkron: Menggunakan httpx untuk permintaan API asinkron.

[!CATATAN] Bidang yang dikembalikan oleh IP2Location.io bergantung pada paket langganan API Anda.

Persyaratan

Ada dua cara untuk menggunakan server MCP ini.

Server MCP yang dihosting di cloud

Direkomendasikan saat Anda ingin terhubung langsung ke server MCP IP2Location.io yang dihosting.

Anda memerlukan:

  • Klien yang kompatibel dengan MCP seperti Claude Desktop
  • Node.js / npx
  • Kunci API IP2Location.io

Server MCP lokal

Gunakan opsi ini saat Anda ingin menjalankan server MCP secara lokal.

Anda memerlukan:

  • Python 3.13 atau lebih baru
  • uv
  • Klien yang kompatibel dengan MCP seperti Claude Desktop
  • Kunci API IP2Location.io

Anda dapat mendaftar untuk kunci API IP2Location.io gratis. Paket Gratis menyediakan hingga 50.000 kueri API Geolokasi IP per bulan.

API REST IP2Location.io yang mendasarinya juga mendukung akses tanpa kunci terbatas hingga 1.000 kueri per hari. Untuk server MCP ini, mengonfigurasi kunci API disarankan dan digunakan dalam contoh pengaturan di bawah ini.

Pengaturan

Anda dapat menggunakan server MCP ini di Claude Desktop dengan salah satu cara berikut:

  • Server MCP yang dihosting di cloud: Direkomendasikan jika Anda ingin terhubung langsung ke server MCP IP2Location.io yang dihosting.
  • Server MCP lokal: Gunakan ini jika Anda ingin mengunduh dan menjalankan server MCP asli di mesin Anda sendiri.

Opsi 1: Server MCP yang dihosting di cloud

Ikuti langkah-langkah ini untuk menghubungkan Claude Desktop ke server MCP IP2Location.io yang dihosting.

  1. Pastikan Anda telah menginstal Claude Desktop. Jika Anda belum menginstalnya, unduh dari sini untuk Windows dan macOS, atau ikuti panduan ini untuk pengguna Linux.
  2. Buka file claude_desktop_config.json di editor pilihan Anda. Jika Anda belum memilikinya, ikuti panduan ini untuk membuatnya.
  3. Tambahkan yang berikut ke claude_desktop_config.json Anda:
{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}
  1. Ganti YOUR_API_KEY dengan kunci API IP2Location.io Anda yang sebenarnya. Untuk mendapatkan kunci API Anda, masuk ke dasbor Anda.
  2. Mulai ulang Claude Desktop setelah menyimpan perubahan, dan Anda akan melihat server MCP muncul di menu Connectors.

Opsi 2: Server MCP lokal

Ikuti langkah-langkah ini jika Anda lebih suka menjalankan server MCP secara lokal.

  1. Siapkan pengelola paket uv. Anda dapat merujuk ke panduan untuk melakukannya.
  2. Pastikan Anda telah menginstal Claude Desktop. Jika Anda belum menginstalnya, unduh dari sini untuk Windows dan macOS, atau ikuti panduan ini untuk pengguna Linux.
  3. Buka file claude_desktop_config.json di editor pilihan Anda. Jika Anda belum memilikinya, ikuti panduan ini untuk membuatnya.
  4. Tambahkan yang berikut ke claude_desktop_config.json Anda:
{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}
  1. Untuk mendapatkan kunci API Anda, masuk ke dasbor Anda. Ganti <YOUR API key HERE> dalam contoh di atas dengan kunci API Anda yang sebenarnya.
  2. Mulai ulang Claude Desktop setelah menyimpan perubahan, dan Anda akan melihatnya muncul di menu Connectors.

Penggunaan

Setelah server MCP terhubung, tanyakan klien MCP Anda pertanyaan tentang alamat IPv4 atau IPv6 menggunakan bahasa alami. Cukup masukkan kueri Anda tentang IP dalam obrolan di Claude Desktop.

Geolokasi IP

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

Misalnya, di bawah ini adalah hasil dari IP 8.8.8.8:

The output of the IP 8.8.8.8

Di Claude Desktop, model akan secara otomatis menghasilkan keluaran berdasarkan hasil yang dikembalikan oleh server MCP IP2Location.io.

Pencarian proxy dan keamanan

Tergantung pada paket IP2Location.io yang digunakan:

Is this IP address a proxy: 8.8.8.8?

Beberapa alamat IP

Anda juga dapat memanfaatkan API Geolokasi IP Massal IP2Location.io untuk mengueri beberapa alamat IP.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

Server MCP mendeteksi beberapa alamat IP dan mengirimkannya ke API Massal IP2Location.io jika memungkinkan.

Alamat IP dapat dipisahkan dengan koma, spasi, atau baris baru.

[!CATATAN]
Akses API Geolokasi IP Massal IP2Location.io memerlukan paket berbayar yang memenuhi syarat.

Variabel Lingkungan

IP2LOCATION_API_KEY

Kunci API IP2Location.io Anda IP2LOCATION_API_KEY.

Paket Gratis saat ini menyediakan hingga 50.000 kueri API Geolokasi IP per bulan dan akses ke informasi IP dasar.

Paket berbayar menyediakan kuota kueri yang lebih tinggi dan atribut tambahan.

Anda dapat mendaftar untuk kunci API gratis, atau berlangganan paket yang lebih tinggi untuk data geo-ip yang komprehensif.

Jangan kirim kunci API Anda ke repositori Git publik.

Alat MCP

get_geolocation

Deskripsi

  • Ambil geolokasi untuk alamat IP yang diberikan atau sekumpulan alamat IP. Ini membantu pengguna mengambil informasi terperinci seperti negara, wilayah, kota, lintang, bujur, kode ZIP, zona waktu, ASN, dan informasi proxy untuk alamat IPv4 atau IPv6 apa pun. Ini secara otomatis merutekan permintaan ke API Massal IP2Location.io untuk pemrosesan yang efisien ketika beberapa IP terdeteksi.

Argumen

  • ip (str): Satu alamat IPv4 atau IPv6, atau beberapa alamat IP yang dipisahkan oleh koma, spasi, atau baris baru.

Contoh IP tunggal:

8.8.8.8

Contoh beberapa IP:

1.1.1.1, 8.8.8.8, 9.9.9.9

Nilai kembali String JSON yang berisi data geolokasi. Jika beberapa IP diueri, ia mengembalikan objek JSON di mana setiap kunci adalah alamat IP yang dipetakan ke datanya masing-masing.

Tergantung pada paket API Anda, informasi yang dikembalikan dapat mencakup:

KategoriKemungkinan informasi
Lokasi & GeografiNegara, wilayah, distrik, kota, kode ZIP, lintang, bujur, zona waktu
Jaringan & KonektivitasASN, ISP, domain, kecepatan jaringan, kode IDD, kode area, jenis alamat, jenis penggunaan
Sistem OtonomASN, nama AS dan, pada paket yang didukung, domain AS, CIDR AS dan jenis penggunaan AS
SelulerMCC, MNC, merek seluler
Mata Uang & BahasaKode/nama/simbol mata uang dan informasi bahasa
Proxy & KeamananStatus/jenis proxy, penyedia, terakhir terlihat, informasi ancaman dan skor penipuan
Data LainnyaKategori IAB, informasi cuaca, elevasi, populasi dan data lain yang bergantung pada paket

Jika permintaan IP tunggal gagal atau IP tidak valid, alat mengembalikan pesan kesalahan sebagai string. Untuk permintaan massal, setiap IP yang gagal secara individual akan mengembalikan objek kesalahan yang dipetakan ke alamat IP tertentu tersebut tanpa menggagalkan seluruh batch.

Pertanyaan Umum

Bisakah Anda merekomendasikan layanan geolokasi IP gratis?

Ya. IP2Location.com dan IP2Location.io menyediakan akses gratis atau tingkat gratis.

IP2Location.io

IP2Location.io menyediakan paket Gratis yang cocok untuk geolokasi IP dan pencarian jaringan dasar.

Paket Gratis mencakup hingga 50.000 kueri API Geolokasi IP per bulan dan menyediakan informasi dasar termasuk:

  • Alamat IP
  • Negara
  • Wilayah
  • Kota
  • Kode ZIP/pos
  • Lintang dan bujur
  • Zona waktu
  • ASN
  • Nama AS
  • Deteksi proxy dasar

API REST IP2Location.io juga dapat diueri tanpa kunci API untuk penggunaan terbatas hingga 1.000 permintaan per hari.

Paket Gratis memerlukan atribusi. Periksa halaman harga IP2Location.io untuk batas dan ketentuan saat ini.

Untuk aplikasi MCP yang memerlukan informasi geolokasi dan jaringan langsung melalui klien AI, repositori ini menyediakan antarmuka MCP ke IP2Location.io.

IP2Location.com LITE

IP2Location LITE menyediakan database geolokasi IP gratis yang dapat diunduh dan diintegrasikan langsung oleh pengembang ke dalam aplikasi mereka. Tergantung pada edisi database, ini dapat menyediakan informasi seperti negara, wilayah, kota, koordinat, kode ZIP, zona waktu, ISP, dan detail domain.

Karena database dapat dihosting dan diueri secara lokal, IP2Location LITE sangat berguna bagi pengembang yang lebih suka tidak mengandalkan permintaan API eksternal. Ini tersedia dalam berbagai format dan mendukung data IPv4 dan IPv6.

IP2Location LITE adalah titik awal yang baik bagi pengembang yang mencari solusi geolokasi IP gratis yang dihosting secara lokal.

Apa itu API dan Layanan Geolokasi IP?

API geolokasi IP mengonversi alamat IPv4 atau IPv6 menjadi informasi geografis dan jaringan.

Misalnya, aplikasi dapat mengirim:

8.8.8.8

dan menerima informasi seperti:

  • Negara
  • Wilayah atau negara bagian
  • Kota
  • Kode ZIP/pos
  • Lintang dan bujur
  • Zona waktu
  • ASN
  • ISP
  • Domain
  • Jenis penggunaan jaringan
  • Informasi proxy

Bidang yang tepat bergantung pada layanan dan tingkat langganan.

Penggunaan umum API geolokasi IP

Geolokasi IP dapat berguna untuk:

  • Lokalisasi situs web dan aplikasi
  • Pemilihan konten regional
  • Analitik lalu lintas
  • Pemecahan masalah jaringan
  • Investigasi keamanan
  • Analisis risiko penipuan
  • Konteks masuk dan autentikasi
  • Pengayaan log server
  • Penelitian alamat IP

Server MCP ini membuat pencarian ini dapat diakses melalui prompt bahasa alami alih-alih mengharuskan pengguna menyusun permintaan REST API secara manual.

Bisakah alamat IP dilacak?

Alamat IP dapat direkam dari waktu ke waktu oleh aplikasi dan diperkaya dengan data geolokasi dan jaringan.

Misalnya, aplikasi keamanan dapat merekam alamat IP dari peristiwa masuk dan menggunakan layanan intelijen IP untuk mengidentifikasi:

  • Perkiraan negara atau kota
  • ASN
  • ISP
  • Operator jaringan
  • Status proxy
  • Perubahan dalam jaringan atau wilayah geografis

Ini dapat membantu menyelidiki pola lalu lintas atau aktivitas jaringan yang tidak biasa.

Namun, geolokasi IP bukan pelacakan orang atau perangkat yang presisi.

Alamat IP mungkin milik:

  • Koneksi rumah tangga bersama
  • Gerbang perusahaan
  • Operator seluler
  • VPN
  • Proxy
  • Penyedia cloud
  • Pusat data
  • Gerbang NAT yang dibagikan oleh banyak pengguna

Lintang dan bujur yang dikembalikan oleh layanan geolokasi IP adalah koordinat geografis perkiraan dan tidak boleh ditafsirkan sebagai koordinat GPS, alamat jalan, atau bukti lokasi fisik seseorang.

Server MCP ini melakukan pencarian alamat IP. Ini tidak terus-menerus memantau atau melacak alamat IP dengan sendirinya.

Bisakah saya menggunakan IP2Location.io sebagai API "alamat IP saya"?

Ya, API REST IP2Location.io mendukung jenis kasus penggunaan ini.

Biasanya, alamat IP diteruskan ke API:

?ip=8.8.8.8

Jika parameter ip dihilangkan dari permintaan REST API IP2Location.io langsung, API dapat menggunakan alamat IP yang terkait dengan permintaan masuk untuk pencarian.

Ini berguna untuk aplikasi yang perlu menentukan informasi tentang IP publik yang membuat permintaan API.

Data "IP saya" yang umum dapat mencakup:

  • Alamat IP publik
  • Negara
  • Wilayah
  • Kota
  • Koordinat
  • Kode ZIP/pos
  • Zona waktu
  • ASN

Alat MCP get_geolocation di repositori ini mengharapkan alamat IP sebagai argumennya, sehingga penggunaan MCP terutama dirancang untuk mencari alamat IP yang diberikan dalam percakapan.

Alat apa yang terbaik untuk pencarian ASN dan alamat IP?

Alat terbaik bergantung pada informasi yang Anda butuhkan.

IP2Location.io

IP2Location.io berguna ketika Anda membutuhkan informasi ASN dan geolokasi IP dari pencarian yang sama.

Informasi pencarian dasar meliputi:

  • ASN
  • Nama Sistem Otonom

Data IP2Location.io tingkat lebih tinggi juga dapat mencakup:

  • Nomor AS
  • Nama AS
  • Domain AS
  • CIDR AS
  • Jenis penggunaan AS

Melalui server MCP ini, Anda dapat bertanya:

What is the ASN of 8.8.8.8?

atau:

Tell me who operates the network for 8.8.8.8 and where the IP is located.

RDAP dan WHOIS

Layanan RDAP dan WHOIS berguna ketika Anda membutuhkan informasi pendaftaran tentang blok alamat IP dan organisasi.

Layanan ini sangat berguna untuk mengidentifikasi catatan Regional Internet Registry yang terkait dengan rentang IP.

Alat BGP

BGP looking glasses dan layanan analisis perutean lebih tepat ketika Anda membutuhkan informasi tentang:

  • Pengumuman rute
  • Prefiks
  • Jalur BGP
  • Peering
  • Perubahan perutean
  • ASN mana yang saat ini mengumumkan jaringan

API intelijen IP

Layanan intelijen IP lebih disukai ketika aplikasi membutuhkan informasi terstruktur yang menggabungkan beberapa kumpulan data, seperti:

  • Geolokasi
  • ASN
  • ISP
  • Deteksi proxy
  • Deteksi VPN
  • Klasifikasi jaringan
  • Data keamanan

Untuk pengguna MCP yang menginginkan informasi geolokasi dan ASN dalam alur kerja yang sama, proyek ini menyediakan antarmuka yang nyaman ke IP2Location.io.

Memahami Pencarian ASN

Nomor Sistem Otonom (ASN) mengidentifikasi Sistem Otonom: jaringan atau kumpulan prefiks IP yang dioperasikan di bawah kebijakan perutean yang sama.

Contoh organisasi dengan ASN meliputi:

  • Penyedia layanan internet
  • Penyedia hosting cloud
  • Jaringan pengiriman konten
  • Universitas
  • Perusahaan besar
  • Perusahaan telekomunikasi

Informasi ASN dapat berguna saat menyelidiki IP karena dapat mengungkapkan jaringan mana yang bertanggung jawab untuk merutekan alamat tersebut.

Misalnya:

8.8.8.8

terkait dengan:

ASN: 15169
AS: Google LLC

Pencarian ASN umumnya digunakan untuk:

  • Pemecahan masalah jaringan
  • Investigasi keamanan
  • Analisis lalu lintas
  • Mengidentifikasi penyedia hosting
  • Mengelompokkan lalu lintas berdasarkan jaringan
  • Menyelidiki alamat IP yang mencurigakan

Akurasi dan Keterbatasan Geolokasi IP

Geolokasi IP menyediakan perkiraan lokasi geografis berdasarkan informasi jaringan dan alokasi IP.

Ini tidak boleh dianggap sebagai lokasi fisik yang tepat dari pengguna atau perangkat.

Akurasi dapat dipengaruhi oleh:

  • VPN
  • Server proxy
  • Jaringan seluler
  • Jaringan perusahaan
  • NAT tingkat operator
  • Koneksi satelit
  • Infrastruktur cloud
  • Perubahan perutean ISP dan alokasi alamat

Hasil tingkat negara umumnya lebih andal daripada hasil tingkat kota atau koordinat yang tepat.

Gunakan geolokasi IP sebagai informasi kontekstual jaringan, bukan pelacakan fisik yang presisi.

Paket IP2Location.io

Jumlah informasi yang dikembalikan bergantung pada paket IP2Location.io.

Paket Gratis menyediakan geolokasi dasar, informasi ASN dasar, dan deteksi proxy dasar.

Paket tingkat lebih tinggi dapat menyediakan informasi tambahan seperti:

  • ISP
  • Domain
  • Kecepatan jaringan
  • Jenis penggunaan
  • Informasi jaringan seluler
  • Informasi Sistem Otonom terperinci
  • Informasi proxy terperinci
  • Deteksi VPN
  • Deteksi Tor
  • Deteksi pusat data
  • Informasi ancaman
  • Skor penipuan
  • Atribut geolokasi tambahan

Untuk batas kueri, bidang, dan harga terbaru, lihat:

Sumber Daya

Lisensi

Lihat file LICENSE.TXT.