🚀 Fitur Unggulan

• ⚡ Super Ringan & Cepat: Dibuat menggunakan library andalan.
• 📦 Support Dual Module: Bisa pakai import (ESM) atau require (CommonJS).
• 💡 Developer Friendly: Sintaks yang sederhana dan mudah dipahami.
• 🌐 Beragam Layanan: Mulai dari Instagram, Threads, Twitter (X), Pinterest, hingga Apple Music & AI dan lain lain.

📦 Instalasi

# Menggunakan NPM
npm install @zenaveline/scraper

# Atau menggunakan Yarn
yarn add @zenaveline/scraper

📖 Quick Start

Cara panggilnya sangat praktis! Kamu bebas menamai import-nya sesuai selera (contoh: scraper atau nama lain).

🌟 ESM (ECMAScript Modules)

Untuk project berformat module (atau menggunakan TypeScript):

import scraper from '@zenaveline/scraper'

const data = await scraper.igdl('https://www.instagram.com/p/url-postingan')
console.log(data) // output

💻 CommonJS (CJS)

Untuk project standar Node.js (seperti bot WhatsApp pada umumnya):

const scraper = require("@zenaveline/scraper")

scraper.bypasstools("url")
    .then(console.log)
    .catch(console.error)

🎶 Khusus Penggunaan Spotify API

const scraper = require('@zenaveline/scraper')

const spotify = new scraper.spotify()

// Contoh pencarian lagu
const searchResult = await spotify.search('a thousand years jvke')
console.log(searchResult)

// Contoh Mengambil data spesifik berdasarkan ID
const trackData = await spotify.track('23WxsmliKISYaCfam8iPPG')
const artistData = await spotify.artist('164Uj4eKjl6zTBKfJLFKKK')
const albumData = await spotify.album('7z2Nuz41dkU9ruY5Qkva2L')
const playlistData = await spotify.playlist('4IfUIdWEonPys9mYs7zXna')

📺 Khusus Penggunaan Savetube (YouTube)

Karena savetube berbentuk sebuah class, kamu wajib melakukan inisialisasi menggunakan kata kunci new sebelum memakainya (jika tidak, akan error cannot be invoked without new).

const scraper = require('@zenaveline/scraper')

// 1. Inisialisasi class savetube terlebih dahulu
const yt = new scraper.savetube()

// 2. Gunakan fungsi download di dalamnya
// Pilihan format video: '144', '240', '360', '480', '720', '1080'
// Pilihan format audio: 'mp3'

// Contoh Download Audio (MP3)
const resultAudio = await yt.download('https://youtu.be/T-url-video', 'mp3')
console.log(resultAudio)

// Contoh Download Video (Resolusi 720p)
const resultVideo = await yt.download('https://youtu.be/T-url-video', '720')
console.log(resultVideo)

/*
  Contoh Output balikan (Response):
  {
    status: true,
    title: 'Judul Video YouTube',
    format: '720', // atau mp3
    thumb: 'https://i.ytimg.com/vi/...', // Gambar Thumbnail
    duration: 120, 
    cached: false,
    dl: 'https://media.savetube.vip/...' // URL langsung ke file download
  }
  
  Catatan: Jika ada error, output yang dikembalikan:
  { status: false, msg: "pesan error" } atau { status: false, error: "detail error" }
*/

🛠️ Daftar Scraper & Tools Terlengkap

Panggil nama fungsinya sesuai daftar di bawah ini untuk menikmati semua fiturnya.

📥 Downloader Sosial Media

| Fungsi | Deskripsi Singkat | | :--- | :--- | | igdl(url) | Unduh video Reels, foto, maupun Carousel dari Instagram. | | igstalk(username) | Stalk detail profil seseorang di Instagram. | | threadsdownload(url) | Ambil media foto/video dari postingan Threads secara instan. | | twetterdownload(url) | Unduh postingan video/gambar dari platform X (Twitter). | | pinterestdownload(url)| Ekstrak media gambar dan video dengan kualitas jernih dari Pinterest. | | douyindl(url) | Download video Douyin tanpa watermark. | | allinonedownloader(url, tool) | Downloader all-in-one yang mendukung banyak platform (Tiktok, YouTube, IG, dll). | | tiktokdownload(url) | Download video/foto Tiktok tanpa watermark. | | savetube | Class API YouTube Downloader. Mendukung berbagai resolusi video ('144', '240', '360', '480', '720', '1080') dan audio ('mp3'). Gunakan dengan new scraper.savetube(). | | mediafiredl(url) | Unduh file atau folder secara langsung dari Mediafire. |

🎵 Musik & Audio

| Fungsi | Deskripsi Singkat | | :--- | :--- | | applemusicdl(url) | Unduh audio lagu favoritmu langsung dari Apple Music (hingga 320kbps). | | geniussearch(query) | Temukan lagu dan metadata sang artis lewat API Genius. | | geniusdetail(id) | Dapatkan detail lagu beserta lirik utuhnya via Genius ID. | | spotify | Class API untuk fitur Spotify (search, track, artist, album, playlist). Gunakan dengan new scraper.spotify(). | | spotifydl(url) | Unduh track dari Spotify (mendukung URL Track). | | spotifycard(options) | Buat gambar kartu keren lagu Spotify menggunakan metadata musik. |

🤖 AI & Image Tools

| Fungsi | Deskripsi Singkat | | :--- | :--- | | novaai(text) | Chatbot interaktif menggunakan Nova AI untuk menjawab pertanyaan apa saja. | | sharpify(img, model) | Tools manipulasi gambar keren: enhance, upscale (Bikin HD), atau removebg. | | pixaremovebg(img) | Algoritma canggih dari Pixacut API untuk menghapus background dengan hasil super rapi. | | nanobanana(buffer, prompt) | Edit gambar dengan instruksi teks (prompt) menggunakan AI Live3D. |

🎨 Canvas & Image Generator

| Fungsi | Deskripsi Singkat | | :--- | :--- | | brat(text, theme, blur) | Buat gambar bertema "Brat" (seperti album Charli XCX) dengan teks kustom. | | iqcdarkmode(text, time, imgUrl) | Generate gambar quote chat ala iPhone (Dark Mode) lengkap dengan profil & reaksi emoji. | | iqcpinkmode(text, time) | Generate gambar quote chat ala iPhone (Pink Mode) dengan estetika UI yang imut. | | tiktokdmqc(username, text, avatar) | Buat gambar screenshot Quote DM/Chat dari TikTok yang sangat realistis. | | fakeovo(amount) | Generate screenshot saldo e-wallet OVO palsu (Fake OVO) sesuai dengan jumlah yang diinputkan. |

ℹ️ Utility

| Fungsi | Deskripsi Singkat | | :--- | :--- | | bypasstools(url) | Bypass shortlink URL (support sf.gl, sub2unlock, tinyurl, linkvertise, dll). | | docs() | Gunakan fungsi ini untuk melihat list lengkap seluruh fungsi scraper yang didukung secara terprogram. |

Catatan Penting:
Untuk fungsi berbasis gambar lokal (seperti sharpify dan pixaremovebg), argumen img diisi dengan path / letak lokasi file gambarmu (contoh: './gambar.jpg').