@soyaxell09/zenbot-scraper 1.0.5 → 1.0.7

package/README.md

@@ -1,11 +1,11 @@
-# @axeldev09/zenbot-scraper
+# @soyaxell09/zenbot-scraper
 
 Módulo npm de scrapers y herramientas para bots de WhatsApp. Incluye descargadores, buscadores y utilidades.
 
 ## Instalación
 
 ```bash
-npm install @axeldev09/zenbot-scraper
+npm install @soyaxell09/zenbot-scraper
 ```
 
 ---
@@ -26,7 +26,7 @@ src/
 ### YouTube
 
 ```js
-import { ytSearch, ytDownload, ytInfo } from '@axeldev09/zenbot-scraper'
+import { ytSearch, ytDownload, ytInfo } from '@soyaxell09/zenbot-scraper'
 
 // Buscar videos
 const results = await ytSearch('bad bunny', 5)
@@ -41,7 +41,26 @@ const audio = await ytDownload('nicki nicole wapo traketero', 'mp3')
 ### YouTube v2 (via ytdown.to — más calidades)
 
 ```js
-import { ytDownloadV2, ytInfoV2, getFileSizeV2 } from '@axeldev09/zenbot-scraper'
+import { ytDownloadV2, ytInfoV2, getFileSizeV2 } from '@soyaxell09/zenbot-scraper'
+
+// Ver calidades disponibles
+const info = await ytInfoV2('https://youtu.be/dQw4w9WgXcQ')
+// → { title, uploader, views, thumb, qualities: [{ id, type, quality, size, sizeB, duration }] }
+
+// Descargar con calidad específica
+const video = await ytDownloadV2('https://youtu.be/dQw4w9WgXcQ', 'video', '1080p')
+const audio = await ytDownloadV2('https://youtu.be/dQw4w9WgXcQ', 'mp3', '128k')
+// → { title, uploader, views, thumb, type, quality, size, sizeB, duration, url }
+
+// Obtener tamaño de un archivo por URL
+const size = await getFileSizeV2('https://example.com/file.mp4')
+// → '14.5 MB'
+```
+
+### YouTube v2 (via ytdown.to — más calidades)
+
+```js
+import { ytDownloadV2, ytInfoV2, getFileSizeV2 } from '@soyaxell09/zenbot-scraper'
 
 // Ver calidades disponibles
 const info = await ytInfoV2('https://youtu.be/dQw4w9WgXcQ')
@@ -60,7 +79,7 @@ const size = await getFileSizeV2('https://example.com/file.mp4')
 ### TikTok
 
 ```js
-import { tiktokDownload, tiktokInfo } from '@axeldev09/zenbot-scraper'
+import { tiktokDownload, tiktokInfo } from '@soyaxell09/zenbot-scraper'
 
 const result = await tiktokDownload('https://www.tiktok.com/@user/video/123')
 // → { nowatermark, watermark, audio, music: { title, author, url }, stats: { plays, likes, comments, shares } }
@@ -69,7 +88,7 @@ const result = await tiktokDownload('https://www.tiktok.com/@user/video/123')
 ### Facebook
 
 ```js
-import { fbDownload } from '@axeldev09/zenbot-scraper'
+import { fbDownload } from '@soyaxell09/zenbot-scraper'
 
 const result = await fbDownload('https://www.facebook.com/watch?v=123')
 // → { hd, sd, thumb, title }
@@ -78,7 +97,7 @@ const result = await fbDownload('https://www.facebook.com/watch?v=123')
 ### Twitter / X
 
 ```js
-import { tweetInfo, tweetDownload } from '@axeldev09/zenbot-scraper'
+import { tweetInfo, tweetDownload } from '@soyaxell09/zenbot-scraper'
 
 // Info completa del tweet
 const info = await tweetInfo('https://x.com/user/status/123')
@@ -89,10 +108,24 @@ const media = await tweetDownload('https://x.com/user/status/123')
 // → { id, text, author, videos: [{ type, url, thumbnail, variants }], photos: [{ type, url, width, height }] }
 ```
 
+### Twitter / X
+
+```js
+import { tweetInfo, tweetDownload } from '@soyaxell09/zenbot-scraper'
+
+// Info completa del tweet
+const info = await tweetInfo('https://x.com/user/status/123')
+// → { id, text, createdAt, likes, replies, author: { name, username, avatar }, hashtags, medias }
+
+// Solo media descargable
+const media = await tweetDownload('https://x.com/user/status/123')
+// → { id, text, author, videos: [{ type, url, thumbnail }], photos: [{ type, url }] }
+```
+
 ### MediaFire
 
 ```js
-import { mediafireInfo } from '@axeldev09/zenbot-scraper'
+import { mediafireInfo } from '@soyaxell09/zenbot-scraper'
 
 const result = await mediafireInfo('https://www.mediafire.com/file/abc123/archivo.apk/file')
 // → { key, name, size, download, url }
@@ -101,7 +134,7 @@ const result = await mediafireInfo('https://www.mediafire.com/file/abc123/archiv
 ### GitHub
 
 ```js
-import { githubInfo, githubRelease, githubContents, githubSearch } from '@axeldev09/zenbot-scraper'
+import { githubInfo, githubRelease, githubContents, githubSearch } from '@soyaxell09/zenbot-scraper'
 
 // Info del repositorio
 const info = await githubInfo('facebook/react')
@@ -123,7 +156,7 @@ const repos = await githubSearch('whatsapp bot', 'repositories', 5)
 ### APK (APKPure)
 
 ```js
-import { apkSearch, apkInfo } from '@axeldev09/zenbot-scraper'
+import { apkSearch, apkInfo } from '@soyaxell09/zenbot-scraper'
 
 // Buscar por nombre
 const results = await apkSearch('whatsapp', 3)
@@ -134,6 +167,21 @@ const info = await apkInfo('com.whatsapp')
 // → { name, developer, pkg, date, icon, download, dlLinks, url }
 ```
 
+### APK (APKPure)
+
+```js
+import { apkSearch, apkInfo } from '@soyaxell09/zenbot-scraper'
+
+// Buscar por nombre
+const results = await apkSearch('whatsapp', 3)
+// → [{ name, developer, pkg, date, icon, appUrl, dlUrl }]
+
+// Info por package name
+const info = await apkInfo('com.whatsapp')
+// → { name, developer, pkg, date, icon, download, dlLinks, url }
+```
+
+
 ---
 
 ## 🔍 Search
@@ -141,7 +189,7 @@ const info = await apkInfo('com.whatsapp')
 ### Google (DuckDuckGo)
 
 ```js
-import { googleSearch } from '@axeldev09/zenbot-scraper'
+import { googleSearch } from '@soyaxell09/zenbot-scraper'
 
 const results = await googleSearch('node.js tutorial', 5)
 // → [{ title, url, snippet }]
@@ -150,7 +198,7 @@ const results = await googleSearch('node.js tutorial', 5)
 ### Spotify / Deezer
 
 ```js
-import { spotify } from '@axeldev09/zenbot-scraper'
+import { spotify } from '@soyaxell09/zenbot-scraper'
 
 // Buscar tracks
 const tracks = await spotify('bad bunny', 'tracks', 5)
@@ -163,7 +211,7 @@ const albums = await spotify('bad bunny', 'albums', 3)
 ### Tenor (GIFs)
 
 ```js
-import { giphy } from '@axeldev09/zenbot-scraper'
+import { giphy } from '@soyaxell09/zenbot-scraper'
 
 const gifs = await giphy('funny cat', 5)
 // → [{ id, title, url, gif, preview, mp4, width, height }]
@@ -172,7 +220,7 @@ const gifs = await giphy('funny cat', 5)
 ### Pinterest
 
 ```js
-import { pinsearch, pinimg, pinvid } from '@axeldev09/zenbot-scraper'
+import { pinsearch, pinimg, pinvid } from '@soyaxell09/zenbot-scraper'
 
 // Buscar imágenes por texto
 const imgs = await pinsearch('anime wallpaper', 5)
@@ -193,10 +241,29 @@ const pinVid = await pinvid('https://www.pinterest.com/pin/123/')
 
 ## 🛠️ Tools
 
+### YouTube v2 (via ytdown.to — más calidades)
+
+```js
+import { ytDownloadV2, ytInfoV2, getFileSizeV2 } from '@soyaxell09/zenbot-scraper'
+
+// Ver calidades disponibles
+const info = await ytInfoV2('https://youtu.be/dQw4w9WgXcQ')
+// → { title, uploader, views, thumb, qualities: [{ id, type, quality, size, sizeB, duration }] }
+
+// Descargar con calidad específica
+const video = await ytDownloadV2('https://youtu.be/dQw4w9WgXcQ', 'video', '1080p')
+const audio = await ytDownloadV2('https://youtu.be/dQw4w9WgXcQ', 'mp3', '128k')
+// → { title, uploader, views, thumb, type, quality, size, sizeB, duration, url }
+
+// Obtener tamaño de un archivo por URL
+const size = await getFileSizeV2('https://example.com/file.mp4')
+// → '14.5 MB'
+```
+
 ### TikTok Stalk
 
 ```js
-import { tiktokStalk } from '@axeldev09/zenbot-scraper'
+import { tiktokStalk } from '@soyaxell09/zenbot-scraper'
 
 const profile = await tiktokStalk('charlidamelio')
 // → { id, username, nickname, bio, avatar, verified, private, bioLink, stats: { followers, following, likes, videos, followersStr, ... }, url }
@@ -205,7 +272,7 @@ const profile = await tiktokStalk('charlidamelio')
 ### Letras de canciones
 
 ```js
-import { lyricsSearch, lyricsGet } from '@axeldev09/zenbot-scraper'
+import { lyricsSearch, lyricsGet } from '@soyaxell09/zenbot-scraper'
 
 // Buscar por texto libre
 const results = await lyricsSearch('bad bunny tití me preguntó', 3)
@@ -220,7 +287,7 @@ const song = await lyricsGet('Bad Bunny', 'Tití Me Preguntó')
 ### Traductor
 
 ```js
-import { translate, getLangs } from '@axeldev09/zenbot-scraper'
+import { translate, getLangs } from '@soyaxell09/zenbot-scraper'
 
 // Traducir (auto-detecta idioma origen)
 const result = await translate('Hello, how are you?', 'es')
@@ -239,7 +306,7 @@ const langs = getLangs()
 ### Clima
 
 ```js
-import { weather } from '@axeldev09/zenbot-scraper'
+import { weather } from '@soyaxell09/zenbot-scraper'
 
 const w = await weather('Buenos Aires')
 // → { location, temp, feelsLike, humidity, wind, windDir, visibility, pressure, uvIndex, description, forecast: [{ date, maxTemp, minTemp, desc, sunrise, sunset }] }
@@ -248,7 +315,7 @@ const w = await weather('Buenos Aires')
 ### QR
 
 ```js
-import { qrGenerate, qrRead } from '@axeldev09/zenbot-scraper'
+import { qrGenerate, qrRead } from '@soyaxell09/zenbot-scraper'
 
 // Generar QR
 const qr = await qrGenerate('https://github.com/axeldev09', 300)
@@ -262,7 +329,7 @@ const result = await qrRead('https://example.com/qr.png')
 ### Acortador de URLs
 
 ```js
-import { shortenUrl, expandUrl } from '@axeldev09/zenbot-scraper'
+import { shortenUrl, expandUrl } from '@soyaxell09/zenbot-scraper'
 
 // Acortar
 const short = await shortenUrl('https://github.com/axeldev09/zenbot-scraper')
@@ -276,7 +343,7 @@ const expanded = await expandUrl('https://is.gd/xxxxx')
 ### Noticias
 
 ```js
-import { news, newsCategories } from '@axeldev09/zenbot-scraper'
+import { news, newsCategories } from '@soyaxell09/zenbot-scraper'
 
 // Obtener noticias
 const n = await news('es', 5)
@@ -290,10 +357,27 @@ const cats = newsCategories()
 ---
 
 
+### Stickers (StickersCloud)
+
+```js
+import { stickerSearch, stickerPack } from '@soyaxell09/zenbot-scraper'
+
+// Buscar packs por texto
+const packs = await stickerSearch('anime', 5)
+// → [{ packId, name, url, preview }]
+
+// Obtener stickers de un pack
+const pack = await stickerPack('mochi-mochi-peach-cat-christmas', 10)
+// → { packId, name, url, total, stickers: ['https://img-xx.stickers.cloud/...webp'] }
+
+// También acepta URL completa
+const pack2 = await stickerPack('https://stickerscloud.com/en/pack/anime-pack')
+```
+
 ### Upload (Catbox.moe)
 
 ```js
-import { upload } from '@axeldev09/zenbot-scraper'
+import { upload } from '@soyaxell09/zenbot-scraper'
 
 // Por ruta de archivo local
 const r1 = await upload('/sdcard/foto.jpg')
@@ -314,16 +398,16 @@ const r3 = await upload(buffer, 'video.mp4')
 
 ```js
 // Todo desde el índice principal
-import { ytDownload, tiktokDownload, translate, weather } from '@axeldev09/zenbot-scraper'
+import { ytDownload, tiktokDownload, translate, weather } from '@soyaxell09/zenbot-scraper'
 
 // Solo scrapers
-import { ytDownload, fbDownload } from '@axeldev09/zenbot-scraper/scrapers'
+import { ytDownload, fbDownload } from '@soyaxell09/zenbot-scraper/scrapers'
 
 // Solo search
-import { googleSearch, spotify } from '@axeldev09/zenbot-scraper/search'
+import { googleSearch, spotify } from '@soyaxell09/zenbot-scraper/search'
 
 // Solo tools
-import { translate, weather, news } from '@axeldev09/zenbot-scraper/tools'
+import { translate, weather, news } from '@soyaxell09/zenbot-scraper/tools'
 ```
 
 ---
@@ -339,6 +423,20 @@ import { translate, weather, news } from '@axeldev09/zenbot-scraper/tools'
 
 **AxelDev09** — [GitHub](https://github.com/axeldev09)
 
+---
+
+## ⭐ Apoyá el proyecto
+
+Si este módulo te fue útil, dejá una ⭐ en el repositorio. Le pusimos mucho esfuerzo y tiempo para que funcione bien.
+
+**Dejá los créditos** si usás este módulo en tu bot — es lo único que se pide 🙏
+
+📸 Seguime en Instagram: [@axeldev09](https://instagram.com/axeldev09)
+
+📢 Canal oficial de ZenBot en WhatsApp: [Unirse al canal](https://whatsapp.com/channel/0029Vb6OR9O2v1IvoXO5oT2c)
+
+---
+
 ## 📄 Licencia
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soyaxell09/zenbot-scraper",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Scrapers de descarga y búsqueda para bots de WhatsApp — YouTube, TikTok, Facebook, Twitter, Pinterest, MediaFire, GitHub, APK y más.",
   "type": "module",
   "main": "src/index.js",
@@ -34,7 +34,8 @@
     "translate",
     "qr",
     "news",
-    "upload"
+    "upload",
+    "stickers"
   ],
   "author": "AxelDev09",
   "license": "MIT",

package/src/index.js

@@ -13,11 +13,11 @@ export { tweetInfo, tweetDownload }                                from './scrap
 export { mediafireInfo }                                           from './scrapers/mediafire.js'
 export { githubInfo, githubRelease, githubContents, githubSearch } from './scrapers/github.js'
 export { apkSearch, apkInfo }                                      from './scrapers/apk.js'
-export { stickerSearch, stickerPack }                              from './scrapers/stickers.js'
 export { googleSearch }                                            from './search/google.js'
 export { spotify }                                                 from './search/spotify.js'
 export { giphy }                                                   from './search/giphy.js'
 export { pinsearch, pinimg, pinvid }                               from './search/pinterest.js'
+export { stickerSearch }                                           from './search/stickersearch.js'
 export { tiktokStalk }                                             from './tools/tiktokstalk.js'
 export { lyricsSearch, lyricsGet }                                 from './tools/lyrics.js'
 export { translate, getLangs }                                     from './tools/translator.js'

package/src/scrapers/index.js

@@ -5,5 +5,4 @@ export { fbDownload }                                            from './faceboo
 export { tweetInfo, tweetDownload }                              from './twitter.js'
 export { mediafireInfo }                                         from './mediafire.js'
 export { githubInfo, githubRelease, githubContents, githubSearch } from './github.js'
-export { apkSearch, apkInfo }                                    from './apk.js'
-export { stickerSearch, stickerPack }                            from './stickers.js'
+export { apkSearch, apkInfo }                                    from './apk.js'

package/src/search/index.js

@@ -10,3 +10,4 @@ export { googleSearch }              from './google.js'
 export { spotify }                   from './spotify.js'
 export { giphy }                     from './giphy.js'
 export { pinsearch, pinimg, pinvid } from './pinterest.js'
+export { stickerSearch }             from './stickersearch.js'

package/src/search/stickersearch.js

@@ -0,0 +1,49 @@
+/*
+ * © Created by AxelDev09 🔥
+ * GitHub: https://github.com/AxelDev09
+ * Instagram: @axeldev09
+ * Deja los créditos we 🗣️
+ */
+
+import axios from 'axios'
+import * as cheerio from 'cheerio'
+
+export async function stickerSearch(text, limit = 10) {
+  try {
+    const response = await axios.get(
+      `https://getstickerpack.com/stickers?query=${encodeURIComponent(text)}`
+    )
+    const $     = cheerio.load(response.data)
+    const packs = $('.sticker-pack-block')
+
+    if (packs.length === 0)
+      return { status: false, text: 'ningún resultado encontrado' }
+
+    const randomIndex  = Math.floor(Math.random() * packs.length)
+    const selectedPack = $(packs[randomIndex])
+    const title        = selectedPack.find('.title').text().trim()
+    const creator      = selectedPack.find('.username').text().trim()
+    const packLink     = selectedPack.closest('a').attr('href')
+
+    const packResponse = await axios.get(packLink)
+    const packHtml     = cheerio.load(packResponse.data)
+    const images       = packHtml('.sticker-pack-cols img')
+    const totalImages  = images.length
+
+    const imageArray = []
+    images.each((i, img) => {
+      if (i < limit) imageArray.push(packHtml(img).attr('src'))
+    })
+
+    return {
+      status:  true,
+      nombre:  title,
+      creador: creator,
+      total:   totalImages,
+      fotos:   imageArray,
+      url:     packLink,
+    }
+  } catch (error) {
+    return { status: false, text: 'Error al acceder al sitio' }
+  }
+}

package/test.js

@@ -0,0 +1,4 @@
+import { stickerSearch } from './src/index.js'
+
+const result = await stickerSearch('anime')
+console.log(result)

package/test.js.bak

@@ -0,0 +1,5 @@
+import { stickerSearch } from './src/index.js'
+
+const result = await stickerSearch('anime')
+console.log(result.name, result.creator, result.total)
+console.log(result.stickers[0])

package/src/scrapers/stickers.js

@@ -1,101 +0,0 @@
-/*
- * © Created by AxelDev09 🔥
- * GitHub: https://github.com/AxelDev09
- * Instagram: @axeldev09
- * Deja los créditos we 🗣️
- */
-
-import axios from 'axios'
-import * as cheerio from 'cheerio'
-
-const HEADERS = {
-  'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/120.0.0.0 Safari/537.36',
-}
-const BASE = 'https://stickerscloud.com'
-
-function extractPackId(url) {
-  const m = url.match(/\/pack\/([^/?#]+)/)
-  return m ? m[1] : null
-}
-
-export async function stickerSearch(query, limit = 10) {
-  if (!query?.trim()) throw new Error('Query vacío')
-
-  const res = await axios.get(
-    `${BASE}/search?q=${encodeURIComponent(query)}`,
-    { headers: HEADERS, timeout: 15000 }
-  )
-
-  const $       = cheerio.load(res.data)
-  const results = []
-  const seen    = new Set()
-
-  $('a[href*="/pack/"]').each((_, el) => {
-    if (results.length >= limit) return false
-    const href  = $(el).attr('href') || ''
-    const packId = extractPackId(href)
-    if (!packId || seen.has(packId)) return
-    seen.add(packId)
-
-    const name    = $(el).text().trim() || packId
-    const preview = $(el).find('img').first().attr('src')
-      || $(el).closest('[class]').find('img[src*="stickers.cloud"]').first().attr('src')
-      || ''
-
-    if (!name || name.startsWith('#') === false && name.length < 2) return
-
-    const cleanName = decodeURIComponent(
-      (name.replace(/^#\d+\s*/, '').trim() || packId)
-        .replace(/-/g, ' ')
-        .replace(/\b\w/g, l => l.toUpperCase())
-    )
-    results.push({
-      packId,
-      name:    cleanName,
-      url:     `${BASE}/en/pack/${packId}`,
-      preview: preview || '',
-    })
-  })
-
-  if (!results.length) throw new Error('Sin resultados para: ' + query)
-  return results
-}
-
-export async function stickerPack(packIdOrUrl, limit = 30) {
-  const packId = packIdOrUrl.includes('stickerscloud.com')
-    ? extractPackId(packIdOrUrl)
-    : packIdOrUrl
-
-  if (!packId) throw new Error('Pack ID o URL inválida')
-
-  const res = await axios.get(
-    `${BASE}/en/pack/${packId}`,
-    { headers: HEADERS, timeout: 15000 }
-  )
-
-  const $       = cheerio.load(res.data)
-  const stickers = []
-  const seen    = new Set()
-
-  $('img[src*="stickers.cloud"]').each((_, el) => {
-    if (stickers.length >= limit) return false
-    const src = $(el).attr('src') || ''
-    if (!src || seen.has(src)) return
-    seen.add(src)
-    stickers.push(src)
-  })
-
-  const name = decodeURIComponent(packId)
-    .replace(/-/g, ' ')
-    .replace(/\b\w/g, l => l.toUpperCase())
-
-  if (!stickers.length) throw new Error('No se encontraron stickers en ese pack')
-
-  return {
-    packId,
-    name,
-    url:      `${BASE}/en/pack/${packId}`,
-    total:    stickers.length,
-    stickers,
-  }
-}