💡 ULASAN & REFERENSI • DIPERBARUI: 20 October 2026 • REDAKSI AZWINN

Virustotal API Python: Panduan Integrasi dan Skrip GitHub

Pencarian terkait Virustotal API Python GitHub merujuk pada kebutuhan pengembang untuk mengotomatisasi analisis keamanan file, hash, atau URL menggunakan pustaka resmi VirusTotal v3 (vt-py) yang tersedia di platform GitHub. Integrasi ini memungkinkan sistem Anda untuk memeriksa potensi malware secara programmatic tanpa harus menggunakan antarmuka web.

Untuk memulai otomatisasi pemindaian keamanan menggunakan Python dan VirusTotal API v3, Anda memerlukan kunci API (API Key) yang bisa didapatkan secara gratis dengan mendaftar di situs resmi VirusTotal, serta memasang pustaka resmi melalui manajer paket pip.

Persiapan Awal dan Instalasi Pustaka Python

Langkah pertama sebelum menjalankan kode skrip dari GitHub adalah memasang pustaka vt-py. Buka terminal atau command prompt Anda, lalu jalankan perintah instalasi berikut:

pip install vt-py

Pastikan Anda sudah menyimpan API Key Anda ke dalam environment variable sistem (misalnya dengan nama VT_API_KEY) agar kunci otentikasi tidak terekspos secara langsung di dalam kode sumber.

Contoh Skrip Python untuk Memeriksa File Berdasarkan Hash

Berikut adalah contoh implementasi kode Python menggunakan pustaka resmi VirusTotal untuk memeriksa laporan pemindaian suatu file berdasarkan nilai hash SHA-256:

import os
import vt

# Mengambil API key dari environment variable
API_KEY = os.getenv("VT_API_KEY")

def check_file_hash(file_hash):
    client = vt.Client(API_KEY)
    try:
        # Melakukan query objek analisis berdasarkan hash
        file_obj = client.get_object(f"/files/{file_hash}")
        print(f"File: {file_hash}")
        print(f"Last Analysis Stats: {file_obj.last_analysis_stats}")
    except vt.APIError as e:
        print(f"Terjadi kesalahan API: {e}")
    finally:
        client.close()

if __name__ == "__main__":
    # Contoh hash (contoh: file aman EICAR atau hash lainnya)
    sample_hash = "275a021bbfb6489e54d471899f7db9d1663fc695ec2fe2a2c4538aabf651fd0f"
    check_file_hash(sample_hash)

Tabel Perbandingan Metode Integrasi VirusTotal API

Metode Integrasi Pustaka Resmi Kelebihan Kekurangan
Python SDK (vt-py) Ya (GitHub VirusTotal/vt-py) Struktur objek terkelola, penanganan error bawaan, pembaruan otomatis sesuai API v3. Membutuhkan pembelajaran sintaks pustaka khusus.
HTTP Requests (Requests) Tidak (Pustaka Pihak Ketiga) Kontrol penuh atas HTTP header, tanpa dependensi pustaka tambahan yang kompleks. Harus menangani parsing JSON dan manajemen status code secara manual.

Langkah-Langkah Menjalankan Proyek dari GitHub

Jika Anda ingin mengunduh dan menjalankan contoh proyek lanjutan langsung dari repositori resmi GitHub, ikuti prosedur teknis di bawah ini:

  1. Buka halaman repositori resmi di github.com/VirusTotal/vt-py.
  2. Salin tautan kloning atau unduh arsip ZIP dari repositori tersebut.
  3. Jalankan perintah git clone https://github.com/VirusTotal/vt-py.git melalui terminal Anda.
  4. Masuk ke direktori hasil kloning dan pasang dependensi pengembangan jika diperlukan untuk menjalankan unit test.
  5. Jejaki direktori examples/ di dalam repositori untuk melihat berbagai skrip siap pakai seperti pemindaian URL, pengunggahan file massal, dan pencarian lanjutan (hunting).

Tips Keamanan dan Troubleshooting Lapangan

Dalam implementasi produksi, pastikan Anda memperhatikan batas kuota (rate limit) akun gratis VirusTotal yang biasanya dibatasi hingga 4 permintaan per menit dan 500 permintaan per hari. Gunakan blok try-except untuk menangkap kode status HTTP 429 (Too Many Requests) dan terapkan jeda waktu (time.sleep) di dalam skrip perulangan Anda untuk menghindari pemblokiran sementara pada kunci API Anda.

🔍 Orang Lain Juga Mencari Ini