nekostream 2026.4.2 → 2026.4.4

package/dist/scrapers/anilist-api.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.anilistApi = exports.AniListApiService = void 0;
-// AniList API service for fetching anime metadata and images
 const logger_1 = require("../logger");
+const vietnamese_titles_1 = require("./vietnamese-titles");
 // ============ Cache Implementation ============
 const cache = new Map();
 const CACHE_TTL = 1000 * 60 * 60 * 24; // 24 hours
@@ -276,18 +276,19 @@ class AniListApiService {
      * Max 2 API queries in most cases.
      */
     async findByTitleVariants(title, titleAlt) {
-        // Split multi-name strings by comma → get individual clean names
+        const mappedVn = (0, vietnamese_titles_1.lookupVietnameseTitle)(title) || (titleAlt ? (0, vietnamese_titles_1.lookupVietnameseTitle)(titleAlt) : undefined);
+        const vnVariants = mappedVn ? mappedVn.split(',').map(s => s.trim()).filter(s => s.length >= 2) : [];
         const altVariants = titleAlt
             ? titleAlt.split(',').map(s => s.trim()).filter(s => s.length >= 2)
             : [];
         const titleVariants = title
             ? title.split(',').map(s => s.trim()).filter(s => s.length >= 2)
             : [];
-        // Priority: best alt names first, then main names
+        // Priority: Vietnamese mapped canonical names first, then alt names, then raw title names
         // Use Set to deduplicate
         const seen = new Set();
         const queriesToTry = [];
-        for (const v of [...altVariants, ...titleVariants]) {
+        for (const v of [...vnVariants, ...altVariants, ...titleVariants]) {
             const lower = v.toLowerCase();
             if (!seen.has(lower)) {
                 seen.add(lower);
@@ -381,7 +382,7 @@ class AniListApiService {
                 malId: match.idMal,
                 cover: match.coverImage.extraLarge || match.coverImage.large,
                 banner: match.bannerImage,
-                synopsis: match.description,
+                synopsis: match.description ? this.cleanSynopsis(match.description) : undefined,
                 score: match.averageScore,
                 episodes: match.episodes,
                 status: match.status,
@@ -394,6 +395,21 @@ class AniListApiService {
             return null;
         }
     }
+    cleanSynopsis(text) {
+        return text
+            .replace(/<br\s*\/?>/gi, ' ')
+            .replace(/<\/p>/gi, ' ')
+            .replace(/<[^>]+>/g, '')
+            .replace(/&quot;/g, '"')
+            .replace(/&#039;/g, "'")
+            .replace(/&apos;/g, "'")
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&nbsp;/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+    }
     /**
      * Clean title for better search results
      */
@@ -425,6 +441,8 @@ class AniListApiService {
             .replace(/[^\w\s]/g, '')
             .replace(/\s+/g, ' ')
             .trim();
+        const mappedVn = (0, vietnamese_titles_1.lookupVietnameseTitle)(title) || (titleAlt ? (0, vietnamese_titles_1.lookupVietnameseTitle)(titleAlt) : undefined);
+        const vnTerms = mappedVn ? mappedVn.split(',').map(s => normalizeStr(this.cleanTitle(s.trim()))).filter(Boolean) : [];
         // We compare against all comma-split variants for better matching
         const searchTitles = title
             .split(',')
@@ -433,7 +451,7 @@ class AniListApiService {
         const searchAltTitles = titleAlt
             ? titleAlt.split(',').map(s => normalizeStr(this.cleanTitle(s.trim()))).filter(Boolean)
             : [];
-        const allSearchTerms = [...new Set([...searchAltTitles, ...searchTitles])];
+        const allSearchTerms = [...new Set([...vnTerms, ...searchAltTitles, ...searchTitles])];
         // Threshold score - prevents unrelated matches (like Evangelion from "NGO")
         let bestScore = 15;
         let bestMatch = null;

package/dist/scrapers/base.js

@@ -3,12 +3,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseScraper = void 0;
 class BaseScraper {
-    async getHomeCards(_section = 'trending') {
+    async getHomeCards(_section = 'trending', _page = 1) {
         return [];
     }
     async getSchedule() {
         return [];
     }
+    async getAnimeByGenre(_genre, _page = 1) {
+        return [];
+    }
     // Helper to build full URL
     buildUrl(path) {
         if (path.startsWith('http'))

package/dist/scrapers/providers/anime47.js

@@ -219,7 +219,7 @@ class Anime47Provider extends base_1.BaseScraper {
     parseEpisodeLinksFromHtml(html, animeId) {
         return (0, cards_1.parseEpisodeLinksFromHtml)(html, animeId, this.baseUrl);
     }
-    async getHomeCards(section = 'trending') {
+    async getHomeCards(section = 'trending', _page = 1) {
         try {
             const html = await this.fetchHtml(this.baseUrl, { retries: 2 });
             const state = this.extractInitialState(html);

package/dist/scrapers/providers/animehay.js

@@ -190,16 +190,16 @@ class AnimehayProvider extends base_1.BaseScraper {
         return results;
     }
     // ── BaseScraper interface ───────────────────────────────────────────────
-    async getHomeCards(section = 'trending') {
+    async getHomeCards(section = 'trending', page = 1) {
         try {
             // Main listing page shows all recently updated anime
             const url = section === 'trending'
-                ? `${this.baseUrl}/xep-hang`
-                : `${this.baseUrl}/phim-moi-cap-nhap/tat-ca-1.html`;
+                ? (page > 1 ? `${this.baseUrl}/xep-hang?page=${page}` : `${this.baseUrl}/xep-hang`)
+                : `${this.baseUrl}/phim-moi-cap-nhap/tat-ca-${page}.html`;
             const html = await this.fetchHtml(url);
             const cards = this.parseCardsFromHtml(html);
-            // Also fetch page 2 for 'latest' to have more content
-            if (section === 'latest' && cards.length < 30) {
+            // Also fetch page 2 for 'latest' if page 1 has few items
+            if (section === 'latest' && page === 1 && cards.length < 30) {
                 try {
                     const html2 = await this.fetchHtml(`${this.baseUrl}/phim-moi-cap-nhap/tat-ca-2.html`);
                     const cards2 = this.parseCardsFromHtml(html2);

package/dist/scrapers/providers/animevietsub/parsers/cards.js

@@ -41,6 +41,7 @@ exports.parseHomeCards = parseHomeCards;
 const cheerio = __importStar(require("cheerio"));
 const html_utils_1 = require("../../../html-utils");
 const logger_1 = require("../../../../logger");
+const vietnamese_titles_1 = require("../../../vietnamese-titles");
 function parseIdFromUrl(url) {
     const cleanUrl = url.replace(/\.html$/, '').replace(/\/$/, '');
     const pathMatch = cleanUrl.match(/\/phim\/([^/]+)/);
@@ -141,13 +142,12 @@ function extractCardData($root, $, baseUrl) {
         .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
         .join(' ');
     const isVietnamese = (s) => /[àáạảãâầấậẩẫăằắặẳẵèéẹẻẽêềếệểễìíịỉĩòóọỏõôồốộổỗơờớợởỡùúụủũưừứựửữỳýỵỷỹđ]/i.test(s);
+    const mappedTitle = (0, vietnamese_titles_1.lookupVietnameseTitle)(title) || (0, vietnamese_titles_1.lookupVietnameseTitle)(titleFromSlug);
     const titleAlt = subtitleFromCard && subtitleFromCard.toLowerCase() !== title.toLowerCase()
         ? isVietnamese(subtitleFromCard)
-            ? undefined
+            ? (mappedTitle || undefined)
             : subtitleFromCard
-        : titleFromSlug.toLowerCase() !== title.toLowerCase()
-            ? titleFromSlug
-            : undefined;
+        : mappedTitle || (titleFromSlug.toLowerCase() !== title.toLowerCase() ? titleFromSlug : undefined);
     const thumbnail = (0, html_utils_1.absolutizeUrl)(baseUrl, $img.attr('data-src') || $img.attr('src') || '');
     let cover = (0, html_utils_1.absolutizeUrl)(baseUrl, $root.find('[style*="background-image"]').first().attr('data-src') ||
         $root.find('[style*="background-image"]').first().attr('src') ||

package/dist/scrapers/providers/animevietsub/parsers/detail.js

@@ -99,9 +99,14 @@ function parseDetailFromHtml(html, id, baseUrl) {
         return (/[àáạảãâầấậẩẫăằắặẳẵèéẹẻẽêềếệểễìíịỉĩòóọỏõôồốộổỗơờớợởỡùúụủũưừứựửữỳýỵỷỹđ]/i.test(value) ||
             /\b(người|một|của|và|không|nhưng|phải|đã|để|trong|tình|gia tộc|sát thủ|kết hôn)\b/i.test(value));
     };
+    const isSeoSpam = (value) => {
+        if (!value)
+            return true;
+        return /kanefusa|fansub|webdescription|vua hải tặc đảo hải tặc|hoạt hình trung quốc/i.test(value);
+    };
     const cleanDescriptionCandidate = (value) => {
         const cleaned = normalizeInfoText((0, html_utils_1.decodeHtml)(String(value || '')));
-        if (!cleaned || cleaned.length < 40 || looksLikeInfoBlock(cleaned))
+        if (!cleaned || cleaned.length < 15 || looksLikeInfoBlock(cleaned) || isSeoSpam(cleaned))
             return '';
         return cleaned;
     };
@@ -117,32 +122,28 @@ function parseDetailFromHtml(html, id, baseUrl) {
     };
     // Extract descriptions (VI/EN)
     const descriptionSelectors = [
-        '.Description',
-        '.desc',
-        '.summary',
-        '.Synopsis',
-        '.synopsis',
-        '.overview',
-        '.MovieDescription',
+        '.TPost .Description',
         '.entry-content .Description',
         '.post-content .Description',
-        '.TPost .Description',
-        '.TPost .desc',
-        '.TPost .summary',
+        '.MovieDescription',
+        '.Description:not(.WebDescription)',
+        '.film-content',
+        '#film-content',
+        '.detail-content',
         '[itemprop="description"]',
-        '[class*="description"]',
-        '[class*="Description"]',
-        '[class*="desc"]',
-        '[class*="Desc"]',
-        '[class*="summary"]',
-        '[class*="Summary"]'
+        '.desc:not(.WebDescription)',
+        '.summary:not(.WebDescription)',
+        '.Synopsis',
+        '.synopsis',
     ];
     const descriptionCandidates = [];
     for (const selector of descriptionSelectors) {
         $(selector).each((_, el) => {
+            if ($(el).hasClass('WebDescription') || $(el).closest('.WebDescription').length > 0)
+                return;
             const $el = $(el).clone();
             $el
-                .find('script, style, nav, a[href*="/the-loai/"], a[href*="/tag/"], .InfoList, .MovieInfo, .breadcrumb')
+                .find('script, style, nav, a[href*="/the-loai/"], a[href*="/tag/"], .InfoList, .MovieInfo, .breadcrumb, .WebDescription')
                 .remove();
             const candidate = cleanDescriptionCandidate($el.text());
             if (candidate && !descriptionCandidates.includes(candidate)) {

package/dist/scrapers/providers/animevietsub/streams/extractors.js

@@ -45,106 +45,37 @@ function extractFromAbyssServer(embedUrl, server, defaultBaseUrl) {
     }
 }
 /**
- * Extract video from DU server (storage.googleapiscdn.com)
+ * Extract video from DU server (stream.googleapiscdn.com / storage.googleapiscdn.com)
  */
-async function extractFromDUServer(embedUrl, server, baseUrl) {
-    const crawler = await (0, crawler_1.getCrawler)();
-    const page = await crawler.newPage();
+function extractFromDUServer(embedUrl, server, defaultBaseUrl) {
     try {
-        const interceptedUrls = [];
-        page.on('response', async (response) => {
-            const url = response.url();
-            const contentType = response.headers()['content-type'] || '';
-            if (url.includes('.m3u8') ||
-                url.includes('.mp4') ||
-                url.includes('/playlist/') ||
-                url.includes('/hls/') ||
-                url.includes('/video/') ||
-                contentType.includes('mpegurl') ||
-                contentType.includes('video/')) {
-                interceptedUrls.push(url);
-            }
-        });
-        await page.goto(embedUrl, {
-            waitUntil: 'domcontentloaded',
-            timeout: 30000
-        });
-        await page.waitForTimeout(3000);
-        const jsUrls = await (0, interceptor_1.extractVideoFromJS)(page);
-        interceptedUrls.push(...jsUrls);
+        const refererVal = server.referer || defaultBaseUrl;
+        let origin = defaultBaseUrl;
         try {
-            await page.click('video, .play-button, [class*="play"]').catch(() => { });
-            await page.waitForTimeout(2000);
+            origin = new URL(refererVal).origin;
         }
         catch { }
-        const cleanUrls = interceptedUrls.filter(url => !(0, adblock_policy_1.isAdUrl)(url));
-        const m3u8Url = cleanUrls.find(url => url.includes('.m3u8'));
-        const playlistUrl = cleanUrls.find(url => url.includes('/playlist/'));
-        const mp4Url = cleanUrls.find(url => url.includes('.mp4'));
-        const streamUrl = m3u8Url || playlistUrl || mp4Url;
-        if (streamUrl) {
-            if (streamUrl.includes('/playlist/')) {
-                return {
-                    url: embedUrl,
-                    type: 'iframe',
-                    quality: server.quality || 'FHD',
-                    headers: {
-                        'Referer': baseUrl,
-                        'Origin': baseUrl
-                    }
-                };
-            }
-            if (streamUrl.includes('/chunks/')) {
-                return {
-                    url: embedUrl,
-                    type: 'iframe',
-                    quality: server.quality || 'FHD',
-                    headers: {
-                        'Referer': baseUrl,
-                        'Origin': baseUrl
-                    }
-                };
-            }
-            if (streamUrl.includes('.m3u8')) {
-                const finalM3u8 = toMediaProxyUrl(streamUrl, embedUrl);
-                const playlist = await (0, interceptor_1.fetchM3U8)(streamUrl, { Referer: embedUrl });
-                if (playlist && playlist.qualities.length > 0) {
-                    return {
-                        url: finalM3u8,
-                        type: 'hls',
-                        quality: playlist.qualities[0].quality,
-                        headers: {
-                            'Referer': embedUrl,
-                            'Origin': new URL(embedUrl).origin
-                        }
-                    };
-                }
+        return {
+            url: embedUrl,
+            type: 'iframe',
+            quality: server.quality || 'FHD',
+            headers: {
+                'Referer': refererVal,
+                'Origin': origin
             }
-            return {
-                url: streamUrl.includes('storage.googleapis') || streamUrl.includes('/chunks/')
-                    ? toMediaProxyUrl(streamUrl, embedUrl)
-                    : streamUrl,
-                type: streamUrl.includes('.m3u8') ? 'hls' : 'mp4',
-                quality: server.quality || 'FHD',
-                headers: {
-                    'Referer': embedUrl,
-                    'Origin': new URL(embedUrl).origin
-                }
-            };
-        }
+        };
+    }
+    catch {
         return {
             url: embedUrl,
             type: 'iframe',
             quality: server.quality || 'HD',
             headers: {
-                'Referer': baseUrl,
-                'Origin': baseUrl
+                'Referer': defaultBaseUrl,
+                'Origin': defaultBaseUrl
             }
         };
     }
-    finally {
-        await page.close();
-    }
 }
 /**
  * Generic Playwright-based extraction
@@ -246,9 +177,11 @@ async function extractFromAPIServer(hash, server, context) {
                     const dummyServer = { ...server, embedUrl: link, referer: refererUrl };
                     return extractFromAbyssServer(link, dummyServer, context.baseUrl);
                 }
-                if (link.includes('storage.googleapiscdn.com') || link.includes('storage.googleapis.com')) {
-                    const dummyServer = { ...server, embedUrl: link };
-                    return await extractFromDUServer(link, dummyServer, context.baseUrl);
+                if (link.includes('googleapiscdn.com') ||
+                    link.includes('googleapis.com') ||
+                    link.includes('storage.')) {
+                    const dummyServer = { ...server, embedUrl: link, referer: refererUrl };
+                    return extractFromDUServer(link, dummyServer, context.baseUrl);
                 }
                 return {
                     url: link,
@@ -305,15 +238,19 @@ async function extractAnimeVietsubStream(server, context) {
             if (!embedUrl.startsWith('http')) {
                 embedUrl = embedUrl.startsWith('//') ? `https:${embedUrl}` : `https://${embedUrl}`;
             }
-            if (embedUrl.includes('storage.googleapiscdn.com') || server.type === 'iframe') {
-                res = await extractFromDUServer(embedUrl, server, context.baseUrl);
-            }
-            else if (embedUrl.includes('abyss') ||
+            if (embedUrl.includes('abyss') ||
                 embedUrl.includes('playhydrax') ||
                 server.name.includes('HDX') ||
                 server.name.includes('Hydrax')) {
                 res = extractFromAbyssServer(embedUrl, server, context.baseUrl);
             }
+            else if (embedUrl.includes('googleapiscdn.com') ||
+                embedUrl.includes('googleapis.com') ||
+                embedUrl.includes('storage.') ||
+                server.name.includes('DU') ||
+                server.type === 'iframe') {
+                res = extractFromDUServer(embedUrl, server, context.baseUrl);
+            }
             else if (server.type === 'api') {
                 res = await extractFromAPIServer(embedUrl, server, context);
             }

package/dist/scrapers/providers/animevietsub/streams/server-parser.js

@@ -34,19 +34,39 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatServerName = formatServerName;
+exports.sortVideoServers = sortVideoServers;
 exports.parseServersFromBackupHtml = parseServersFromBackupHtml;
 exports.parseServersFromWatchHtml = parseServersFromWatchHtml;
 const cheerio = __importStar(require("cheerio"));
 function formatServerName(nameOrSource, url) {
     const value = `${nameOrSource || ''} ${url || ''}`.toLowerCase();
     if (value.includes('du') || value.includes('googleapiscdn') || value.includes('storage.')) {
-        return 'DU (Normal Speed Fetch/Sometime Unstable)';
+        return 'DU (Dự phòng • Tốc độ trung bình)';
     }
     if (value.includes('hdx') || value.includes('hydrax') || value.includes('abyss') || value.includes('playhydrax')) {
-        return 'HDX (Fastest Speed Fetch/Very Stable)';
+        return 'HDX (Khuyên dùng • Tốc độ cao • Không quảng cáo)';
     }
     return nameOrSource?.trim() || 'Server';
 }
+function sortVideoServers(servers) {
+    return [...servers].sort((a, b) => {
+        const score = (s) => {
+            const n = (s.name || '').toUpperCase();
+            if (n.includes('HDX') || n.includes('HYDRAX') || n.includes('ABYSS'))
+                return 100;
+            if (n.includes('VIP'))
+                return 80;
+            if (n.includes('FB'))
+                return 70;
+            if (n.includes('GOOGLE'))
+                return 60;
+            if (n.includes('DU'))
+                return 10;
+            return 50;
+        };
+        return score(b) - score(a);
+    });
+}
 /**
  * Parse servers returned by the AJAX POST backup endpoint
  */
@@ -87,7 +107,7 @@ function parseServersFromBackupHtml(html, episodeId, baseUrl) {
             });
         }
     });
-    return servers;
+    return sortVideoServers(servers);
 }
 /**
  * Parse video servers from the watch page HTML
@@ -218,5 +238,5 @@ function parseServersFromWatchHtml(html) {
             });
         }
     }
-    return servers;
+    return sortVideoServers(servers);
 }

package/dist/scrapers/providers/animevietsub.js

@@ -490,10 +490,23 @@ class AnimeVietsubProvider extends base_1.BaseScraper {
             return [];
         }
     }
-    async getHomeCards(section = 'trending') {
-        const listUrl = section === 'latest'
-            ? `${this.baseUrl}/danh-sach/phim-moi-cap-nhat/`
-            : `${this.baseUrl}/`;
+    async getHomeCards(section = 'trending', page = 1) {
+        let listUrl;
+        if (section === 'upcoming') {
+            listUrl = page > 1
+                ? `${this.baseUrl}/danh-sach/phim-sap-chieu/trang-${page}.html`
+                : `${this.baseUrl}/danh-sach/phim-sap-chieu/`;
+        }
+        else if (section === 'latest') {
+            listUrl = page > 1
+                ? `${this.baseUrl}/danh-sach/phim-moi-cap-nhat/trang-${page}.html`
+                : `${this.baseUrl}/danh-sach/phim-moi-cap-nhat/`;
+        }
+        else {
+            listUrl = page > 1
+                ? `${this.baseUrl}/danh-sach/phim-hot/trang-${page}.html`
+                : `${this.baseUrl}/`;
+        }
         try {
             // useBrowserFallback: true → 403 after retries auto-escalates to Playwright
             const html = await this.fetchHtml(listUrl, { timeoutMs: 25000, retries: 2, useBrowserFallback: true });
@@ -501,26 +514,124 @@ class AnimeVietsubProvider extends base_1.BaseScraper {
             if (results.length > 0)
                 return results.slice(0, 48);
             // Only fallback to search when HTML parsed OK but yielded 0 cards (not a 403/down scenario)
-            (0, logger_1.debugWarn)('[Scraper] getHomeCards: HTML loaded but 0 cards parsed, trying search fallback');
-            return this.searchInternal('anime', true);
+            if (page === 1) {
+                (0, logger_1.debugWarn)('[Scraper] getHomeCards: HTML loaded but 0 cards parsed, trying search fallback');
+                return this.searchInternal('anime', true);
+            }
+            return [];
         }
         catch (error) {
             // Site is temporarily down — propagate as a typed error so UI can show proper message
             if (error instanceof fingerprint_1.SiteDownError) {
-                (0, logger_1.debugWarn)(`[Scraper] getHomeCards(${section}): ${error.message}`);
+                (0, logger_1.debugWarn)(`[Scraper] getHomeCards(${section}, page=${page}): ${error.message}`);
                 throw error;
             }
-            console.error(`[Scraper] getHomeCards(${section}) error:`, error);
-            if (section === 'latest') {
+            console.error(`[Scraper] getHomeCards(${section}, page=${page}) error:`, error);
+            if (section === 'latest' && page === 1) {
                 // Fallback to trending homepage when latest page is unstable (non-down errors only)
-                return this.getHomeCards('trending');
+                return this.getHomeCards('trending', 1);
             }
-            // Do NOT fall back to search() — it would also fail and make the error worse.
-            // Return empty array so HomeView can show a graceful empty/retry state.
-            console.error('[Scraper] getHomeCards completely failed — returning empty array for graceful UI');
             return [];
         }
     }
+    static GENRE_SLUGS = {
+        'hanh-dong': 'hanh-dong',
+        'action': 'hanh-dong',
+        'hành động': 'hanh-dong',
+        'phieu-luu': 'phieu-luu',
+        'adventure': 'phieu-luu',
+        'phiêu lưu': 'phieu-luu',
+        'hai-huoc': 'hai-huoc',
+        'comedy': 'hai-huoc',
+        'hài hước': 'hai-huoc',
+        'phep-thuat': 'phep-thuat',
+        'fantasy': 'phep-thuat',
+        'huyền ảo': 'phep-thuat',
+        'phép thuật': 'phep-thuat',
+        'tinh-cam': 'tinh-cam',
+        'romance': 'tinh-cam',
+        'tình cảm': 'tinh-cam',
+        'truong-hoc': 'truong-hoc',
+        'school': 'truong-hoc',
+        'học đường': 'truong-hoc',
+        'doi-thuong': 'doi-thuong',
+        'slice of life': 'doi-thuong',
+        'đời thường': 'doi-thuong',
+        'isekai': 'isekai',
+        'sci-fi': 'sci-fi',
+        'kinh-di': 'kinh-di',
+        'horror': 'kinh-di',
+        'kinh dị': 'kinh-di',
+        'mystery': 'mystery',
+        'trinh thám': 'mystery',
+        'trinh-tham': 'mystery',
+        'sieu-nhien': 'sieu-nhien',
+        'supernatural': 'sieu-nhien',
+        'siêu nhiên': 'sieu-nhien',
+        'the-thao': 'the-thao',
+        'sports': 'the-thao',
+        'thể thao': 'the-thao',
+        'mecha': 'mecha',
+        'am-nhac': 'am-nhac',
+        'music': 'am-nhac',
+        'âm nhạc': 'am-nhac',
+        'co-trang': 'co-trang',
+        'cổ trang': 'co-trang',
+        'tro-choi': 'tro-choi',
+        'game': 'tro-choi',
+        'trò chơi': 'tro-choi',
+        'harem': 'harem',
+        'psychological': 'psychological',
+        'tâm lý': 'psychological',
+        'tam-ly': 'psychological',
+        'hoi-hop': 'hoi-hop',
+        'suspense': 'hoi-hop',
+        'hồi hộp': 'hoi-hop',
+        'thriller': 'thriller',
+        'martial-arts': 'martial-arts',
+        'võ thuật': 'martial-arts',
+        'vo-thuat': 'martial-arts',
+        'lich-su': 'lich-su',
+        'historical': 'lich-su',
+        'lịch sử': 'lich-su',
+        'quan-doi': 'quan-doi',
+        'military': 'quan-doi',
+        'quân đội': 'quan-doi',
+        'shounen': 'shounen',
+        'seinen': 'seinen',
+        'shoujo': 'shoujo',
+        'vampire': 'vampire',
+        'ma cà rồng': 'vampire',
+        'parody': 'parody',
+        'tokusatsu': 'tokusatsu',
+        'drama': 'drama',
+        'ecchi': 'ecchi',
+        'demons': 'demons',
+        'magic': 'ma-thuat',
+        'police': 'police',
+        'space': 'space',
+        'super-power': 'super-power',
+    };
+    async getAnimeByGenre(genre, page = 1) {
+        const rawKey = genre.trim().toLowerCase();
+        const slug = AnimeVietsubProvider.GENRE_SLUGS[rawKey] || rawKey.replace(/\s+/g, '-');
+        const listUrl = page > 1
+            ? `${this.baseUrl}/the-loai/${slug}/trang-${page}.html`
+            : `${this.baseUrl}/the-loai/${slug}/`;
+        try {
+            const html = await this.fetchHtml(listUrl, { timeoutMs: 25000, retries: 2, useBrowserFallback: true });
+            const results = (0, cards_1.parseHomeCards)(html, this.baseUrl);
+            if (results.length > 0)
+                return results.slice(0, 48);
+            return this.searchInternal(genre, true);
+        }
+        catch (error) {
+            if (error instanceof fingerprint_1.SiteDownError)
+                throw error;
+            (0, logger_1.debugWarn)(`[Scraper] getAnimeByGenre(${genre}, page=${page}) error: ${error}, falling back to search`);
+            return this.searchInternal(genre, true);
+        }
+    }
     parseSearchCards(html) {
         if (html.length < 100)
             return [];