@soyaxell09/zenbot-scraper 1.0.0

package/README.md

@@ -0,0 +1,344 @@
+# @axeldev09/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
+```
+
+---
+
+## 📁 Estructura
+
+```
+src/
+├── scrapers/   → Descargadores de media
+├── search/     → Buscadores
+└── tools/      → Utilidades
+```
+
+---
+
+## 🎬 Scrapers
+
+### YouTube
+
+```js
+import { ytSearch, ytDownload, ytInfo } from '@axeldev09/zenbot-scraper'
+
+// Buscar videos
+const results = await ytSearch('bad bunny', 5)
+// → [{ id, title, url, thumbnail, duration, views, channel, published }]
+
+// Descargar (URL o texto)
+const video = await ytDownload('https://youtu.be/dQw4w9WgXcQ', 'video', '360p')
+const audio = await ytDownload('nicki nicole wapo traketero', 'mp3')
+// → { title, author, thumbnail, type, url, duration, ... }
+```
+
+### YouTube v2 (via ytdown.to — más calidades)
+
+```js
+import { ytDownloadV2, ytInfoV2, getFileSizeV2 } from '@axeldev09/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
+
+```js
+import { tiktokDownload, tiktokInfo } from '@axeldev09/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 } }
+```
+
+### Facebook
+
+```js
+import { fbDownload } from '@axeldev09/zenbot-scraper'
+
+const result = await fbDownload('https://www.facebook.com/watch?v=123')
+// → { hd, sd, thumb, title }
+```
+
+### Twitter / X
+
+```js
+import { tweetInfo, tweetDownload } from '@axeldev09/zenbot-scraper'
+
+// Info completa del tweet
+const info = await tweetInfo('https://x.com/user/status/123')
+// → { id, text, lang, createdAt, likes, replies, author: { name, username, avatar }, hashtags, mentions, medias }
+
+// Solo media descargable
+const media = await tweetDownload('https://x.com/user/status/123')
+// → { id, text, author, videos: [{ type, url, thumbnail, variants }], photos: [{ type, url, width, height }] }
+```
+
+### MediaFire
+
+```js
+import { mediafireInfo } from '@axeldev09/zenbot-scraper'
+
+const result = await mediafireInfo('https://www.mediafire.com/file/abc123/archivo.apk/file')
+// → { key, name, size, download, url }
+```
+
+### GitHub
+
+```js
+import { githubInfo, githubRelease, githubContents, githubSearch } from '@axeldev09/zenbot-scraper'
+
+// Info del repositorio
+const info = await githubInfo('facebook/react')
+// → { name, fullName, description, url, stars, forks, language, license, topics, owner, cloneUrl, zipUrl, ... }
+
+// Último release
+const release = await githubRelease('facebook/react')
+// → { tag, name, body, publishedAt, url, assets: [{ name, size, downloadUrl, downloads }] }
+
+// Contenido de un directorio o archivo
+const contents = await githubContents('facebook/react', 'src')
+// → [{ name, path, type, size, url, download }]
+
+// Buscar repositorios o usuarios
+const repos = await githubSearch('whatsapp bot', 'repositories', 5)
+// → [{ name, description, url, stars, forks, language, updatedAt }]
+```
+
+### APK (APKPure)
+
+```js
+import { apkSearch, apkInfo } from '@axeldev09/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
+
+### Google (DuckDuckGo)
+
+```js
+import { googleSearch } from '@axeldev09/zenbot-scraper'
+
+const results = await googleSearch('node.js tutorial', 5)
+// → [{ title, url, snippet }]
+```
+
+### Spotify / Deezer
+
+```js
+import { spotify } from '@axeldev09/zenbot-scraper'
+
+// Buscar tracks
+const tracks = await spotify('bad bunny', 'tracks', 5)
+// → [{ title, artist, album, duration, thumbnail, url, preview }]
+
+// Buscar álbumes
+const albums = await spotify('bad bunny', 'albums', 3)
+```
+
+### Tenor (GIFs)
+
+```js
+import { giphy } from '@axeldev09/zenbot-scraper'
+
+const gifs = await giphy('funny cat', 5)
+// → [{ id, title, url, gif, preview, mp4, width, height }]
+```
+
+### Pinterest
+
+```js
+import { pinsearch, pinimg, pinvid } from '@axeldev09/zenbot-scraper'
+
+// Buscar imágenes por texto
+const imgs = await pinsearch('anime wallpaper', 5)
+// → [{ index, image, url }]
+
+// Imagen de un pin específico o por texto
+const pin = await pinimg('https://www.pinterest.com/pin/123/')
+const byText = await pinimg('anime wallpaper', 5)
+// → { id, title, description, image, images, url } | [{ index, image, url }]
+
+// Buscar videos por texto o URL de pin
+const vids = await pinvid('anime', 5)
+const pinVid = await pinvid('https://www.pinterest.com/pin/123/')
+// → [{ index, video, sd, original }]
+```
+
+---
+
+## 🛠️ Tools
+
+### TikTok Stalk
+
+```js
+import { tiktokStalk } from '@axeldev09/zenbot-scraper'
+
+const profile = await tiktokStalk('charlidamelio')
+// → { id, username, nickname, bio, avatar, verified, private, bioLink, stats: { followers, following, likes, videos, followersStr, ... }, url }
+```
+
+### Letras de canciones
+
+```js
+import { lyricsSearch, lyricsGet } from '@axeldev09/zenbot-scraper'
+
+// Buscar por texto libre
+const results = await lyricsSearch('bad bunny tití me preguntó', 3)
+// → [{ id, title, artist, album, duration, lyrics, lrc }]
+// lrc = letra sincronizada con timestamps [00:00.00]
+
+// Buscar por artista y título
+const song = await lyricsGet('Bad Bunny', 'Tití Me Preguntó')
+// → { id, title, artist, album, duration, lyrics, lrc }
+```
+
+### Traductor
+
+```js
+import { translate, getLangs } from '@axeldev09/zenbot-scraper'
+
+// Traducir (auto-detecta idioma origen)
+const result = await translate('Hello, how are you?', 'es')
+// → { original, translated, from, to, fromName, toName, source }
+
+// Especificar idioma origen
+const result2 = await translate('Hola cómo estás', 'en', 'es')
+
+// Ver idiomas disponibles
+const langs = getLangs()
+// → [{ code: 'es', name: 'Español' }, { code: 'en', name: 'English' }, ...]
+
+// Códigos disponibles: es, en, pt, fr, de, it, ja, ko, zh, ru, ar, hi, tr, nl, pl, sv, uk, vi, id
+```
+
+### Clima
+
+```js
+import { weather } from '@axeldev09/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 }] }
+```
+
+### QR
+
+```js
+import { qrGenerate, qrRead } from '@axeldev09/zenbot-scraper'
+
+// Generar QR
+const qr = await qrGenerate('https://github.com/axeldev09', 300)
+// → { url, buffer, size, text }
+
+// Leer QR desde URL de imagen
+const result = await qrRead('https://example.com/qr.png')
+// → { text, type }
+```
+
+### Acortador de URLs
+
+```js
+import { shortenUrl, expandUrl } from '@axeldev09/zenbot-scraper'
+
+// Acortar
+const short = await shortenUrl('https://github.com/axeldev09/zenbot-scraper')
+// → { short: 'https://is.gd/xxxxx', source: 'is.gd' }
+
+// Expandir
+const expanded = await expandUrl('https://is.gd/xxxxx')
+// → { original, expanded }
+```
+
+### Noticias
+
+```js
+import { news, newsCategories } from '@axeldev09/zenbot-scraper'
+
+// Obtener noticias
+const n = await news('es', 5)
+// → { category, source, items: [{ title, description, url, image, published, source }] }
+
+// Categorías disponibles
+const cats = newsCategories()
+// → ['es', 'en', 'pt', 'tech', 'sports', 'science', 'world']
+```
+
+---
+
+
+### Upload (Catbox.moe)
+
+```js
+import { upload } from '@axeldev09/zenbot-scraper'
+
+// Por ruta de archivo local
+const r1 = await upload('/sdcard/foto.jpg')
+// → { url: 'https://files.catbox.moe/xxxxx.jpg', filename: 'foto.jpg' }
+
+// Por URL remota
+const r2 = await upload('https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg')
+// → { url: 'https://files.catbox.moe/xxxxx.jpg', filename: 'file.jpg' }
+
+// Por Buffer
+const r3 = await upload(buffer, 'video.mp4')
+// → { url: 'https://files.catbox.moe/xxxxx.mp4', filename: 'video.mp4' }
+```
+
+> Sube archivos a Catbox.moe y devuelve una URL pública. Soporta imágenes, videos, audio y cualquier archivo hasta 200MB.
+
+## 📦 Importación por módulo
+
+```js
+// Todo desde el índice principal
+import { ytDownload, tiktokDownload, translate, weather } from '@axeldev09/zenbot-scraper'
+
+// Solo scrapers
+import { ytDownload, fbDownload } from '@axeldev09/zenbot-scraper/scrapers'
+
+// Solo search
+import { googleSearch, spotify } from '@axeldev09/zenbot-scraper/search'
+
+// Solo tools
+import { translate, weather, news } from '@axeldev09/zenbot-scraper/tools'
+```
+
+---
+
+## ⚙️ Requisitos
+
+- Node.js >= 18.0.0
+- Dependencias: `axios`, `cheerio`, `@distube/ytdl-core`, `form-data`
+
+---
+
+## 👤 Autor
+
+**AxelDev09** — [GitHub](https://github.com/axeldev09)
+
+## 📄 Licencia
+
+MIT

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@soyaxell09/zenbot-scraper",
+  "version": "1.0.0",
+  "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",
+  "exports": {
+    ".": "./src/index.js",
+    "./scrapers": "./src/scrapers/index.js",
+    "./search": "./src/search/index.js",
+    "./tools": "./src/tools/index.js"
+  },
+  "scripts": {
+    "test": "node test/index.js"
+  },
+  "keywords": [
+    "whatsapp",
+    "bot",
+    "scraper",
+    "downloader",
+    "youtube",
+    "tiktok",
+    "facebook",
+    "twitter",
+    "pinterest",
+    "mediafire",
+    "github",
+    "apk",
+    "deezer",
+    "tenor",
+    "google",
+    "weather",
+    "lyrics",
+    "translate",
+    "qr",
+    "news",
+    "upload"
+  ],
+  "author": "AxelDev09",
+  "license": "MIT",
+  "dependencies": {
+    "@distube/ytdl-core": "^4.16.0",
+    "axios": "^1.6.0",
+    "cheerio": "^1.0.0",
+    "form-data": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/axeldev09/zenbot-scraper"
+  }
+}

package/src/index.js

@@ -0,0 +1,27 @@
+/*
+ * © Created by AxelDev09 🔥
+ * GitHub: https://github.com/AxelDev09
+ * Instagram: @axeldev09
+ * Deja los créditos we 🗣️
+ */
+
+export { ytInfo, ytDownload, ytSearch }                            from './scrapers/youtube.js'
+export { ytInfoV2, ytDownloadV2, getFileSizeV2 }                   from './scrapers/youtubev2.js'
+export { tiktokInfo, tiktokDownload }                              from './scrapers/tiktok.js'
+export { fbDownload }                                              from './scrapers/facebook.js'
+export { tweetInfo, tweetDownload }                                from './scrapers/twitter.js'
+export { mediafireInfo }                                           from './scrapers/mediafire.js'
+export { githubInfo, githubRelease, githubContents, githubSearch } from './scrapers/github.js'
+export { apkSearch, apkInfo }                                      from './scrapers/apk.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 { tiktokStalk }                                             from './tools/tiktokstalk.js'
+export { lyricsSearch, lyricsGet }                                 from './tools/lyrics.js'
+export { translate, getLangs }                                     from './tools/translator.js'
+export { weather }                                                 from './tools/weather.js'
+export { qrGenerate, qrRead }                                      from './tools/qr.js'
+export { shortenUrl, expandUrl }                                   from './tools/urlshortener.js'
+export { news, newsCategories }                                    from './tools/news.js'
+export { upload }                                                  from './tools/upload.js'

package/src/scrapers/apk.js

@@ -0,0 +1,112 @@
+/*
+ * © 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',
+}
+
+function extractPkg(href) {
+  const m = href?.match(/\/((?:com|org|net|io|co)\.[a-z0-9.]+)(?:\/|$)/i)
+  return m ? m[1] : ''
+}
+
+async function searchPage(query) {
+  const res = await axios.get(
+    `https://apkpure.com/search?q=${encodeURIComponent(query)}`,
+    { headers: HEADERS, timeout: 15000 }
+  )
+  return cheerio.load(res.data)
+}
+
+export async function apkSearch(query, limit = 5) {
+  if (!query?.trim()) throw new Error('Query vacío')
+
+  const $       = await searchPage(query)
+  const results = []
+  const seen    = new Set()
+
+  $('.brand-info-top').each((_, el) => {
+    if (results.length >= limit) return false
+
+    const name = $(el).find('.p1').text().trim()
+    const dev  = $(el).find('.p2').text().trim()
+    const date = $(el).find('.date').text().trim()
+    const icon = $(el).closest('.search-result').find('img').first().attr('src') || ''
+
+    const appHref = $(el).closest('.search-result')
+      .find('a[href]').toArray()
+      .map(a => $(a).attr('href'))
+      .find(h => extractPkg(h)) || ''
+
+    const pkg = extractPkg(appHref)
+    if (!name || !pkg || seen.has(pkg)) return
+    seen.add(pkg)
+
+    const appUrl = appHref.startsWith('http') ? appHref : `https://apkpure.com${appHref}`
+
+    results.push({
+      name,
+      developer: dev,
+      pkg,
+      date,
+      icon,
+      appUrl,
+      dlUrl: `https://d.apkpure.com/b/XAPK/${pkg}?version=latest`,
+    })
+  })
+
+  if (!results.length) throw new Error('No se encontraron resultados')
+  return results
+}
+
+export async function apkInfo(pkgOrUrl) {
+  let pkg = pkgOrUrl
+  if (pkgOrUrl.includes('apkpure.com')) {
+    pkg = extractPkg(pkgOrUrl) || pkgOrUrl
+  }
+
+  // Buscar por última parte del pkg (ej: "whatsapp" de "com.whatsapp")
+  const shortName = pkg.split('.').pop()
+  const $         = await searchPage(shortName)
+
+  // Buscar el item que tenga el pkg correcto
+  let found = null
+  $('.brand-info-top').each((_, el) => {
+    if (found) return false
+    const appHref = $(el).closest('.search-result')
+      .find('a[href]').toArray()
+      .map(a => $(a).attr('href'))
+      .find(h => h?.includes(pkg))
+    if (appHref) found = el
+  })
+
+  const el   = found ? $(found) : $('.brand-info-top').first()
+  const name = el.find('.p1').text().trim()
+  const dev  = el.find('.p2').text().trim()
+  const date = el.find('.date').text().trim()
+  const icon = el.closest('.search-result').find('img').first().attr('src') || ''
+
+  const dlLinks = []
+  $(`a[href*="d.apkpure.com"]`).each((_, a) => {
+    const href = $(a).attr('href') || ''
+    if (href.includes(pkg)) dlLinks.push(href)
+  })
+
+  return {
+    name,
+    developer: dev,
+    pkg,
+    date,
+    icon,
+    download:  `https://d.apkpure.com/b/XAPK/${pkg}?version=latest`,
+    dlLinks:   [...new Set(dlLinks)],
+    url:       `https://apkpure.com/search?q=${shortName}`,
+  }
+}