@yanamiku/wallpapers-search/README.md

Scraper untuk mengambil gambar dari wallpapers.com

---

# **Wallpapers Scraper 🖼️**
Wallpapers Scraper adalah modul **Node.js** untuk mengekstrak **URL gambar** dari [Wallpapers.com](https://wallpapers.com) berdasarkan kata kunci pencarian.

✅ **Fitur Utama:**
- 📥 **Scrape gambar dari Wallpapers.com** berdasarkan kata kunci.
- 🔄 **Mengecek halaman berikutnya secara otomatis** jika jumlah gambar kurang dari yang diminta.
- 📌 **Dapat mengambil semua gambar yang tersedia** jika jumlah tidak ditentukan.

---

## **📦 Instalasi**
```sh
npm install @yanamiku/wallpapers-search
```

---

## **🚀 Cara Penggunaan**
### **1. Import Modul**
```javascript
const { searchWallpapers } = require("@yanamiku/wallpapers-search")
```

### **2. Mengambil 10 Gambar**
```javascript
async function run() {
    try {
        const result = await searchWallpapers("naruto", 10)
        console.log(result)
    } catch (error) {
        console.error(error.message)
    }
}

run()
```
📝 **Output Contoh (JSON)**
```json
{
  "status": true,
  "query": "naruto",
  "totalImage": 10,
  "imageUrl": [
    "https://wallpapers.com/naruto1.jpg",
    "https://wallpapers.com/naruto2.jpg",
    "https://wallpapers.com/naruto3.jpg",
    "... (hingga 10 gambar)"
  ]
}
```

---

### **3. Mengambil Semua Gambar yang Tersedia**
```javascript
async function run() {
    try {
        const result = await searchWallpapers("naruto")
        console.log(result)
    } catch (error) {
        console.error(error.message)
    }
}

run()
```
📝 **Output Contoh (JSON)** _(akan mengambil semua gambar hingga tidak ada lagi)_
```json
{
  "status": true,
  "query": "naruto",
  "totalImage": 75,
  "imageUrl": [
    "https://wallpapers.com/naruto1.jpg",
    "https://wallpapers.com/naruto2.jpg",
    "... (hingga semua gambar tersedia)"
  ]
}
```

---

## **📖 Parameter**
| Parameter | Tipe Data | Deskripsi |
|-----------|----------|-----------|
| `query` | `string` | Kata kunci pencarian (misal: `"naruto"`) |
| `amount` *(opsional)* | `number` | Jumlah gambar yang ingin diambil (jika tidak ditentukan, akan mengambil semua yang tersedia) |

---

## **🔧 Error Handling**
Jika kata kunci tidak ditemukan, maka akan mengembalikan error:
```json
{
  "status": false,
  "error": "Tidak ada hasil ditemukan untuk kata kunci: 'xyz'."
}
```

---

## **📜 Lisensi**
Proyek ini menggunakan lisensi **MIT**.

---

## 📢 **Creator**
- Contact : [ WhatsApp ](https://wa.me/6285793589243)
- Information : [ WhatsApp Channel ](https://whatsapp.com/channel/0029VadqQOWKrWQvpQZC5Y3k)