Source Code • Node.js + Playwright
Kumpulkan Putusan Mahkamah Agung hingga Ribuan Berkas — Tanpa Membuka Satu per Satu
Source code aplikasi pengunduh putusan dari direktori resmi Mahkamah Agung. Tersedia antarmuka web untuk memantau progres secara langsung dan mode CLI untuk dijalankan di VPS, cron, atau systemd. Anda membeli kode sumbernya dan menjalankannya di komputer atau server sendiri.
Yang Anda terima: kode sumber lengkap aplikasi Node.js — backend Express, otomasi browser Playwright, parser halaman direktori, manajer antrean multi-tahun, UI web, skrip CLI, dokumentasi instalasi, konfigurasi contoh, serta lisensi MIT sesuai metadata proyek.
Mengunduh Putusan Secara Manual Cepat Menjadi Pekerjaan yang Melelahkan
Satu putusan butuh beberapa klik: buka halaman daftar, cari putusan, masuk ke halaman detail, tunggu tautan PDF muncul, unduh, lalu simpan dengan nama berkas yang rapi. Kalikan dengan ratusan atau ribuan berkas, dan pekerjaan riset Anda berubah menjadi aktivitas klik yang tidak produktif.
Pagination dibatasi 499 halaman
Satu URL daftar hanya menampilkan sekitar 9.980 putusan. Tanpa strategi pemecahan, sebagian data tidak akan pernah terjangkau.
Proses terputus, harus mulai dari nol
Koneksi putus atau server restart di tengah proses membuat Anda kehilangan jejak berkas mana yang sudah selesai.
Berkas korup dan tidak terlacak
Server kadang mengembalikan halaman HTML alih-alih PDF, dan tanpa pencatatan metadata, ribuan berkas sulit ditelusuri kembali.
Halaman verifikasi menghalangi skrip
Permintaan otomatis biasa sering ditolak, sehingga dibutuhkan sesi browser nyata dengan cookie yang tetap terjaga.
Apa Saja yang Bisa Anda Lakukan dengan Source Code Ini
Setiap kemampuan di bawah ini merupakan fitur yang benar-benar tersedia di dalam kode, bukan rencana pengembangan.
Unduh Sesuai Target, Bukan Sesuai Perkiraan
Tentukan tahun, jumlah putusan, dan halaman awal. Aplikasi membaca jumlah putusan tahun tersebut langsung dari situs, berhenti otomatis saat target tercapai, dan menghitung kuota dari berkas yang benar-benar berhasil tersimpan — kegagalan tidak mengurangi kuota Anda.
Mode “Unduh Semua” dengan Partisi Bertingkat
Untuk satu tahun penuh, aplikasi memecah pencarian menjadi delapan kategori utama, lalu turun ke sub-kategori, lalu ke tingkat pengadilan bila masih menyentuh batas pagination. ID putusan yang sudah diproses dideduplikasi agar tidak ada unduhan ganda antar partisi.
Antrean Multi-Tahun: Start, Pause, Resume, Stop
Centang beberapa tahun sekaligus, lalu biarkan antrean diproses berurutan. Setiap tahun memiliki status sendiri (pending, running, paused, done, error). Ketika server hidup kembali, antrean yang terputus dapat dilanjutkan otomatis sesuai pengaturan bawaan.
Resume Sampai Level Partisi
Status disimpan per putusan dan per partisi. Berkas yang sudah ada dan valid akan dilewati, dan partisi yang sudah tuntas tidak dijalankan ulang setelah pause atau restart. Ada juga fungsi Clear Data untuk memulai benar-benar dari nol, dengan opsi menghapus berkas PDF lama.
Validasi Berkas Sebelum Disimpan
Setiap unduhan diperiksa tanda tangan %PDF--nya. Respons HTML dari server tidak akan disimpan sebagai PDF, penulisan dilakukan ke berkas sementara lalu diubah namanya, dan berkas tidak valid akan dihapus untuk diunduh ulang. Tersedia juga batas ukuran berkas per unduhan.
Metadata Siap Diolah
Setiap pekerjaan menghasilkan berkas CSV dan JSONL berisi status, nomor putusan, judul, pengadilan, kategori, tanggal putus, nama berkas, ukuran, URL PDF, pesan error, dan waktu proses. Cocok untuk diolah lanjut di spreadsheet, basis data, atau pipeline analisis.
Pemantauan Progres Real-Time
Panel progres menampilkan jumlah berhasil, dilewati, gagal, halaman aktif, partisi yang sedang dikerjakan, kecepatan per menit, estimasi waktu selesai, total ukuran, serta log aktivitas. Riwayat pekerjaan terakhir juga tersimpan di antarmuka.
Sesi Browser yang Menjaga Cookie
Aplikasi memakai profil browser persisten, plugin stealth, dan user agent yang diselaraskan dengan versi Chrome untuk menghadapi halaman verifikasi. Unduhan dilakukan dari dalam konteks halaman agar cookie dan referer tetap valid, dengan percobaan ulang berlapis serta opsi menjalankan browser secara tampak untuk verifikasi manual.
CLI, REST API, dan Fleksibilitas Konfigurasi
Selain UI web, tersedia mode CLI untuk kebutuhan otomasi terjadwal dan API untuk memicu pekerjaan dari aplikasi lain. Port, folder unduhan, jeda antar item, timeout, jumlah percobaan ulang, dan batas partisi dapat diatur melalui variabel lingkungan.
Alur Kerja: Dari Instalasi sampai Berkas Siap Pakai
- Pasang dependensi. Jalankan
npm installpada folder proyek. Proses ini juga menyiapkan browser Chromium untuk Playwright. - Salin konfigurasi. Duplikat berkas contoh konfigurasi menjadi berkas lingkungan, lalu sesuaikan port, folder hasil, atau jeda antar permintaan bila diperlukan.
- Jalankan aplikasi. Gunakan
npm startuntuk membuka antarmuka web, atau panggil skrip CLI untuk kebutuhan otomasi. - Pilih cakupan. Tentukan tahun dan jumlah, atau pilih beberapa tahun untuk antrean. Filter kategori dan pengadilan tersedia bila Anda ingin mempersempit cakupan.
- Pantau dan ambil hasil. Berkas PDF tersimpan per tahun di folder unduhan, ditemani metadata CSV dan JSONL dari setiap pekerjaan.
Cocok untuk Pekerjaan yang Menuntut Arsip Putusan
Riset hukum dan akademik
Membangun korpus putusan untuk analisis putusan, studi konsistensi, atau penelitian hukum empiris.
Kantor hukum dan konsultan
Mengarsipkan putusan pada kategori atau pengadilan tertentu sebagai bahan referensi internal.
Tim data dan legal tech
Menyiapkan data awal berformat PDF plus metadata terstruktur sebelum masuk ke tahap ekstraksi teks atau pencarian.
Pengembang yang ingin produk siap kustom
Menjadikan basis kode ini titik awal untuk alat monitoring, arsip internal, atau integrasi ke sistem yang lebih besar.
Kebutuhan Teknis dan Isi Paket
Yang perlu disiapkan
- Node.js versi 18.17 atau lebih baru (disarankan 20/22).
- Google Chrome atau Chromium yang disiapkan melalui Playwright.
- Koneksi internet yang stabil dan ruang disk sesuai cakupan unduhan.
- VPS Linux bersifat opsional bila ingin berjalan terus-menerus.
Yang ada di dalam paket
- Kode backend, parser halaman, manajer pekerjaan, dan manajer antrean.
- Antarmuka web beserta aset tampilannya.
- Skrip CLI dan berkas konfigurasi contoh.
- Dokumentasi instalasi, konfigurasi, daftar API, dan panduan deployment.
Yang tidak Anda perlukan
- Tidak memerlukan server basis data: status disimpan sebagai berkas JSON dan JSONL.
- Tidak memerlukan akun pihak ketiga atau kunci API layanan berbayar.
- Tidak bergantung pada framework frontend tertentu, sehingga mudah disesuaikan.
Batasan yang Perlu Anda Ketahui Sebelum Membeli
Kami memilih menjelaskan batasan sejak awal agar ekspektasi Anda sesuai dengan kemampuan aplikasi.
- Situs target membatasi pagination maksimal 499 halaman per kombinasi tahun dan filter. Mode Unduh Semua menangani batas ini melalui partisi bertingkat, namun partisi yang tidak dapat dipecah lagi akan dilaporkan di log karena berpotensi belum sepenuhnya tercakup.
- Tidak semua putusan menyediakan lampiran PDF atau berstatus terbit. Item seperti ini dicatat sebagai tidak memiliki PDF atau berkas tidak valid, dan tidak dihitung sebagai kuota.
- Kecepatan pemrosesan bergantung pada jaringan, jeda antar item, dan respons server target. Dokumentasi proyek mencantumkan kisaran sekitar 10–20 putusan per menit pada kondisi normal.
- Mengunduh satu tahun penuh dapat memakan waktu berhari-hari dan ruang disk puluhan gigabyte. Gunakan filter kategori atau pengadilan untuk cakupan yang lebih kecil.
- Situs target memakai perlindungan Cloudflare. Aplikasi sudah dilengkapi sesi persisten dan strategi penanganan verifikasi, tetapi jika verifikasi manual diperlukan, tersedia mode browser tampak untuk menyelesaikannya satu kali.
- Struktur halaman situs target dapat berubah sewaktu-waktu. Bagian parser disediakan terbuka sehingga penyesuaian dapat dilakukan pada kode sumber.
- Ini adalah produk source code, bukan layanan berlangganan. Anda bertanggung jawab menyiapkan lingkungan, menjalankan aplikasi, dan mematuhi ketentuan situs serta peraturan yang berlaku.
Pertanyaan yang Sering Diajukan
Apakah saya membeli layanan atau kode sumber?
Anda membeli kode sumber aplikasi. Tidak ada server milik penjual yang disewa, tidak ada langganan bulanan, dan tidak ada batas jumlah unduhan dari pihak kami. Aplikasi berjalan di komputer atau server Anda sendiri.
Apakah bisa dijalankan di VPS?
Bisa. Dokumentasi menyertakan panduan pemasangan dependensi di Linux serta contoh konfigurasi layanan systemd agar aplikasi berjalan terus-menerus. Untuk VPS tanpa Google Chrome, browser Chromium dari Playwright dapat digunakan.
Apakah harus bisa coding untuk memakainya?
Untuk menjalankan aplikasi, Anda cukup mengikuti langkah instalasi dan menjalankannya lewat antarmuka web. Kemampuan Node.js dan JavaScript baru diperlukan ketika Anda ingin mengubah perilaku, menambah filter, atau mengintegrasikannya dengan sistem lain.
Apakah hasil unduhan bisa diolah lebih lanjut?
Ya. Selain berkas PDF yang tersimpan per tahun, setiap pekerjaan menghasilkan metadata CSV dan JSONL dengan informasi putusan, status unduhan, dan letak berkas. Format ini mudah dibuka di spreadsheet atau diproses oleh skrip lain.
Bagaimana jika proses berhenti di tengah jalan?
Anda dapat memakai Pause lalu Resume pada antrean multi-tahun, atau menjalankan ulang dengan status yang tersimpan. Berkas yang sudah valid akan dilewati dan partisi yang sudah selesai tidak diproses ulang. Tersedia pula fungsi Clear Data jika ingin mengulang dari awal.
Apakah aplikasi ini produk resmi Mahkamah Agung?
Bukan. Aplikasi ini merupakan proyek independen yang mengambil data dari direktori putusan publik, dan tidak berafiliasi dengan Mahkamah Agung Republik Indonesia. Gunakan secara wajar, hormati ketentuan layanan situs, dan patuhi peraturan yang berlaku atas data yang Anda kelola.
Mulai Bangun Arsip Putusan Anda Sendiri
Berhenti menghabiskan waktu untuk mengunduh satu per satu. Dapatkan kode sumber lengkap, jalankan di lingkungan Anda, dan sesuaikan sendiri sesuai kebutuhan riset atau produk Anda.
Tambahkan source code ini ke pesanan Anda melalui tombol pembelian di halaman produk.
Catatan: proyek ini independen dan tidak berafiliasi dengan Mahkamah Agung Republik Indonesia maupun situs direktori putusannya. Seluruh data yang diunduh berasal dari halaman publik situs tersebut. Gambaran kecepatan, batasan pagination, dan perilaku situs mengacu pada dokumentasi proyek serta implementasi yang disertakan, dan dapat berubah mengikuti kondisi situs target.