@jshookmcp/jshook 0.1.7 → 0.1.9

package/dist/modules/captcha/AICaptchaDetector.js

@@ -1,391 +0,0 @@
-import { writeFile, mkdir } from 'fs/promises';
-import { join } from 'path';
-import { logger } from '../../utils/logger.js';
-export class AICaptchaDetector {
-    llm;
-    screenshotDir;
-    hasLoggedVisionFallback = false;
-    constructor(llm, screenshotDir = './screenshots') {
-        this.llm = llm;
-        this.screenshotDir = screenshotDir;
-    }
-    async saveScreenshot(screenshotBase64) {
-        try {
-            await mkdir(this.screenshotDir, { recursive: true });
-            const timestamp = Date.now();
-            const filename = `captcha-${timestamp}.png`;
-            const filepath = join(this.screenshotDir, filename);
-            const buffer = Buffer.from(screenshotBase64, 'base64');
-            await writeFile(filepath, buffer);
-            logger.info(`Screenshot saved: ${filepath}`);
-            return filepath;
-        }
-        catch (error) {
-            logger.error('Failed to persist CAPTCHA screenshot', error);
-            throw error;
-        }
-    }
-    async detect(page) {
-        try {
-            logger.info('Running AI captcha detection...');
-            const screenshot = await page.screenshot({
-                encoding: 'base64',
-                fullPage: false,
-            });
-            const pageInfo = await this.getPageInfo(page);
-            const analysis = await this.analyzeWithAI(screenshot, pageInfo);
-            logger.info(`AI CAPTCHA detection result: ${analysis.detected ? 'detected' : 'not_detected'} (confidence: ${analysis.confidence}%)`);
-            return analysis;
-        }
-        catch (error) {
-            logger.error('AI CAPTCHA detection failed', error);
-            return {
-                detected: false,
-                confidence: 0,
-                reasoning: `AI detection error: ${error instanceof Error ? error.message : String(error)}`,
-            };
-        }
-    }
-    async getPageInfo(page) {
-        const url = page.url();
-        const title = await page.title();
-        const info = await page.evaluate(() => {
-            const bodyText = document.body.innerText.substring(0, 1000);
-            const hasIframes = document.querySelectorAll('iframe').length > 0;
-            const suspiciousElements = [];
-            const captchaSelectors = [
-                '[class*="captcha"]',
-                '[id*="captcha"]',
-                '[class*="verify"]',
-                '[id*="verify"]',
-                '[class*="challenge"]',
-                'iframe[src*="recaptcha"]',
-                'iframe[src*="hcaptcha"]',
-                '.geetest_holder',
-                '#nc_1_wrapper',
-            ];
-            for (const selector of captchaSelectors) {
-                const elements = document.querySelectorAll(selector);
-                if (elements.length > 0) {
-                    suspiciousElements.push(`${selector} (${elements.length})`);
-                }
-            }
-            return {
-                bodyText,
-                hasIframes,
-                suspiciousElements,
-            };
-        });
-        return {
-            url,
-            title,
-            ...info,
-        };
-    }
-    async analyzeWithAI(screenshot, pageInfo) {
-        const prompt = this.buildAnalysisPrompt(pageInfo);
-        try {
-            logger.info('Starting AI captcha analysis...');
-            const response = await this.llm.analyzeImage(screenshot, prompt);
-            logger.info('AI analysis completed. Parsing response...');
-            return this.parseAIResponse(response, '');
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            const visionUnsupported = errorMessage.includes('does not support image analysis');
-            if (visionUnsupported) {
-                if (!this.hasLoggedVisionFallback) {
-                    logger.warn('Configured model does not support vision. Falling back to external analysis guidance.');
-                    this.hasLoggedVisionFallback = true;
-                }
-                const screenshotPath = await this.saveScreenshot(screenshot);
-                return {
-                    detected: false,
-                    type: 'none',
-                    confidence: 0,
-                    reasoning: 'The configured MCP model does not support image analysis and requires external AI assistance.\n\n' +
-                        'A screenshot has been saved (see screenshotPath).\n' +
-                        'The analysis prompt is included below.\n\n' +
-                        'Use a vision-capable model (for example GPT-4o or Claude 3) to analyze the screenshot and determine whether a captcha is present.\n\n' +
-                        '---\n\n' +
-                        `${prompt}\n\n` +
-                        '---\n\n' +
-                        'Review the file at screenshotPath with the prompt above.',
-                    screenshotPath,
-                    vendor: 'external-ai-required',
-                    suggestions: [
-                        `Use a vision-capable model to analyze the screenshot: ${screenshotPath}`,
-                        'Reuse the prompt embedded in the reasoning field',
-                        'After analysis, manually decide whether captcha handling is required',
-                        'Or configure MCP with a vision-capable model (for example gpt-4o or claude-3-opus)',
-                    ],
-                };
-            }
-            logger.error('AI captcha analysis failed:', errorMessage);
-            logger.info('Falling back to rule-based captcha detection');
-            return this.fallbackTextAnalysis(pageInfo);
-        }
-    }
-    buildAnalysisPrompt(pageInfo) {
-        const promptPayload = {
-            url: pageInfo.url,
-            title: pageInfo.title,
-            hasIframes: pageInfo.hasIframes,
-            suspiciousElements: pageInfo.suspiciousElements,
-            bodyTextPreview: `${pageInfo.bodyText.substring(0, 200)}...`,
-        };
-        return `# 
-
-## 
-，（CAPTCHA），。
-
-## 
-\`\`\`json
-${JSON.stringify(promptPayload, null, 2)}
-\`\`\`
-
-## 
-
-### 1. （Interactive CAPTCHA）
-**1.1 （Slider CAPTCHA）**
-- ****: 、
-- ****: (Geetest)、、、
-- ****: 、、""
-- **DOM**: \`.geetest_slider\`, \`.nc_1_wrapper\`, \`.tcaptcha-transform\`
-
-**1.2 （Image CAPTCHA）**
-- ****: （""）
-- ****: reCAPTCHA v2、hCaptcha
-- ****: 3x34x4、
-- **DOM**: \`iframe[src*="recaptcha"]\`, \`.h-captcha\`
-
-**1.3 （Text CAPTCHA）**
-- ****: /
-- ****: 、
-- ****: ""
-
-### 2. （Automatic CAPTCHA）
-**2.1 reCAPTCHA v3**
-- ****: ，reCAPTCHA
-- ****: "Protected by reCAPTCHA" 
-
-**2.2 Cloudflare Turnstile**
-- ****: "" / "Checking your browser"
-- ****: Cloudflare logo、、Ray ID
-
-### 3. （False Positives - ）
-**3.1 **
--  、、
--  ""（）
--  ""（）
-
-**3.2 **
--  、
--  、
--  
-
-**3.3 UI**
--  Range slider、Progress bar
--  Carousel、Swiper
--  、
-
-## 
-
-### Step 1: 
-1. ：
-   -  + 
-   -  + 
-   - ""
-   - ""
-   - Cloudflare/reCAPTCHA logo
-
-### Step 2: 
-1. URL：
-   - \`/captcha\`, \`/challenge\`, \`/verify\`
-   - \`cdn-cgi/challenge\` (Cloudflare)
-   - \`recaptcha.net\`, \`hcaptcha.com\`
-
-2. ：
-   - ""、""、""
-   - "Verify", "Challenge", "Security Check"
-
-3. ：
-   - suspiciousElements → 
-   -  → 
-
-### Step 3: 
-1. ：
-   - ""、""
-   - ，
-   - →  \`detected: false\`
-
-2. /UI：
-   - 、、
-   - →  \`detected: false\`
-
-### Step 4: 
-- **90-100%**:  + DOM
-- **70-89%**: ，DOM
-- **50-69%**: ，
-- **0-49%**: 
-
-## 
-
-**JSON Schema**:
-
-\`\`\`json
-{
-  "detected": boolean,
-  "type": "slider" | "image" | "recaptcha" | "hcaptcha" | "cloudflare" | "text_input" | "none",
-  "confidence": number,
-  "reasoning": string,
-  "location": {
-    "x": number,
-    "y": number,
-    "width": number,
-    "height": number
-  } | null,
-  "vendor": "geetest" | "tencent" | "aliyun" | "recaptcha" | "hcaptcha" | "cloudflare" | "unknown",
-  "suggestions": string[]
-}
-\`\`\`
-
-### 
-- **detected**: （）
-- **type**: （）
-- **confidence**: （0-100）
-- **reasoning**: （200，）
-- **location**: （，null）
-- **vendor**: （"unknown"）
-- **suggestions**: （，2-3）
-
-### 
-
-**1: **
-\`\`\`json
-{
-  "detected": true,
-  "type": "slider",
-  "confidence": 95,
-  "reasoning": "：1) ；2) ''；3) DOM.geetest_slider。。",
-  "location": {
-    "x": 450,
-    "y": 300,
-    "width": 320,
-    "height": 180
-  },
-  "vendor": "geetest",
-  "suggestions": [
-    "",
-    "captcha_wait",
-    "，"
-  ]
-}
-\`\`\`
-
-**2:  - **
-\`\`\`json
-{
-  "detected": false,
-  "type": "none",
-  "confidence": 95,
-  "reasoning": "''''，，。，。",
-  "location": null,
-  "vendor": "unknown",
-  "suggestions": [
-    "，",
-    ""
-  ]
-}
-\`\`\`
-
-**3: **
-\`\`\`json
-{
-  "detected": false,
-  "type": "none",
-  "confidence": 98,
-  "reasoning": "，、。，suspiciousElements，URL。",
-  "location": null,
-  "vendor": "unknown",
-  "suggestions": [
-    "，",
-    ""
-  ]
-}
-\`\`\`
-
-## 
-
-1. ****:  \`detected: false\`，
-2. ****:  > DOM > 
-3. ****: URL、、DOM、
-4. ****: reasoning
-5. ****: suggestions
-
-，JSON。`;
-    }
-    parseAIResponse(response, screenshotPath) {
-        try {
-            const jsonMatch = response.match(/```json\s*([\s\S]*?)\s*```/) || response.match(/\{[\s\S]*\}/);
-            if (!jsonMatch) {
-                throw new Error('AIJSON');
-            }
-            const jsonStr = jsonMatch[1] || jsonMatch[0];
-            const result = JSON.parse(jsonStr);
-            return {
-                detected: result.detected || false,
-                type: result.type || 'none',
-                confidence: result.confidence || 0,
-                reasoning: result.reasoning || '',
-                location: result.location,
-                vendor: result.vendor,
-                suggestions: result.suggestions || [],
-                screenshotPath: screenshotPath || undefined,
-            };
-        }
-        catch (error) {
-            logger.error('Failed to parse AI CAPTCHA response', error);
-            const detected = response.toLowerCase().includes('detected') && response.toLowerCase().includes('true');
-            return {
-                detected,
-                confidence: detected ? 50 : 80,
-                reasoning: `AI parse failed, raw response: ${response.substring(0, 200)}`,
-                screenshotPath: screenshotPath || undefined,
-            };
-        }
-    }
-    fallbackTextAnalysis(pageInfo) {
-        logger.warn('Using fallback keyword-based CAPTCHA detection');
-        const hasCaptchaElements = pageInfo.suspiciousElements.length > 0;
-        const hasCaptchaKeywords = pageInfo.title.toLowerCase().includes('captcha') ||
-            pageInfo.title.toLowerCase().includes('verify') ||
-            pageInfo.bodyText.toLowerCase().includes('captcha') ||
-            pageInfo.bodyText.toLowerCase().includes('verification');
-        const detected = hasCaptchaElements && hasCaptchaKeywords;
-        return {
-            detected,
-            confidence: detected ? 60 : 90,
-            reasoning: detected
-                ? 'Fallback heuristics matched both suspicious elements and CAPTCHA keywords.'
-                : 'Fallback heuristics did not find strong CAPTCHA signals.',
-            suggestions: detected
-                ? ['Switch to headed mode if needed', 'Wait for manual completion before continuing']
-                : ['Solve the CAPTCHA manually if one is visible'],
-        };
-    }
-    async waitForCompletion(page, timeout = 300000) {
-        logger.info('Waiting for CAPTCHA to be solved...');
-        const startTime = Date.now();
-        while (Date.now() - startTime < timeout) {
-            const result = await this.detect(page);
-            if (!result.detected || result.confidence < 50) {
-                logger.info('CAPTCHA is no longer detected; continuing workflow');
-                return true;
-            }
-            await new Promise((resolve) => setTimeout(resolve, 3000));
-        }
-        logger.error('Timed out while waiting for CAPTCHA completion');
-        return false;
-    }
-}

package/dist/modules/captcha/CaptchaDetector.constants.d.ts

@@ -1,19 +0,0 @@
-export declare const EXCLUDE_SELECTORS: string[];
-export declare const CAPTCHA_SELECTORS: {
-    slider: string[];
-    image: string[];
-    recaptcha: string[];
-    hcaptcha: string[];
-    cloudflare: string[];
-    generic: string[];
-};
-export declare const CAPTCHA_KEYWORDS: {
-    title: string[];
-    url: string[];
-    text: string[];
-};
-export declare const EXCLUDE_KEYWORDS: {
-    title: string[];
-    url: string[];
-    text: string[];
-};

package/dist/modules/captcha/CaptchaDetector.constants.js

@@ -1,164 +0,0 @@
-export const EXCLUDE_SELECTORS = [
-    '[class*="video"]',
-    '[class*="player"]',
-    '[id*="video"]',
-    '[id*="player"]',
-    '[class*="swiper"]',
-    '[class*="carousel"]',
-    '[class*="banner"]',
-    '[class*="gallery"]',
-    '[class*="douyin"]',
-    '[class*="tiktok"]',
-    '[class*="scroll"]',
-    '[class*="scrollbar"]',
-    '[class*="progress"]',
-    '[class*="range"]',
-    '[class*="volume"]',
-];
-export const CAPTCHA_SELECTORS = {
-    slider: [
-        '.captcha-slider',
-        '.verify-slider',
-        '#captcha-slider',
-        '.slide-verify',
-        '#nc_1_wrapper',
-        '.nc-container',
-        '.geetest_slider',
-        '.geetest_holder',
-        '.tcaptcha-transform',
-        '.JDJRV-slide-inner',
-        '.yidun_slider',
-        '[class*="captcha"][class*="slider"]',
-        '[class*="verify"][class*="slider"]',
-        '[id*="captcha"][id*="slider"]',
-        '[id*="verify"][id*="slider"]',
-    ],
-    image: [
-        '[class*="captcha-image"]',
-        '[id*="captcha-image"]',
-        '.verify-img',
-        '.captcha-img',
-        'img[src*="captcha"]',
-        'img[alt*=""]',
-        'img[alt*="captcha"]',
-    ],
-    recaptcha: [
-        'iframe[src*="recaptcha"]',
-        '.g-recaptcha',
-        '#g-recaptcha',
-        '[class*="recaptcha"]',
-        'iframe[title*="reCAPTCHA"]',
-    ],
-    hcaptcha: [
-        'iframe[src*="hcaptcha"]',
-        '.h-captcha',
-        '#h-captcha',
-        '[class*="hcaptcha"]',
-        'iframe[title*="hCaptcha"]',
-    ],
-    cloudflare: [
-        '#challenge-form',
-        '.cf-challenge',
-        '[id*="cf-challenge"]',
-        'iframe[src*="challenges.cloudflare.com"]',
-        '#cf-wrapper',
-        '.ray-id',
-    ],
-    generic: [
-        '[class*="captcha"]',
-        '[id*="captcha"]',
-        '[class*="verify"]',
-        '[id*="verify"]',
-        '[class*="challenge"]',
-        '[id*="challenge"]',
-        'iframe[src*="captcha"]',
-        'iframe[src*="verify"]',
-    ],
-};
-export const CAPTCHA_KEYWORDS = {
-    title: [
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        'captcha',
-        'challenge',
-        'verify',
-        'verification',
-        'robot',
-        'human',
-        'security check',
-        'bot check',
-        'anti-bot',
-        'cloudflare',
-        'geetest',
-        'recaptcha',
-        'hcaptcha',
-        'turnstile',
-    ],
-    url: [
-        'captcha',
-        'challenge',
-        'verify',
-        'verification',
-        'robot-check',
-        'security-check',
-        'bot-check',
-        'cdn-cgi/challenge',
-        'cloudflare',
-        'akamai',
-        'geetest',
-        'recaptcha',
-        'hcaptcha',
-        'turnstile',
-        'datadome',
-        'perimeter',
-        'px-captcha',
-    ],
-    text: [
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        '',
-        'Please verify',
-        'Verify you are human',
-        'Complete the security check',
-        'Slide to verify',
-        'Click to verify',
-        'Drag the slider',
-        'Prove you are human',
-        'I am not a robot',
-        'Checking your browser',
-        'Just a moment',
-        'Checking if the site connection is secure',
-        'This process is automatic',
-        'Protected by',
-        'Powered by',
-    ],
-};
-export const EXCLUDE_KEYWORDS = {
-    title: ['', '', '', '', '', '', '', 'verification code', 'enter code', 'sms code'],
-    url: [
-        'verify-email',
-        'verify-phone',
-        'email-verification',
-        'account-verification',
-        'verify-account',
-    ],
-    text: ['', '', '', '', '', 'Enter verification code', 'Get code', 'Send code'],
-};

package/dist/modules/captcha/CaptchaDetector.d.ts

@@ -1,27 +0,0 @@
-import { Page } from 'rebrowser-puppeteer-core';
-export interface CaptchaDetectionResult {
-    detected: boolean;
-    type?: 'slider' | 'image' | 'recaptcha' | 'hcaptcha' | 'cloudflare' | 'page_redirect' | 'url_redirect' | 'unknown';
-    selector?: string;
-    title?: string;
-    url?: string;
-    confidence: number;
-    vendor?: 'geetest' | 'tencent' | 'aliyun' | 'cloudflare' | 'akamai' | 'datadome' | 'perimeter-x' | 'recaptcha' | 'hcaptcha' | 'unknown';
-    details?: unknown;
-    falsePositiveReason?: string;
-}
-export declare class CaptchaDetector {
-    private static readonly EXCLUDE_SELECTORS;
-    private static readonly CAPTCHA_SELECTORS;
-    private static readonly CAPTCHA_KEYWORDS;
-    private static readonly EXCLUDE_KEYWORDS;
-    detect(page: Page): Promise<CaptchaDetectionResult>;
-    private checkUrl;
-    private checkTitle;
-    private checkDOMElements;
-    private checkPageText;
-    private checkVendorSpecific;
-    waitForCompletion(page: Page, timeout?: number): Promise<boolean>;
-    private verifyByDOM;
-    private verifySliderElement;
-}