# 📸 instagram.js

> Scraper dan Downloader Instagram berbasis Node.js yang cepat, ringan, dan langsung mengakses internal API Instagram tanpa perlu browser otomatisasi (headless browser).

[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

---

## ✨ Fitur Utama

- 🚀 **Tanpa Headless Browser**: Langsung mengikis HTML & data stream Instagram tanpa Puppeteer/Playwright.
- 🖼️ **Dukungan Media Lengkap**: Mendukung foto, video, postingan carousel (multi-slide), dan Reels.
- 📊 **Ekstraksi Metadata Detail**: Mendapatkan informasi lengkap seperti caption, statistik (*likes*, *comments*, *views*), info pembuat konten (*owner*), dan lokasi.
- 🔁 **Auto-Retry & Resilience**: Menggunakan sistem *retry* otomatis untuk menangani pembatasan *rate-limit* atau galat koneksi sementara.
- 🛠️ **Fleksibel**: Dapat dijalankan langsung via CLI atau diimpor sebagai modul Node.js dalam proyek lain.

---

## ⚙️ Persyaratan Sistem

- **Node.js**: `v18.0.0` atau yang lebih baru
- **npm**: Bawaan dari Node.js

---

## 📦 Instalasi

**Install Dependensi**:
   ```bash
   npm install axios axios-cookiejar-support tough-cookie axios-retry

   ```

---

## 🚀 Cara Penggunaan (CLI)

### 1. Mengambil Metadata Saja (Output JSON)
Menampilkan struktur data JSON langsung di layar terminal.
```bash
node instagram.js "https://www.instagram.com"
```

### 2. Mengunduh Media
Mengunduh gambar atau video langsung ke folder saat ini (nama file sesuai shortcode).
```bash
node instagram.js "https://www.instagram.com" -d
```

### 3. Mengunduh ke Folder / Nama Custom
Tentukan folder tujuan atau nama file khusus.
```bash
node instagram.js "https://www.instagram.com" -d ./hasil_download
```

### 4. Mode Verbose (Debugging Log)
Aktifkan `--verbose` atau `-v` untuk melihat proses *scraping* secara detail.
```bash
node instagram.js "https://www.instagram.com" -v
```

---

## Contoh output download video

![contoh download video](https://lockerku.bond/i/yg1uf2v9)


## Contoh output download foto/carousel
![contoh download foto](https://lockerku.bond/i/j5nbm2yc)

---

## ⚠️ Penolakan Tanggung Jawab (Disclaimer)

Proyek ini dibuat **hanya untuk tujuan edukasi dan penelitian**. Alat ini tidak dikembangkan atau didukung oleh Instagram/Meta. Pengguna bertanggung jawab penuh atas segala konsekuensi hukum atau pelanggaran Ketentuan Layanan (*Terms of Service*) pihak ketiga yang diakibatkan oleh penggunaan skrip ini.

---

## 👤 Pembuat

**Shann (Sanzzy111)**
- Profile: [@shanmolvyr](https://code.vyrgo.cyou/profile/shanmolvyr)
- Repository: [instagram.js](https://code.vyrgo.cyou/shanmolvyr/instagram)