@lmna22/aio-downloader 2.0.0 → 2.0.2

package/README.md

@@ -1,6 +1,6 @@
 # @lmna22/aio-downloader
 
-> All-in-one media downloader for YouTube, Instagram, TikTok, Pinterest, Pixiv, X/Twitter, and Lahelu.
+> All-in-one media downloader for YouTube, Instagram, TikTok, Pinterest, Pixiv, X/Twitter, Lahelu, and Xiaohongshu/RedNote.
 
 [![npm version](https://img.shields.io/npm/v/@lmna22/aio-downloader.svg)](https://www.npmjs.com/package/@lmna22/aio-downloader)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -21,6 +21,7 @@ Scrape and download videos, audio, and images from multiple platforms with a sin
 | **Pixiv** | — | — | ✅ (Original Resolution) | ✅ |
 | **X / Twitter** | ✅ (Best quality) | — | ✅ | — |
 | **Lahelu** | ✅ | — | ✅ | — |
+| **Xiaohongshu/RedNote** | ✅ | — | ✅ | — |
 
 - 🔗 **Auto-detect platform** from URL — just pass any supported link
 - 📦 **Programmatic API** — designed for Node.js applications, bots, and scripts
@@ -53,11 +54,11 @@ npm install puppeteer
 ```javascript
 const { lmna, aioDownloader } = require("@lmna22/aio-downloader");
 
-// Using the lmna namespace (recommended)
+// Recommended: use the lmna namespace
 const result = await lmna.youtube("https://www.youtube.com/watch?v=dQw4w9WgXcQ", 5);
 console.log(result);
 
-// Or auto-detect platform from URL
+// Unified: auto-detect platform from URL
 const result2 = await aioDownloader("https://www.instagram.com/p/ABC123/");
 console.log(result2);
 ```
@@ -71,209 +72,53 @@ console.log(result2);
 ```javascript
 const { lmna } = require("@lmna22/aio-downloader");
 
-// Quality options:
-// 1 = 144p, 2 = 360p, 3 = 480p, 4 = 720p,
-// 5 = 1080p, 6 = 1440p, 7 = 2160p,
-// 8 = Audio only (MP3), 9 = Get bitrate list
-
-// Download a video in 1080p
+// Quality: 1=144p, 2=360p, 5=1080p, 8=MP3, 9=bitrate list
 const result = await lmna.youtube("https://www.youtube.com/watch?v=dQw4w9WgXcQ", 5);
 
 if (result.status) {
-    console.log(result.data.title);      // "Rick Astley - Never Gonna Give You Up"
-    console.log(result.data.channel);    // "Rick Astley"
-    console.log(result.data.views);      // 1500000000
-    console.log(result.data.size);       // Buffer size in bytes
-    console.log(result.data.type);       // "mp4" or "mp3"
-
-    // Save to file
+    console.log(result.data.title);
     const fs = require("fs");
     fs.writeFileSync(`${result.data.title}.${result.data.type}`, result.data.result);
 }
-
-// Download audio only
-const audio = await lmna.youtube("https://www.youtube.com/watch?v=dQw4w9WgXcQ", 8);
-
-// Get available audio bitrates
-const bitrates = await lmna.youtube("https://www.youtube.com/watch?v=dQw4w9WgXcQ", 9);
-console.log(bitrates.data.bitrateList);
-
-// Download entire playlist
-const playlist = await lmna.youtubePlaylist(
-    "https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
-    5, // quality
-    "./my-playlist" // output folder
-);
 ```
 
 ### Instagram
 
 ```javascript
 const { lmna } = require("@lmna22/aio-downloader");
-
 const result = await lmna.instagram("https://www.instagram.com/p/ABC123/");
-
-if (result.status) {
-    console.log(result.data.url);        // Array of download URLs
-    console.log(result.data.caption);    // Post caption
-    console.log(result.data.username);   // "@username"
-    console.log(result.data.like);       // Like count
-    console.log(result.data.comment);    // Comment count
-    console.log(result.data.isVideo);    // true/false
-
-    // Download all media
-    const { download } = require("@lmna22/aio-downloader");
-    for (let i = 0; i < result.data.url.length; i++) {
-        await download(result.data.url[i], `./downloads/ig_${i + 1}.mp4`);
-    }
-}
 ```
 
 ### TikTok
 
 ```javascript
 const { lmna } = require("@lmna22/aio-downloader");
-
 const result = await lmna.tiktok("https://www.tiktok.com/@user/video/1234567890");
-
-if (result.status) {
-    const data = result.data;
-
-    console.log(data.description);       // Video description
-    console.log(data.author.nickname);   // Author name
-    console.log(data.author.uniqueId);   // @username
-    console.log(data.stats.likes);       // Like count
-    console.log(data.stats.comments);    // Comment count
-    console.log(data.stats.plays);       // Play count
-    console.log(data.music.title);       // Music title
-    console.log(data.videoInfo.duration); // Duration in seconds
-    console.log(data.videoInfo.width);    // Video width
-    console.log(data.videoInfo.height);   // Video height
-
-    // Video is returned as a Buffer — save directly
-    if (data.videoBuffer) {
-        const fs = require("fs");
-        fs.writeFileSync("tiktok_video.mp4", data.videoBuffer);
-    }
-
-    // For photo/slide posts
-    if (data.images) {
-        console.log(data.images); // Array of image URLs
-    }
-}
 ```
 
-### Pinterest
+### Xiaohongshu / RedNote
 
 ```javascript
 const { lmna } = require("@lmna22/aio-downloader");
 
-// From a direct pin URL
-const data = await lmna.pinterest("https://www.pinterest.com/pin/123456789/");
-
-// Or search by keyword
-const searchResults = await lmna.pinterest("aesthetic wallpaper", { limit: 20 });
-
-console.log(data.results);
-// [
-//   {
-//     id: "123456789",
-//     title: "Beautiful Wallpaper",
-//     link: "https://www.pinterest.com/pin/123456789/",
-//     image: "https://i.pinimg.com/originals/...",
-//     source: "example.com"
-//   }
-// ]
-```
-
-### Pixiv
-
-```javascript
-const { lmna } = require("@lmna22/aio-downloader");
-
-// From an artwork URL
-const data = await lmna.pixiv("https://www.pixiv.net/artworks/12345678");
-
-// Or search by tag/keyword
-const searchResults = await lmna.pixiv("landscape", { limit: 5 });
-
-console.log(data.results);
-// [
-//   {
-//     id: "12345678",
-//     title: "Beautiful Landscape",
-//     link: "https://www.pixiv.net/artworks/12345678",
-//     image: "https://i.pximg.net/img-original/...",
-//     artist: "ArtistName",
-//     artistUrl: "https://www.pixiv.net/users/999",
-//     userId: "999",
-//     images: ["https://i.pximg.net/img-original/..."]
-//   }
-// ]
-
-// Skip enrichment for faster results (no original resolution images)
-const fast = await lmna.pixiv("landscape", { limit: 10, enrich: false });
-```
-
-### X / Twitter
-
-```javascript
-const { lmna } = require("@lmna22/aio-downloader");
-
-const result = await lmna.twitter("https://x.com/user/status/1234567890");
+const result = await lmna.xiaohongshu("https://www.xiaohongshu.com/explore/abc123");
 
 if (result.status) {
-    console.log(result.data.author);          // "username"
-    console.log(result.data.description);     // Tweet text
-    console.log(result.data.like);            // Like count
-    console.log(result.data.view);            // View count
-    console.log(result.data.retweet);         // Retweet count
-    console.log(result.data.sensitiveContent); // true/false
-
-    // result.data.result contains media items:
-    // [
-    //   { type: "video", thumb: "https://...", url: "https://..." },
-    //   { type: "image", url: "https://...?format=png&name=large" },
-    //   { type: "gif", thumb: "https://...", url: "https://..." }
-    // ]
-
-    // Download all media
-    const { download } = require("@lmna22/aio-downloader");
-    for (let i = 0; i < result.data.result.length; i++) {
-        const media = result.data.result[i];
-        const ext = media.type === "image" ? ".png" : ".mp4";
-        await download(media.url, `./downloads/tweet_${i + 1}${ext}`);
-    }
-}
-```
-
-### Lahelu
-
-```javascript
-const { lmna } = require("@lmna22/aio-downloader");
-
-const result = await lmna.lahelu("https://lahelu.com/post/abc123");
-
-if (result.status) {
-    const data = result.data;
-
-    console.log(data.title);           // Post title
-    console.log(data.author);          // Username
-    console.log(data.createdAt);       // Creation date
-    console.log(data.stats.views);     // View count
-    console.log(data.stats.likes);     // Like count
-    console.log(data.stats.comments);  // Comment count
-    console.log(data.media.type);      // "video" or "image"
-    console.log(data.media.format);    // File format (mp4, jpg, etc.)
-    console.log(data.media.url);       // Direct download URL
-    console.log(data.fileName);        // Suggested filename
-
+    console.log(result.data.title);
+    console.log(result.data.author.nickname);
+    console.log(result.data.stats.likes);
+    console.log(result.data.stats.collects);
+    console.log(result.data.stats.comments);
+    console.log(result.data.media.url);
+    
     // Download the media
     const { download } = require("@lmna22/aio-downloader");
-    await download(data.media.url, `./downloads/${data.fileName}`);
+    await download(result.data.media.url, `./downloads/${result.data.fileName}`);
 }
 ```
 
+*(See the API Reference below for other platforms: Pinterest, Pixiv, Twitter, Lahelu)*
+
 ---
 
 ## 📥 Download Helper
@@ -309,6 +154,9 @@ await aioDownloader("https://www.pinterest.com/pin/456/");
 await aioDownloader("https://www.pixiv.net/artworks/789");
 await aioDownloader("https://x.com/user/status/101112");
 await aioDownloader("https://lahelu.com/post/abc123");
+await aioDownloader("https://www.xiaohongshu.com/explore/abc123");
+await aioDownloader("https://www.rednote.com/explore/abc123");
+await aioDownloader("https://xhslink.com/abc123");
 
 // Force a specific platform
 await aioDownloader("https://example.com/video", { platform: "youtube", quality: 5 });
@@ -322,6 +170,9 @@ detectPlatform("https://pin.it/abc123");             // "pinterest"
 detectPlatform("https://pixiv.net/artworks/456");    // "pixiv"
 detectPlatform("https://x.com/user/status/789");     // "twitter"
 detectPlatform("https://lahelu.com/post/abc");       // "lahelu"
+detectPlatform("https://xiaohongshu.com/explore/abc"); // "xiaohongshu"
+detectPlatform("https://rednote.com/explore/abc");   // "xiaohongshu"
+detectPlatform("https://xhslink.com/abc");           // "xiaohongshu"
 detectPlatform("https://unknown.com");               // null
 ```
 
@@ -329,7 +180,9 @@ detectPlatform("https://unknown.com");               // null
 
 ## 📚 API Reference
 
-### `lmna` Namespace (Recommended)
+### `lmna` Namespace (Mandatory for individual scrapers)
+
+Instead of individual function exports, all scrapers are now grouped under the `lmna` object:
 
 ```javascript
 const { lmna } = require("@lmna22/aio-downloader");
@@ -338,10 +191,13 @@ await lmna.youtube(url, quality);
 await lmna.youtubePlaylist(url, quality, folderPath);
 await lmna.instagram(url);
 await lmna.tiktok(url);
-await lmna.pinterest(input, options);
-await lmna.pixiv(input, options);
+await lmna.pinterest(url, options);
+await lmna.pixiv(url, options);
 await lmna.twitter(url);
 await lmna.lahelu(url);
+await lmna.xiaohongshu(url);
+
+// All return: { status, platform, data?, message? }
 ```
 
 ---
@@ -358,137 +214,29 @@ Auto-detect platform and scrape media data.
 
 ---
 
-### `lmna.youtube(url, quality)`
-
-| Parameter | Type | Description |
-|---|---|---|
-| `url` | `string` | YouTube video URL |
-| `quality` | `number` | 1=144p, 2=360p, 3=480p, 4=720p, 5=1080p, 6=1440p, 7=2160p, 8=MP3, 9=bitrate list |
-
-**Returns:** `{ status, platform, data: { title, result (Buffer), size, quality, desc, views, likes, channel, uploadDate, thumb, type } }`
-
----
-
-### `lmna.youtubePlaylist(url, quality, folderPath?)`
-
-Downloads all videos from a YouTube playlist.
-
-**Returns:** `{ status, platform, data: { title, resultPath[], metadata[] } }`
-
----
-
-### `lmna.instagram(url)`
-
-Uses 4 fallback methods for maximum reliability.
-
-**Returns:** `{ status, platform, data: { url[], caption, username, like, comment, isVideo } }`
-
----
-
-### `lmna.tiktok(url)`
-
-Returns video as a Buffer (no watermark). Uses direct scraping with tikwm.com API fallback.
-
-**Returns:** `{ status, platform, data: { videoId, description, videoUrl, videoBuffer (Buffer), videoInfo, author, music, stats, locationCreated, images? } }`
-
----
-
-### `lmna.pinterest(input, options?)`
-
-| Parameter | Type | Description |
-|---|---|---|
-| `input` | `string` | Pin URL or search keyword |
-| `options.limit` | `number` | Max results for search (default: 10) |
-
-**Returns:** `{ status, platform, method, total, results: [{ id, title, link, image, source }] }`
-
----
-
-### `lmna.pixiv(input, options?)`
-
-| Parameter | Type | Description |
-|---|---|---|
-| `input` | `string` | Artwork URL or search keyword |
-| `options.limit` | `number` | Max results (default: 10) |
-| `options.enrich` | `boolean` | Fetch original resolution images (default: true) |
-
-**Returns:** `{ status, platform, method, total, results: [{ id, title, link, image, artist, artistUrl, userId, images[] }] }`
-
----
-
-### `lmna.twitter(url)`
-
-Extracts best quality video/image/gif from tweets via Twitter GraphQL API.
-
-**Returns:** `{ status, platform, data: { author, like, view, retweet, description, sensitiveContent, result: [{ type, url, thumb? }] } }`
-
----
-
-### `lmna.lahelu(url)`
-
-Scrapes video or image from Lahelu posts.
-
-**Returns:** `{ status, platform, data: { postId, title, author, createdAt, stats: { views, likes, comments }, media: { type, format, url, desc }, fileName } }`
-
----
-
-### `download(url, outputPath, options?)`
-
-Helper to download any file to disk.
-
-| Parameter | Type | Description |
-|---|---|---|
-| `url` | `string` | Direct download URL |
-| `outputPath` | `string` | Local file path |
-| `options.headers` | `object` | Custom request headers |
-| `options.timeout` | `number` | Timeout in ms (default: 120000) |
-| `options.onProgress` | `function` | `({ downloaded, total, percentage })` |
-
-**Returns:** `{ path, size, filename }`
-
----
-
-### `detectPlatform(url)`
-
-**Returns:** `"youtube"` | `"instagram"` | `"tiktok"` | `"pinterest"` | `"pixiv"` | `"twitter"` | `"lahelu"` | `null`
-
----
-
-## 🔄 Migration from v1.0.x
-
-If you're upgrading from the old API, the legacy named exports still work:
+### Utility Exports
 
 ```javascript
-// Old way (still works)
-const { tiktokDownloader } = require("@lmna22/aio-downloader");
-await tiktokDownloader(url);
-
-// New way (recommended)
-const { lmna } = require("@lmna22/aio-downloader");
-await lmna.tiktok(url);
+const { detectPlatform, download } = require("@lmna22/aio-downloader");
 ```
 
+| Function | Description |
+|---|---|
+| `detectPlatform(url)` | Returns the platform name from URL |
+| `download(url, path, options)` | Helper to download files to disk |
+
 ---
 
 ## ⚠️ Error Handling
 
-All functions return `{ status: false, platform: "...", message: "..." }` on failure:
-
-```javascript
-const { lmna } = require("@lmna22/aio-downloader");
-
-const result = await lmna.youtube("https://www.youtube.com/watch?v=invalid", 5);
-if (!result.status) {
-    console.error("Failed:", result.message);
-}
-```
+All functions return `{ status: false, platform: "...", message: "..." }` on failure.
 
 ---
 
 ## 📋 Requirements
 
 - **Node.js** >= 14.0.0
-- **puppeteer** (optional) — fallback for Pinterest/Pixiv when axios scraping is blocked
+- **puppeteer** (optional) — fallback for Pinterest/Pixiv
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lmna22/aio-downloader",
-    "version": "2.0.0",
+    "version": "2.0.2",
     "description": "All-in-one media downloader for YouTube, Instagram, TikTok, Pinterest, Pixiv, and X/Twitter. Scrape and download videos, audio, and images from multiple platforms with a single library.",
     "main": "src/index.js",
     "scripts": {
@@ -37,17 +37,10 @@
         "axios-cookiejar-support": "^5.0.0",
         "cheerio": "^1.0.0",
         "ffmpeg-static": "^5.0.0",
+        "puppeteer": "^24.0.0",
         "qs": "^6.13.0",
         "tough-cookie": "^5.1.0",
-        "youtube-dl-exec": "^3.0.0"
-    },
-    "peerDependencies": {
-        "puppeteer": ">=20.0.0"
-    },
-    "peerDependenciesMeta": {
-        "puppeteer": {
-            "optional": true
-        }
+        "youtube-dl-exec": "^3.1.4"
     },
     "engines": {
         "node": ">=14.0.0"

package/src/index.js

@@ -5,6 +5,7 @@ const pinterestDownloader = require("./lib/pinterest");
 const pixivDownloader = require("./lib/pixiv");
 const twitterDownloader = require("./lib/twitter");
 const laheluDownloader = require("./lib/lahelu");
+const xiaohongshuDownloader = require("./lib/xiaohongshu");
 const download = require("./download");
 
 const PLATFORM_PATTERNS = [
@@ -15,6 +16,7 @@ const PLATFORM_PATTERNS = [
     { name: "pixiv", test: (url) => /pixiv\.net\//i.test(url) },
     { name: "twitter", test: (url) => /(?:twitter\.com\/|x\.com\/)/i.test(url) },
     { name: "lahelu", test: (url) => /lahelu\.com\/post\//i.test(url) },
+    { name: "xiaohongshu", test: (url) => /xiaohongshu\.com|rednote\.com|xhslink\.com/i.test(url) },
 ];
 
 function detectPlatform(url) {
@@ -32,6 +34,7 @@ const scrapers = {
     pixiv: (url, options) => pixivDownloader(url, options),
     twitter: (url) => twitterDownloader(url),
     lahelu: (url) => laheluDownloader(url),
+    xiaohongshu: (url) => xiaohongshuDownloader(url),
 };
 
 async function aioDownloader(url, options = {}) {
@@ -60,6 +63,7 @@ const lmna = {
     pixiv: (url, options) => pixivDownloader(url, options),
     twitter: (url) => twitterDownloader(url),
     lahelu: (url) => laheluDownloader(url),
+    xiaohongshu: (url) => xiaohongshuDownloader(url),
 };
 
 module.exports = {
@@ -67,13 +71,4 @@ module.exports = {
     aioDownloader,
     detectPlatform,
     download,
-    // Legacy named exports (backward compatible)
-    youtubeDownloader,
-    youtubePlaylistDownloader,
-    instagramDownloader,
-    tiktokDownloader,
-    pinterestDownloader,
-    pixivDownloader,
-    twitterDownloader,
-    laheluDownloader,
 };

package/src/lib/lahelu.js

@@ -25,22 +25,18 @@ function extractPostId(url) {
 }
 
 async function fetchLaheluData(postId) {
-    for (let page = 1; page <= 10; page++) {
-        const apiUrl = `https://lahelu.com/api/post/get-posts?feed=1&page=${page}`;
-
-        const res = await axios.get(apiUrl, {
-            headers: {
-                "User-Agent": DEFAULT_UA,
-                "Referer": "https://lahelu.com/",
-            },
-            timeout: 15000,
-        });
-
-        if (res.data && res.data.postInfos && Array.isArray(res.data.postInfos)) {
-            const post = res.data.postInfos.find(p => p.postId === postId || p.postID === postId);
-            if (post) return post;
-            if (!res.data.hasMore) break;
-        }
+    const apiUrl = `https://lahelu.com/api/post/get?postID=${postId}`;
+
+    const res = await axios.get(apiUrl, {
+        headers: {
+            "User-Agent": DEFAULT_UA,
+            "Referer": "https://lahelu.com/",
+        },
+        timeout: 15000,
+    });
+
+    if (res.data && res.data.postInfo) {
+        return res.data.postInfo;
     }
     return null;
 }
@@ -49,36 +45,35 @@ function normalizeMedia(post) {
     const CACHE_URL = "https://cache.lahelu.com/";
     const medias = [];
 
-    if (post.mediaType === "video" || post.type === "video") {
-        const videoUrl = post.media?.startsWith("http") ? post.media : CACHE_URL + post.media;
-        medias.push({
-            type: "video",
-            format: "mp4",
-            url: videoUrl,
-            desc: "Video",
-        });
-    } else if (post.mediaType === "image" || post.type === "image") {
-        const imageUrl = post.media?.startsWith("http") ? post.media : CACHE_URL + post.media;
+    if (post.media) {
+        const mediaUrl = post.media.startsWith("http") ? post.media : CACHE_URL + post.media;
+        const isVideo = mediaUrl.match(/\.(mp4|webm|mov)(\?.*)?$/i) || post.mediaType === 1 || post.type === 1;
+        const format = isVideo ? "mp4" : getExtFromUrl(mediaUrl, ".jpg");
+
         medias.push({
-            type: "image",
-            format: getExtFromUrl(imageUrl, ".jpg"),
-            url: imageUrl,
-            desc: "Image",
+            type: isVideo ? "video" : "image",
+            format: format,
+            url: mediaUrl,
+            desc: isVideo ? "Video" : "Image",
         });
     }
 
-    if (post.content && Array.isArray(post.content) && post.content.length > 0) {
-        const firstItem = post.content[0];
-        const mediaUrl = firstItem.value?.startsWith("http") ? firstItem.value : CACHE_URL + firstItem.value;
-        const isVideo = firstItem.type === "video" || (firstItem.value && firstItem.value.match(/\.(mp4|webm|mov)(\?.*)?$/i));
-        const mediaType = isVideo ? "video" : "image";
-        const format = mediaType === "video" ? "mp4" : getExtFromUrl(mediaUrl, ".jpg");
+    if (post.content && Array.isArray(post.content)) {
+        post.content.forEach((item) => {
+            if (!item.value) return;
 
-        medias.push({
-            type: mediaType,
-            format: format,
-            url: mediaUrl,
-            desc: mediaType === "video" ? "Video" : "Image",
+            const mediaUrl = item.value.startsWith("http") ? item.value : CACHE_URL + item.value;
+            const isVideo = mediaUrl.match(/\.(mp4|webm|mov)(\?.*)?$/i) || item.type === 1 || item.type === 4;
+            const format = isVideo ? "mp4" : getExtFromUrl(mediaUrl, ".jpg");
+
+            if (medias.some(m => m.url === mediaUrl)) return;
+
+            medias.push({
+                type: isVideo ? "video" : "image",
+                format: format,
+                url: mediaUrl,
+                desc: isVideo ? "Video" : "Image",
+            });
         });
     }
 
@@ -126,7 +121,7 @@ async function laheluDownloader(url) {
 
         const title = post.title || "Untitled";
         const author = post.userUsername || post.userInfo?.username || "Unknown";
-        const createdAt = post.createTime ? new Date(post.createTime * 1000).toLocaleDateString("en-US") : "-";
+        const createdAt = post.createTime ? new Date(post.createTime).toLocaleDateString("en-US") : "-";
         const views = parseInt(post.totalViews || 0, 10);
         const likes = parseInt(post.totalUpvotes || 0, 10);
         const comments = parseInt(post.totalComments || 0, 10);

package/src/lib/xiaohongshu.js

@@ -0,0 +1,288 @@
+const axios = require("axios");
+const path = require("path");
+const { sanitizeFileName, getExtFromUrl } = require("../utils");
+
+let puppeteer;
+try {
+    puppeteer = require("puppeteer");
+} catch (err) { }
+
+function isXiaohongshuUrl(url) {
+    try {
+        const u = new URL(url);
+        return u.hostname.includes("xiaohongshu.com") || 
+               u.hostname.includes("rednote.com") || 
+               u.hostname.includes("xhslink.com");
+    } catch {
+        return false;
+    }
+}
+
+function parseNoteId(url) {
+    const patterns = [
+        /xiaohongshu\.com\/(?:explore|discovery\/item)\/([a-f0-9]+)/i,
+        /rednote\.com\/(?:explore|discovery\/item)\/([a-f0-9]+)/i,
+        /xhslink\.com\/([a-zA-Z0-9]+)/i,
+    ];
+
+    for (const pattern of patterns) {
+        const match = url.match(pattern);
+        if (match) return match[1];
+    }
+    return null;
+}
+
+function buildPostUrl(noteIdOrUrl) {
+    if (noteIdOrUrl.startsWith("http")) return noteIdOrUrl;
+    return `https://www.xiaohongshu.com/explore/${noteIdOrUrl}`;
+}
+
+async function resolveShortLink(url) {
+    if (!url.includes("xhslink.com")) return url;
+
+    try {
+        const res = await axios.head(url, {
+            maxRedirects: 5,
+            headers: {
+                "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36",
+            },
+        });
+        return res.request.res.responseUrl || url;
+    } catch (e) {
+        if (e.response && e.response.headers && e.response.headers.location) {
+            return e.response.headers.location;
+        }
+    }
+    return url;
+}
+
+async function fetchXiaohongshuData(url) {
+    if (!puppeteer) {
+        throw new Error("Puppeteer is required for Xiaohongshu downloads. Install it with: npm install puppeteer");
+    }
+
+    let browser = null;
+    try {
+        browser = await puppeteer.launch({
+            headless: "new",
+            args: [
+                "--disable-blink-features=AutomationControlled",
+                "--disable-web-security",
+                "--disable-features=IsolateOrigins,site-per-process",
+                "--window-size=1920,1080",
+                "--no-sandbox",
+                "--disable-setuid-sandbox",
+            ],
+        });
+
+        const page = await browser.newPage();
+        await page.setViewport({ width: 1920, height: 1080 });
+
+        await page.setUserAgent(
+            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36"
+        );
+
+        await page.evaluateOnNewDocument(() => {
+            Object.defineProperty(navigator, "webdriver", { get: () => undefined });
+            Object.defineProperty(navigator, "plugins", { get: () => [1, 2, 3, 4, 5] });
+            window.chrome = { runtime: {} };
+        });
+
+        page.setDefaultTimeout(30000);
+
+        let finalUrl = await resolveShortLink(url);
+
+        await page.goto(finalUrl, {
+            waitUntil: "networkidle2",
+            timeout: 30000,
+        });
+
+        await page.waitForFunction(
+            () => window.__INITIAL_STATE__ !== undefined,
+            { timeout: 15000 }
+        );
+
+        await new Promise((r) => setTimeout(r, 1500));
+
+        const postData = await page.evaluate(() => {
+            const state = window.__INITIAL_STATE__;
+            if (!state) return null;
+
+            const noteMap = state?.note?.noteDetailMap || {};
+            const firstKey = Object.keys(noteMap)[0];
+            const noteWrapper = noteMap[firstKey];
+            const note = noteWrapper?.note || noteWrapper;
+
+            if (!note) return null;
+
+            return {
+                id: note.noteId || note.id || firstKey || "",
+                title: note.title || "",
+                desc: note.desc || "",
+                type: note.type || "normal",
+                author: {
+                    nickname: note.user?.nickname || "",
+                    userId: note.user?.userId || "",
+                    avatar: note.user?.image || note.user?.avatar || "",
+                },
+                images: (note.imageList || []).map((img) => ({
+                    url: img.urlDefault || img.url || "",
+                    livePhoto: img.livePhoto || img.stream?.h264?.[0]?.masterUrl || "",
+                    width: img.width || 0,
+                    height: img.height || 0,
+                })),
+                video: note.video ? {
+                    url: note.video.media?.stream?.h264?.[0]?.masterUrl ||
+                         note.video.media?.stream?.h265?.[0]?.masterUrl ||
+                         note.video.url || "",
+                    backupUrl: note.video.media?.stream?.h264?.[0]?.backupUrls?.[0] ||
+                               note.video.media?.stream?.h265?.[0]?.backupUrls?.[0] || "",
+                    duration: note.video.duration || 0,
+                    width: note.video.width || note.video.media?.stream?.h264?.[0]?.width || 0,
+                    height: note.video.height || note.video.media?.stream?.h264?.[0]?.height || 0,
+                    cover: note.video.image?.firstFrameFileid || note.video.thumbnail || "",
+                } : null,
+                cover: note.cover?.urlDefault || note.cover?.url || "",
+                stats: {
+                    likes: note.interactInfo?.likedCount || "0",
+                    collects: note.interactInfo?.collectedCount || "0",
+                    comments: note.interactInfo?.commentCount || "0",
+                    shares: note.interactInfo?.shareCount || "0",
+                },
+                tags: (note.tagList || []).map((tag) => tag.name || "").filter(Boolean),
+                publishedAt: note.time || "",
+                ipLocation: note.ipLocation || "",
+            };
+        });
+
+        await browser.close();
+        browser = null;
+
+        if (!postData) {
+            return null;
+        }
+
+        const medias = [];
+
+        if (postData.video && postData.video.url) {
+            medias.push({
+                type: "video",
+                format: "mp4",
+                desc: `Video ${postData.video.width}x${postData.video.height}` +
+                      (postData.video.duration ? ` (${Math.round(postData.video.duration)}s)` : ""),
+                url: postData.video.url,
+                backupUrl: postData.video.backupUrl || "",
+            });
+        }
+
+        if (postData.images && postData.images.length > 0) {
+            postData.images.forEach((img, i) => {
+                if (img.url) {
+                    medias.push({
+                        type: "image",
+                        format: "jpg",
+                        desc: `Image ${i + 1}` + (img.width && img.height ? ` (${img.width}x${img.height})` : ""),
+                        url: img.url.startsWith("http") ? img.url : `https://sns-img-bd.xhscdn.com/${img.url}`,
+                    });
+                }
+                if (img.livePhoto) {
+                    medias.push({
+                        type: "video",
+                        format: "mp4",
+                        desc: `Live Photo ${i + 1}`,
+                        url: img.livePhoto,
+                    });
+                }
+            });
+        }
+
+        return {
+            ...postData,
+            medias,
+        };
+    } catch (err) {
+        if (browser) {
+            try { await browser.close(); } catch (_) { }
+        }
+        throw err;
+    }
+}
+
+async function xiaohongshuDownloader(url) {
+    try {
+        if (!isXiaohongshuUrl(url)) {
+            return {
+                status: false,
+                platform: "xiaohongshu",
+                message: "Invalid Xiaohongshu URL. Make sure it's a valid post URL.",
+            };
+        }
+
+        const noteId = parseNoteId(url);
+        if (!noteId && !url.includes("xhslink.com")) {
+            return {
+                status: false,
+                platform: "xiaohongshu",
+                message: "Could not extract note ID from URL.",
+            };
+        }
+
+        const postUrl = buildPostUrl(url);
+        const data = await fetchXiaohongshuData(postUrl);
+
+        if (!data || !data.medias || data.medias.length === 0) {
+            return {
+                status: false,
+                platform: "xiaohongshu",
+                message: "No media found in this post. The post may be private or deleted.",
+            };
+        }
+
+        const selected = data.medias[0];
+        const ext = selected.format.startsWith(".") ? selected.format : "." + selected.format;
+        const safeTitle = sanitizeFileName(data.id || noteId || "xhs");
+        const fileName = `xhs_${safeTitle}_${selected.type}${ext}`;
+
+        return {
+            status: true,
+            platform: "xiaohongshu",
+            data: {
+                id: data.id || noteId,
+                title: data.title || "Untitled",
+                description: data.desc || "",
+                author: {
+                    nickname: data.author?.nickname || "Unknown",
+                    userId: data.author?.userId || "",
+                    avatar: data.author?.avatar || "",
+                },
+                type: data.type,
+                stats: {
+                    likes: data.stats?.likes || "0",
+                    collects: data.stats?.collects || "0",
+                    comments: data.stats?.comments || "0",
+                    shares: data.stats?.shares || "0",
+                },
+                tags: data.tags || [],
+                publishedAt: data.publishedAt,
+                ipLocation: data.ipLocation,
+                media: {
+                    type: selected.type,
+                    format: selected.format,
+                    url: selected.url,
+                    backupUrl: selected.backupUrl || "",
+                    desc: selected.desc,
+                },
+                allMedias: data.medias,
+                fileName: fileName,
+            },
+        };
+    } catch (error) {
+        return {
+            status: false,
+            platform: "xiaohongshu",
+            message: error.message || "An unexpected error occurred",
+        };
+    }
+}
+
+module.exports = xiaohongshuDownloader;

package/src/lib/youtube.js

@@ -34,7 +34,7 @@ async function youtubeDownloader(link, qualityIndex) {
         return {
             status: false,
             platform: "youtube",
-            message: `youtube-dl-exec not found, can't download video`,
+            message: "youtube-dl-exec is not installed. Install it with: npm install youtube-dl-exec",
         };
     }
     try {