@zenaveline/scraper 1.0.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +60 -61
  2. package/index.mjs +15 -0
  3. package/package.json +7 -2
package/README.md CHANGED
@@ -1,101 +1,100 @@
1
1
  <div align="center">
2
- <h1>✨ @zenaveline/scraper ✨</h1>
3
- <p><strong>Modul All-in-One Scraper Keren, Cepat, dan Mudah Digunakan!</strong></p>
2
+ <h1>✨ <code>@zenaveline/scraper</code> ✨</h1>
3
+ <p><strong>Modul All-in-One Scraper Keren, Cepat, dan Sangat Mudah Digunakan!</strong></p>
4
4
 
5
- [![npm version](https://badge.fury.io/js/@zenaveline%2Fscraper.svg)](https://badge.fury.io/js/@zenaveline%2Fscraper)
6
- [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
5
+ <p>
6
+ <a href="https://www.npmjs.com/package/@zenaveline/scraper"><img src="https://img.shields.io/npm/v/@zenaveline/scraper?style=for-the-badge&color=success" alt="NPM Version" /></a>
7
+ <a href="https://www.npmjs.com/package/@zenaveline/scraper"><img src="https://img.shields.io/npm/dt/@zenaveline/scraper?style=for-the-badge&color=blue" alt="NPM Downloads" /></a>
8
+ <a href="https://opensource.org/licenses/ISC"><img src="https://img.shields.io/badge/License-ISC-blue.svg?style=for-the-badge" alt="License: ISC" /></a>
9
+ </p>
7
10
 
8
11
  <p>
9
- Satu library untuk mendownload dan mengambil data dari berbagai platform sosial media, AI, dan musik! Mendukung format <b>CommonJS (CJS)</b> dan <b>ECMAScript Modules (ESM)</b>.
12
+ Kumpulan scraper andalan untuk bot WhatsApp, Telegram, maupun project Node.js kamu. Mendukung penuh format <b>CommonJS</b> dan <b>ESM</b>, dilengkapi berbagai fitur mulai dari Downloader Sosial Media hingga Tools AI!
10
13
  </p>
11
14
  </div>
12
15
 
13
- ---
16
+ <hr>
14
17
 
15
- ## 🚀 Instalasi
18
+ ## 🚀 Fitur Unggulan
19
+ - **⚡ Super Ringan & Cepat:** Dibuat menggunakan library andalan.
20
+ - **📦 Support Dual Module:** Bisa pakai `import` (ESM) atau `require` (CommonJS).
21
+ - **💡 Developer Friendly:** Sintaks yang sederhana dan to-the-point menggunakan Promise (Async/Await).
22
+ - **🌐 Beragam Layanan:** Mulai dari Instagram, Threads, Twitter (X), Pinterest, hingga Apple Music & AI dan lain lain.
16
23
 
17
- Kamu bisa menginstal modul ini melalui NPM atau Yarn:
24
+ ## 📦 Instalasi
18
25
 
19
26
  ```bash
20
27
  # Menggunakan NPM
21
28
  npm install @zenaveline/scraper
22
29
 
23
- # Menggunakan Yarn
30
+ # Atau menggunakan Yarn
24
31
  yarn add @zenaveline/scraper
25
32
  ```
26
33
 
27
- ---
34
+ ## 📖 Quick Start
28
35
 
29
- ## 📖 Penggunaan
30
-
31
- Berikut adalah contoh cara memanggil modul ini di dalam proyek kamu. Kami menyediakan 1 contoh untuk **ESM** dan 1 contoh untuk **CommonJS**.
36
+ Cara panggilnya sangat praktis! Gunakan _destructuring_ untuk mengimpor fungsi yang spesifik kamu butuhkan.
32
37
 
33
38
  ### 🌟 ESM (ECMAScript Modules)
34
- Jika kamu menggunakan `"type": "module"` di `package.json`, gunakan `import`:
39
+ Untuk project berformat module (atau menggunakan TypeScript):
35
40
 
36
41
  ```javascript
37
- import scraper from '@zenaveline/scraper';
38
-
39
- async function runTest() {
40
- try {
41
- // Contoh memanggil scraper Threads Downloader
42
- const data = await scraper.threadsdownload('https://threads.com/@username/post/ID');
43
- console.log(data);
44
- } catch (error) {
45
- console.error(error);
46
- }
47
- }
48
-
49
- runTest();
42
+ import { igdl } from '@zenaveline/scraper';
43
+
44
+ const data = await igdl('https://www.instagram.com/p/url-postingan');
45
+ console.log(data); // JSON
50
46
  ```
51
47
 
52
48
  ### 💻 CommonJS (CJS)
53
- Jika kamu menggunakan standar NodeJS bawaan (CommonJS), gunakan `require`:
49
+ Untuk project standar Node.js (seperti bot WhatsApp pada umumnya):
54
50
 
55
51
  ```javascript
56
- const scraper = require('@zenaveline/scraper');
57
-
58
- async function runTest() {
59
- try {
60
- // Contoh menggunakan scraper Instagram Stalk
61
- const data = await scraper.igstalk('prabowo');
62
- console.log(data);
63
- } catch (error) {
64
- console.error(error);
65
- }
66
- }
67
-
68
- runTest();
52
+ const { igdl } = require('@zenaveline/scraper');
53
+
54
+ const data = await igdl('https://www.instagram.com/p/url-postingan');
55
+ console.log(data); // JSON
69
56
  ```
70
57
 
71
58
  ---
72
59
 
73
- ## 🛠️ Daftar Scraper Tersedia
60
+ ## 🛠️ Daftar Scraper & Tools Terlengkap
74
61
 
75
- Berikut adalah seluruh scraper / fungsi yang sudah terdaftar di modul ini:
62
+ Panggil nama fungsinya sesuai daftar di bawah ini untuk menikmati semua fiturnya.
76
63
 
77
- | Nama Fungsi | Deskripsi |
64
+ ### 📥 Downloader Sosial Media
65
+ | Fungsi | Deskripsi Singkat |
78
66
  | :--- | :--- |
79
- | `twetterdownload(url)` | Unduh video/gambar dari Twitter (X) menggunakan URL. |
80
- | `pinterestdownload(url)` | Ambil detail dan media post dari Pinterest. |
81
- | `igstalk(username)` | Ambil data lengkap profil Instagram seseorang menggunakan username. |
82
- | `igdl(url)` | Unduh Reels atau Post dari Instagram. |
83
- | `threadsdownload(url)` | Unduh media foto/video dari postingan Threads. |
84
- | `geniussearch(query)` | Cari lagu beserta metadata penyanyi di Genius. |
85
- | `geniusdetail(id)` | Dapatkan detail lagu dan lirik lagu dari ID Genius. |
86
- | `applemusicdl(url)` | Unduh audio dengan kualitas 320kbps dari Apple Music. |
87
- | `novaai(text)` | AI Chatbot interaktif menggunakan Nova AI. |
88
- | `sharpify(img, model)` | Tingkatkan/Upscale kualitas gambar atau hapus background gambar. (`model`: `enhance`, `upscale`, `removebg`) |
89
- | `pixaremovebg(img)` | Menghapus background gambar dengan hasil rapi (Pixacut API). |
90
- | `docs()` | Fungsi bawaan untuk mengembalikan array dari seluruh scraper yang ada. |
67
+ | `igdl(url)` | Unduh video Reels, foto, maupun Carousel dari Instagram. |
68
+ | `igstalk(username)` | Stalk detail profil seseorang di Instagram. |
69
+ | `threadsdownload(url)` | Ambil media foto/video dari postingan Threads secara instan. |
70
+ | `twetterdownload(url)` | Unduh postingan video/gambar dari platform X (Twitter). |
71
+ | `pinterestdownload(url)`| Ekstrak media gambar dan video dengan kualitas jernih dari Pinterest. |
72
+
73
+ ### 🎵 Musik & Audio
74
+ | Fungsi | Deskripsi Singkat |
75
+ | :--- | :--- |
76
+ | `applemusicdl(url)` | Unduh audio lagu favoritmu langsung dari Apple Music (hingga 320kbps). |
77
+ | `geniussearch(query)` | Temukan lagu dan metadata sang artis lewat API Genius. |
78
+ | `geniusdetail(id)` | Dapatkan detail lagu beserta lirik utuhnya via Genius ID. |
91
79
 
92
- ---
80
+ ### 🤖 AI & Image Tools
81
+ | Fungsi | Deskripsi Singkat |
82
+ | :--- | :--- |
83
+ | `novaai(text)` | Chatbot interaktif menggunakan Nova AI untuk menjawab pertanyaan apa saja. |
84
+ | `sharpify(img, model)` | Tools manipulasi gambar keren: `enhance`, `upscale` (Bikin HD), atau `removebg`. |
85
+ | `pixaremovebg(img)` | Algoritma canggih dari Pixacut API untuk menghapus background dengan hasil super rapi. |
93
86
 
94
- ## 💡 Notes
87
+ ### ℹ️ Utility
88
+ | Fungsi | Deskripsi Singkat |
89
+ | :--- | :--- |
90
+ | `docs()` | Gunakan fungsi ini untuk melihat *list* lengkap seluruh fungsi scraper yang didukung secara terprogram. |
91
+
92
+ > **Catatan Penting:**
93
+ > Untuk fungsi berbasis gambar lokal (seperti `sharpify` dan `pixaremovebg`), *argumen* `img` diisi dengan _path_ / letak lokasi *file* gambarmu (contoh: `'./gambar.jpg'`).
95
94
 
96
- - Semua fungsi berbasis **Promise** (Async/Await).
97
- - Pada scraper yang meminta input *local file path* seperti `sharpify` dan `pixaremovebg`, parameter yang dikirimkan adalah alamat file gambar di komputermu (contoh: `'./input.jpg'`).
95
+ ---
98
96
 
99
97
  <div align="center">
100
- <p>Dibuat dengan ❤️ oleh ZenzzXD</p>
98
+ <p>Dikembangkan dengan ❤️ oleh <b>ZenzzXD</b></p>
99
+ <p>Jangan lupa follow channel ZenzXD untuk informasi selanjutnya!</p>
101
100
  </div>
package/index.mjs CHANGED
@@ -1 +1,16 @@
1
1
  import scraper from './index.js';
2
+
3
+ export const applemusicdl = scraper.applemusicdl;
4
+ export const geniusdetail = scraper.geniusdetail;
5
+ export const geniussearch = scraper.geniussearch;
6
+ export const igdl = scraper.igdl;
7
+ export const igstalk = scraper.igstalk;
8
+ export const novaai = scraper.novaai;
9
+ export const pinterestdownload = scraper.pinterestdownload;
10
+ export const pixaremovebg = scraper.pixaremovebg;
11
+ export const sharpify = scraper.sharpify;
12
+ export const threadsdownload = scraper.threadsdownload;
13
+ export const twetterdownload = scraper.twetterdownload;
14
+ export const docs = scraper.docs;
15
+
16
+ export default scraper;
package/package.json CHANGED
@@ -1,7 +1,12 @@
1
1
  {
2
2
  "name": "@zenaveline/scraper",
3
- "version": "1.0.0",
4
- "description": "Kumpulan scraper",
3
+ "version": "1.1.1",
4
+ "description": "Kumpulan scraper yang mudah digunakan!",
5
+ "keywords": [
6
+ "@zenaveline/scraper",
7
+ "scraper",
8
+ "scraping"
9
+ ],
5
10
  "main": "index.js",
6
11
  "type": "commonjs",
7
12
  "exports": {