brave-real-browser-mcp-server 2.24.3 → 2.24.5

package/dist/handlers/advanced-tools.js

@@ -586,22 +586,78 @@ export async function handleDeepAnalysis(page, args) {
 }
 /**
  * Record full network traffic - Uses response events to avoid crashes
+ * ULTRA POWERFUL: API detection, media URLs, smart categorization
  */
 export async function handleNetworkRecorder(page, args) {
     const requests = [];
     const duration = args.duration || 10000;
     let totalSize = 0;
+    const categories = {};
+    const apis = [];
+    const mediaUrls = [];
+    const seen = new Set();
+    // ============================================================
+    // SMART CATEGORIZATION HELPER
+    // ============================================================
+    const categorizeUrl = (url, resourceType) => {
+        const urlLower = url.toLowerCase();
+        // API endpoints
+        if (/\/api\/|\/v\d+\/|\.json(\?|$)|graphql/i.test(url))
+            return 'api';
+        // Media
+        if (/\.(mp4|webm|m3u8|ts|mp3|flac|ogg)/i.test(url))
+            return 'media';
+        if (resourceType === 'media' || resourceType === 'video' || resourceType === 'audio')
+            return 'media';
+        // Images
+        if (/\.(jpg|jpeg|png|gif|webp|svg|ico)/i.test(url) || resourceType === 'image')
+            return 'image';
+        // Scripts
+        if (/\.js(\?|$)/i.test(url) || resourceType === 'script')
+            return 'script';
+        // Styles
+        if (/\.css(\?|$)/i.test(url) || resourceType === 'stylesheet')
+            return 'style';
+        // Fonts
+        if (/\.(woff2?|ttf|eot|otf)/i.test(url) || resourceType === 'font')
+            return 'font';
+        // XHR/Fetch
+        if (resourceType === 'xhr' || resourceType === 'fetch')
+            return 'xhr';
+        // Documents
+        if (resourceType === 'document')
+            return 'document';
+        return 'other';
+    };
     // Response handler - safer than request interception
     const responseHandler = (response) => {
         try {
             const url = response.url();
+            // Dedup
+            if (seen.has(url))
+                return;
+            seen.add(url);
             if (args.filterUrl && !url.includes(args.filterUrl)) {
                 return;
             }
+            const resourceType = response.request()?.resourceType?.() || 'unknown';
+            const method = response.request()?.method?.() || 'GET';
+            const category = categorizeUrl(url, resourceType);
+            categories[category] = (categories[category] || 0) + 1;
+            // Collect API endpoints
+            if (category === 'api' || resourceType === 'xhr' || resourceType === 'fetch') {
+                apis.push({ url, method, type: resourceType });
+            }
+            // Collect media URLs
+            if (category === 'media' || /\.(mp4|webm|m3u8|ts|mp3)/i.test(url)) {
+                mediaUrls.push(url);
+            }
             const entry = {
                 url,
                 status: response.status(),
-                resourceType: response.request()?.resourceType?.() || 'unknown',
+                resourceType,
+                category,
+                method,
                 timestamp: Date.now(),
             };
             if (args.includeHeaders) {
@@ -612,7 +668,6 @@ export async function handleNetworkRecorder(page, args) {
                     entry.headers = {};
                 }
             }
-            // Note: Response body requires async handling, skip for stability
             requests.push(entry);
             // Track size from headers
             try {
@@ -647,6 +702,10 @@ export async function handleNetworkRecorder(page, args) {
         requests: requests.slice(0, 500),
         count: requests.length,
         totalSize,
+        categories,
+        apis: apis.length > 0 ? apis : undefined,
+        mediaUrls: mediaUrls.length > 0 ? mediaUrls : undefined,
+        message: `📡 Recorded ${requests.length} requests (${Math.round(totalSize / 1024)}KB) | APIs: ${apis.length} | Media: ${mediaUrls.length}`
     };
 }
 /**
@@ -776,6 +835,7 @@ export async function handleAdProtectionDetector(page, args) {
 }
 /**
  * Wait for dynamic AJAX loading
+ * ULTRA POWERFUL: Infinite scroll, lazy load, mutation observer
  */
 export async function handleAjaxContentWaiter(page, args) {
     const timeout = args.timeout || 30000;
@@ -783,6 +843,79 @@ export async function handleAjaxContentWaiter(page, args) {
     const startTime = Date.now();
     let content;
     let loaded = false;
+    let newElementsCount = 0;
+    let scrollDepth = 0;
+    // ============================================================
+    // 1. MUTATION OBSERVER: Track DOM changes in real-time
+    // ============================================================
+    const setupMutationObserver = async () => {
+        return await page.evaluate(() => {
+            return new Promise((resolve) => {
+                let added = 0;
+                let modified = 0;
+                const observer = new MutationObserver((mutations) => {
+                    mutations.forEach(m => {
+                        added += m.addedNodes.length;
+                        if (m.type === 'attributes' || m.type === 'characterData')
+                            modified++;
+                    });
+                });
+                observer.observe(document.body, {
+                    childList: true,
+                    subtree: true,
+                    attributes: true,
+                    characterData: true
+                });
+                // Return after 2 seconds of observation
+                setTimeout(() => {
+                    observer.disconnect();
+                    resolve({ added, modified });
+                }, 2000);
+            });
+        });
+    };
+    // ============================================================
+    // 2. INFINITE SCROLL DETECTION
+    // ============================================================
+    const handleInfiniteScroll = async () => {
+        const initialHeight = await page.evaluate(() => document.body.scrollHeight);
+        const initialCount = await page.evaluate(() => document.querySelectorAll('*').length);
+        // Scroll to bottom
+        await page.evaluate(() => window.scrollTo(0, document.body.scrollHeight));
+        await new Promise(r => setTimeout(r, 1000));
+        // Check if new content loaded
+        const newHeight = await page.evaluate(() => document.body.scrollHeight);
+        const newCount = await page.evaluate(() => document.querySelectorAll('*').length);
+        return {
+            scrolled: newHeight > initialHeight,
+            newElements: newCount - initialCount,
+            scrollDepth: newHeight
+        };
+    };
+    // ============================================================
+    // 3. LAZY LOAD DETECTION
+    // ============================================================
+    const detectLazyLoad = async () => {
+        return await page.evaluate(() => {
+            const lazyElements = [];
+            // Check for common lazy load patterns
+            document.querySelectorAll('[data-src], [data-lazy], [loading="lazy"], .lazy, .lazyload').forEach(el => {
+                const dataSrc = el.getAttribute('data-src') || el.getAttribute('data-lazy');
+                if (dataSrc)
+                    lazyElements.push(dataSrc);
+            });
+            // Intersection Observer based lazy images
+            document.querySelectorAll('img[data-src], img.lazy').forEach(img => {
+                const dataSrc = img.dataset.src;
+                if (dataSrc)
+                    lazyElements.push(dataSrc);
+            });
+            return lazyElements;
+        });
+    };
+    // ============================================================
+    // 4. MAIN WAITING LOGIC
+    // ============================================================
     while (Date.now() - startTime < timeout) {
         if (args.selector) {
             const element = await page.$(args.selector);
@@ -795,17 +928,35 @@ export async function handleAjaxContentWaiter(page, args) {
             }
         }
         else {
-            // Wait for network to be idle
-            await page.waitForNetworkIdle({ timeout: pollInterval }).catch(() => { });
-            loaded = true;
-            break;
+            // Smart waiting: Check for ongoing activity
+            const mutationResult = await setupMutationObserver();
+            newElementsCount = mutationResult.added;
+            if (mutationResult.added === 0 && mutationResult.modified === 0) {
+                // No DOM changes, content likely loaded
+                loaded = true;
+                break;
+            }
+        }
+        // Try infinite scroll to load more content
+        const scrollResult = await handleInfiniteScroll();
+        if (scrollResult.scrolled) {
+            scrollDepth = scrollResult.scrollDepth;
+            newElementsCount += scrollResult.newElements;
         }
         await new Promise((r) => setTimeout(r, pollInterval));
     }
+    // Detect any lazy-loaded content
+    const lazyElements = await detectLazyLoad();
     return {
         loaded,
         waitTime: Date.now() - startTime,
         content,
+        newElementsCount,
+        scrollDepth,
+        lazyElements: lazyElements.length > 0 ? lazyElements : undefined,
+        message: loaded
+            ? `✅ Content loaded in ${Date.now() - startTime}ms (${newElementsCount} new elements, scroll: ${scrollDepth}px)`
+            : `⏱️ Timeout after ${timeout}ms`
     };
 }
 /**
@@ -1002,20 +1153,124 @@ export async function handleVideoRecording(page, args, recorderState) {
 }
 /**
  * Harvest all links from page
+ * ULTRA POWERFUL: Pagination detection, smart categorization, file types
  */
 export async function handleLinkHarvester(page, args) {
     const currentUrl = new URL(page.url());
-    const allLinks = await page.evaluate((filter) => {
-        return Array.from(document.querySelectorAll('a[href]')).map((a) => ({
-            url: a.href,
-            text: a.textContent?.trim()?.substring(0, 100) || '',
-        }));
-    }, args.filter);
+    // ============================================================
+    // 1. EXTRACT ALL LINKS WITH SMART CATEGORIZATION
+    // ============================================================
+    const allLinks = await page.evaluate(() => {
+        const links = [];
+        document.querySelectorAll('a[href]').forEach((a) => {
+            const anchor = a;
+            links.push({
+                url: anchor.href,
+                text: a.textContent?.trim()?.substring(0, 100) || '',
+                attrs: {
+                    rel: anchor.rel || '',
+                    target: anchor.target || '',
+                    class: anchor.className || '',
+                    id: anchor.id || '',
+                    download: anchor.download || '',
+                }
+            });
+        });
+        return links;
+    });
+    // ============================================================
+    // 2. PAGINATION DETECTION
+    // ============================================================
+    const pagination = await page.evaluate(() => {
+        let nextPage;
+        let prevPage;
+        let totalPages;
+        // Common pagination selectors
+        const nextSelectors = [
+            'a[rel="next"]', 'a.next', 'a.pagination-next',
+            '[aria-label="Next"]', 'a:has-text("Next")', 'a:has-text(">")',
+            '.pagination a:last-child', 'a.page-link:last-child'
+        ];
+        const prevSelectors = [
+            'a[rel="prev"]', 'a.prev', 'a.pagination-prev',
+            '[aria-label="Previous"]', 'a:has-text("Prev")', 'a:has-text("<")'
+        ];
+        for (const sel of nextSelectors) {
+            try {
+                const el = document.querySelector(sel);
+                if (el?.href) {
+                    nextPage = el.href;
+                    break;
+                }
+            }
+            catch { /* invalid selector */ }
+        }
+        for (const sel of prevSelectors) {
+            try {
+                const el = document.querySelector(sel);
+                if (el?.href) {
+                    prevPage = el.href;
+                    break;
+                }
+            }
+            catch { /* invalid selector */ }
+        }
+        // Count page numbers
+        const pageNumbers = Array.from(document.querySelectorAll('.pagination a, .page-numbers a, nav a'))
+            .map(a => parseInt(a.textContent || '0', 10))
+            .filter(n => !isNaN(n) && n > 0);
+        if (pageNumbers.length > 0) {
+            totalPages = Math.max(...pageNumbers);
+        }
+        return { nextPage, prevPage, totalPages };
+    });
+    // ============================================================
+    // 3. SMART LINK CATEGORIZATION
+    // ============================================================
+    const categorizeLink = (url, text, attrs) => {
+        const urlLower = url.toLowerCase();
+        const textLower = text.toLowerCase();
+        // File downloads
+        if (/\.(pdf|doc|docx|xls|xlsx|zip|rar|7z|tar|gz)(\?.*)?$/i.test(url))
+            return 'document';
+        if (/\.(mp4|mkv|avi|mov|webm|flv)(\?.*)?$/i.test(url))
+            return 'video';
+        if (/\.(mp3|wav|flac|aac|ogg)(\?.*)?$/i.test(url))
+            return 'audio';
+        if (/\.(jpg|jpeg|png|gif|webp|svg|bmp)(\?.*)?$/i.test(url))
+            return 'image';
+        if (attrs.download)
+            return 'download';
+        // Navigation
+        if (/\/(next|page|p)\/\d+|[?&]page=\d+/i.test(url))
+            return 'pagination';
+        if (textLower.includes('next') || textLower.includes('prev'))
+            return 'pagination';
+        // Social
+        if (/facebook|twitter|instagram|linkedin|youtube|tiktok/i.test(url))
+            return 'social';
+        // Common patterns
+        if (/login|signin|sign-in/i.test(url))
+            return 'auth';
+        if (/register|signup|sign-up/i.test(url))
+            return 'auth';
+        if (/search|query|q=/i.test(url))
+            return 'search';
+        if (/contact|about|faq|help/i.test(url))
+            return 'info';
+        return 'navigation';
+    };
     const processedLinks = [];
+    const categories = {};
+    const seen = new Set();
     let internal = 0;
     let external = 0;
     for (const link of allLinks) {
         try {
+            // Dedup by URL
+            if (seen.has(link.url))
+                continue;
+            seen.add(link.url);
             const linkUrl = new URL(link.url);
             const isInternal = linkUrl.hostname === currentUrl.hostname;
             if (args.filter && !link.url.includes(args.filter) && !link.text.includes(args.filter)) {
@@ -1025,10 +1280,13 @@ export async function handleLinkHarvester(page, args) {
                 continue;
             if (!isInternal && args.includeExternal === false)
                 continue;
+            const category = categorizeLink(link.url, link.text, link.attrs);
+            categories[category] = (categories[category] || 0) + 1;
             processedLinks.push({
                 url: link.url,
                 text: link.text,
                 type: isInternal ? 'internal' : 'external',
+                category,
             });
             if (isInternal)
                 internal++;
@@ -1045,6 +1303,10 @@ export async function handleLinkHarvester(page, args) {
         links: processedLinks,
         internal,
         external,
+        pagination: (pagination.nextPage || pagination.prevPage || pagination.totalPages) ? pagination : undefined,
+        categories,
+        message: `🔗 Found ${processedLinks.length} links (${internal} internal, ${external} external)` +
+            (pagination.nextPage ? ` | Next: ${pagination.nextPage}` : '')
     };
 }
 /**
@@ -2367,18 +2629,19 @@ export async function handleCloudflareBypass(page, args) {
 }
 /**
  * Master tool: Extract direct stream/download URLs
+ * ULTRA POWERFUL: Handles packed JS, JW Player, Video.js, HLS.js, obfuscated scripts
  */
 export async function handleStreamExtractor(page, args) {
-    const formats = args.formats || ['mp4', 'mkv', 'm3u8', 'mp3', 'webm'];
+    const formats = args.formats || ['mp4', 'mkv', 'm3u8', 'mp3', 'webm', 'flv', 'avi'];
     const maxRedirects = args.maxRedirects || 10;
     const directUrls = [];
     // Navigate if URL provided
     if (args.url) {
         await page.goto(args.url, { waitUntil: 'domcontentloaded', timeout: 30000 });
     }
-    // Handle Cloudflare if enabled (inline logic)
+    // Handle Cloudflare if enabled
     if (args.bypassCloudflare) {
-        const cfPatterns = ['Checking your browser', 'Just a moment', 'cf-browser-verification'];
+        const cfPatterns = ['Checking your browser', 'Just a moment', 'cf-browser-verification', 'cf_chl_opt'];
         const isCloudflare = async () => {
             try {
                 const content = await page.content();
@@ -2388,72 +2651,212 @@ export async function handleStreamExtractor(page, args) {
                 return false;
             }
         };
-        // Wait up to 15 seconds for Cloudflare to pass
         const startCf = Date.now();
-        while (await isCloudflare() && Date.now() - startCf < 15000) {
+        while (await isCloudflare() && Date.now() - startCf < 20000) {
             await new Promise(r => setTimeout(r, 1000));
         }
     }
-    // Handle countdown if enabled (inline logic)
+    // Handle countdown if enabled
     if (args.waitForCountdown) {
-        const maxWait = 60;
+        const maxWait = 120;
         const startTime = Date.now();
         while ((Date.now() - startTime) / 1000 < maxWait) {
             const hasCountdown = await page.evaluate(() => {
                 const text = document.body?.innerText || '';
-                return /\d+\s*seconds?|wait\s*\d+|please\s*wait|countdown/gi.test(text);
+                return /\d+\s*seconds?|wait\s*\d+|please\s*wait|countdown|getting link/gi.test(text);
             });
             if (!hasCountdown)
                 break;
             await new Promise(r => setTimeout(r, 1000));
         }
     }
-    // Extract URLs from page
-    const extractedUrls = await page.evaluate((fmts) => {
+    // ULTRA POWERFUL: Extract from all sources
+    const extractedData = await page.evaluate((fmts) => {
         const urls = [];
-        const patterns = fmts.map(f => new RegExp(`https?://[^"'\\s]+\\.${f}([?#][^"'\\s]*)?`, 'gi'));
-        // Check page HTML
         const html = document.documentElement.innerHTML;
-        patterns.forEach(pattern => {
-            const matches = html.match(pattern);
-            if (matches)
-                urls.push(...matches);
+        // ============================================================
+        // 1. PACKED JS UNPACKING (p,a,c,k,e,d)
+        // ============================================================
+        const unpackPackedJS = (packed) => {
+            try {
+                // Find packed function pattern
+                const match = packed.match(/eval\(function\(p,a,c,k,e,[rd]\)\{[^}]+\}[^)]+\('[^']+'/);
+                if (!match)
+                    return '';
+                // Extract the encoded string and dictionary
+                const stringsMatch = packed.match(/'([^']+)'\.split\('\|'\)/);
+                if (!stringsMatch)
+                    return '';
+                const dict = stringsMatch[1].split('|');
+                let result = packed;
+                // Replace placeholders with actual values
+                for (let i = 0; i < dict.length; i++) {
+                    if (dict[i]) {
+                        const base36 = i.toString(36);
+                        result = result.replace(new RegExp(`\\b${base36}\\b`, 'g'), dict[i]);
+                    }
+                }
+                return result;
+            }
+            catch {
+                return '';
+            }
+        };
+        // Find and unpack all packed scripts
+        const scripts = document.querySelectorAll('script');
+        scripts.forEach(script => {
+            const content = script.textContent || '';
+            if (content.includes('eval(function(p,a,c,k,e,')) {
+                const unpacked = unpackPackedJS(content);
+                // Extract URLs from unpacked content
+                fmts.forEach(fmt => {
+                    const regex = new RegExp(`https?://[^"'\\s]+\\.${fmt}[^"'\\s]*`, 'gi');
+                    const matches = unpacked.match(regex);
+                    if (matches)
+                        matches.forEach(url => urls.push({ url, source: 'packed_js' }));
+                });
+            }
         });
-        // Check video/audio sources
-        document.querySelectorAll('video source, audio source, video, audio').forEach(el => {
-            const src = el.getAttribute('src');
-            if (src && fmts.some(f => src.includes(`.${f}`))) {
-                urls.push(src);
+        // ============================================================
+        // 2. JW PLAYER DETECTION
+        // ============================================================
+        if (window.jwplayer) {
+            try {
+                const player = window.jwplayer();
+                if (player && player.getPlaylistItem) {
+                    const item = player.getPlaylistItem();
+                    if (item) {
+                        if (item.file)
+                            urls.push({ url: item.file, source: 'jwplayer' });
+                        if (item.sources) {
+                            item.sources.forEach((s) => {
+                                if (s.file)
+                                    urls.push({ url: s.file, source: 'jwplayer' });
+                            });
+                        }
+                    }
+                }
             }
+            catch { /* ignore */ }
+        }
+        // JW Player setup patterns in scripts
+        const jwPatterns = [
+            /file:\s*["']([^"']+\.m3u8[^"']*?)["']/gi,
+            /file:\s*["']([^"']+\.mp4[^"']*?)["']/gi,
+            /sources:\s*\[\s*\{[^}]*file:\s*["']([^"']+)["']/gi,
+            /setup\([^)]*file:\s*["']([^"']+)["']/gi,
+        ];
+        jwPatterns.forEach(pattern => {
+            let match;
+            while ((match = pattern.exec(html)) !== null) {
+                urls.push({ url: match[1], source: 'jwplayer_setup' });
+            }
+        });
+        // ============================================================
+        // 3. VIDEO.JS DETECTION
+        // ============================================================
+        const videoJsPlayers = document.querySelectorAll('.video-js, [data-setup], video[id^="vjs"]');
+        videoJsPlayers.forEach(player => {
+            const video = player.querySelector('source') || player;
+            const src = video.getAttribute('src') || player.src;
+            if (src)
+                urls.push({ url: src, source: 'videojs' });
+        });
+        // ============================================================
+        // 4. HLS.JS DETECTION
+        // ============================================================
+        const hlsPatterns = [
+            /hls\.loadSource\(["']([^"']+)["']\)/gi,
+            /Hls\.loadSource\(["']([^"']+)["']\)/gi,
+            /source:\s*["']([^"']+\.m3u8[^"']*)["']/gi,
+            /src:\s*["']([^"']+\.m3u8[^"']*)["']/gi,
+        ];
+        hlsPatterns.forEach(pattern => {
+            let match;
+            while ((match = pattern.exec(html)) !== null) {
+                urls.push({ url: match[1], source: 'hlsjs' });
+            }
+        });
+        // ============================================================
+        // 5. PLYR DETECTION
+        // ============================================================
+        if (window.Plyr) {
+            try {
+                const plyrPlayer = window.player;
+                if (plyrPlayer && plyrPlayer.source) {
+                    urls.push({ url: plyrPlayer.source, source: 'plyr' });
+                }
+            }
+            catch { /* ignore */ }
+        }
+        // ============================================================
+        // 6. DATA ATTRIBUTES
+        // ============================================================
+        document.querySelectorAll('[data-src], [data-video], [data-file], [data-stream]').forEach(el => {
+            const attrs = ['data-src', 'data-video', 'data-file', 'data-stream', 'data-link'];
+            attrs.forEach(attr => {
+                const val = el.getAttribute(attr);
+                if (val && fmts.some(f => val.includes(`.${f}`))) {
+                    urls.push({ url: val, source: 'data_attr' });
+                }
+            });
+        });
+        // ============================================================
+        // 7. STANDARD VIDEO/AUDIO ELEMENTS
+        // ============================================================
+        document.querySelectorAll('video, audio, source').forEach(el => {
+            const src = el.getAttribute('src');
+            if (src)
+                urls.push({ url: src, source: 'html_media' });
         });
-        // Check links
+        // ============================================================
+        // 8. DIRECT LINKS
+        // ============================================================
         document.querySelectorAll('a[href]').forEach(el => {
             const href = el.href;
             if (href && fmts.some(f => href.includes(`.${f}`))) {
-                urls.push(href);
+                urls.push({ url: href, source: 'direct_link' });
             }
         });
-        // Check iframes for embedded players
+        // ============================================================
+        // 9. IFRAME PLAYERS
+        // ============================================================
         document.querySelectorAll('iframe').forEach(iframe => {
             const src = iframe.src;
-            if (src && (src.includes('player') || src.includes('embed'))) {
-                urls.push(`iframe:${src}`);
+            if (src && (src.includes('player') || src.includes('embed') || src.includes('video'))) {
+                urls.push({ url: `iframe:${src}`, source: 'iframe' });
             }
         });
-        return [...new Set(urls)];
+        // ============================================================
+        // 10. REGEX SCAN OF ENTIRE HTML
+        // ============================================================
+        fmts.forEach(fmt => {
+            const pattern = new RegExp(`https?://[^"'\\s<>]+\\.${fmt}[^"'\\s<>]*`, 'gi');
+            const matches = html.match(pattern);
+            if (matches)
+                matches.forEach(url => urls.push({ url, source: 'regex_scan' }));
+        });
+        // Deduplicate
+        const seen = new Set();
+        return urls.filter(u => {
+            if (seen.has(u.url))
+                return false;
+            seen.add(u.url);
+            return true;
+        });
     }, formats);
     // Process found URLs
-    for (const url of extractedUrls) {
-        const format = formats.find(f => url.includes(`.${f}`)) || 'unknown';
+    for (const item of extractedData) {
+        const format = formats.find(f => item.url.includes(`.${f}`)) || 'unknown';
         directUrls.push({
-            url,
+            url: item.url,
             format,
             quality: args.quality || 'auto',
+            source: item.source,
         });
     }
     // Check network requests for media URLs
     const networkUrls = await page.evaluate((fmts) => {
-        // Check performance entries for loaded resources
         const resources = performance.getEntriesByType('resource');
         return resources
             .filter(r => fmts.some(f => r.name.includes(`.${f}`)))
@@ -2462,14 +2865,14 @@ export async function handleStreamExtractor(page, args) {
     for (const url of networkUrls) {
         if (!directUrls.some(d => d.url === url)) {
             const format = formats.find(f => url.includes(`.${f}`)) || 'unknown';
-            directUrls.push({ url, format });
+            directUrls.push({ url, format, source: 'network' });
         }
     }
     return {
         success: directUrls.length > 0,
         directUrls,
         message: directUrls.length > 0
-            ? `Found ${directUrls.length} direct URL(s)`
+            ? `🎬 Found ${directUrls.length} direct URL(s) from ${new Set(directUrls.map(d => d.source)).size} sources`
             : 'No direct URLs found',
     };
 }

package/dist/handlers/content-handlers.js

@@ -80,6 +80,40 @@ export async function handleFindSelector(args) {
             // Ensure elementType has a fallback value
             const elementType = args?.elementType || '*';
             tracker.setProgress(10, '🔧 Preparing search strategies...');
+            // ============================================================
+            // FUZZY MATCHING: Levenshtein distance for typo tolerance
+            // ============================================================
+            const fuzzyMatch = (str1, str2, threshold = 0.7) => {
+                const s1 = str1.toLowerCase();
+                const s2 = str2.toLowerCase();
+                // Exact match
+                if (s1 === s2)
+                    return { match: true, score: 1 };
+                // Contains match
+                if (s1.includes(s2) || s2.includes(s1))
+                    return { match: true, score: 0.9 };
+                // Levenshtein distance
+                const len1 = s1.length;
+                const len2 = s2.length;
+                const matrix = [];
+                for (let i = 0; i <= len1; i++)
+                    matrix[i] = [i];
+                for (let j = 0; j <= len2; j++)
+                    matrix[0][j] = j;
+                for (let i = 1; i <= len1; i++) {
+                    for (let j = 1; j <= len2; j++) {
+                        const cost = s1[i - 1] === s2[j - 1] ? 0 : 1;
+                        matrix[i][j] = Math.min(matrix[i - 1][j] + 1, // deletion
+                        matrix[i][j - 1] + 1, // insertion
+                        matrix[i - 1][j - 1] + cost // substitution
+                        );
+                    }
+                }
+                const distance = matrix[len1][len2];
+                const maxLen = Math.max(len1, len2);
+                const score = 1 - (distance / maxLen);
+                return { match: score >= threshold, score };
+            };
             // Helper: Search in Shadow DOM
             const searchInShadowDOM = async (sel) => {
                 return await pageInstance.evaluate((selector) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "2.24.3",
+  "version": "2.24.5",
   "description": "🦁 MCP server for Brave Real Browser - NPM Workspaces Monorepo with anti-detection features, SSE streaming, and LSP compatibility",
   "type": "module",
   "main": "dist/index.js",
@@ -50,7 +50,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "latest",
     "@types/turndown": "latest",
-    "brave-real-browser": "^2.5.3",
+    "brave-real-browser": "^2.5.5",
     "turndown": "latest",
     "vscode-languageserver": "^9.0.1",
     "vscode-languageserver-textdocument": "^1.0.12"