@serpstat/serpstat-mcp-server 1.0.8 → 1.1.0

package/dist/handlers/site_audit_tools.js

@@ -0,0 +1,767 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetSubElementsByCrcHandler = exports.GetErrorElementsHandler = exports.GetReportWithoutDetailsHandler = exports.GetBasicInfoHandler = exports.GetDefaultSettingsHandler = exports.GetScanUserUrlListHandler = exports.GetSiteAuditsListHandler = exports.GetHistoryByCountErrorHandler = exports.GetCategoriesStatisticHandler = exports.StopSiteAuditHandler = exports.StartSiteAuditHandler = exports.SetSiteAuditSettingsHandler = exports.GetSiteAuditSettingsHandler = void 0;
+const base_js_1 = require("./base.js");
+const site_audit_js_1 = require("../services/site_audit.js");
+const validation_js_1 = require("../utils/validation.js");
+const config_js_1 = require("../utils/config.js");
+const constants_js_1 = require("../utils/constants.js");
+class GetSiteAuditSettingsHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'get_site_audit_settings';
+    }
+    getDescription() {
+        return 'Get current configuration of EXISTING audit project. Returns: mainSettings (domain, name, pagesLimit, scanSpeed, scanDuration, userAgent, robotsTxt, etc), scan filters (keywords to include/exclude), authentication, email notifications, scheduling, error thresholds. Compare with get_site_audit_project_default_settings which returns template for NEW projects. Does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_PROJECT_ID,
+                    description: 'Project ID to get settings for'
+                }
+            },
+            required: ['projectId']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getSiteAuditSettingsSchema.parse(call.arguments);
+            const result = await this.siteAuditService.getSettings(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetSiteAuditSettingsHandler = GetSiteAuditSettingsHandler;
+class SetSiteAuditSettingsHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'set_site_audit_settings';
+    }
+    getDescription() {
+        return 'Update or create audit project configuration. Use get_site_audit_project_default_settings to get template, then modify and save with this method. Required fields: mainSettings (domain, name, subdomainsCheck, pagesLimit, scanSpeed, etc), scanSetting (type: 1=all site, 2=URL list, 3=sitemap), scheduleSettings, mailTriggerSettings, baseAuthBlock, keyword filters. Does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_PROJECT_ID,
+                    description: 'Project ID to update settings for'
+                },
+                mainSettings: {
+                    type: 'object',
+                    properties: {
+                        domain: {
+                            type: 'string',
+                            minLength: constants_js_1.MIN_DOMAIN_LENGTH,
+                            maxLength: constants_js_1.MAX_DOMAIN_LENGTH,
+                            description: 'Project domain'
+                        },
+                        name: {
+                            type: 'string',
+                            minLength: constants_js_1.MIN_DOMAIN_LENGTH,
+                            description: 'Project name'
+                        },
+                        subdomainsCheck: {
+                            type: 'boolean',
+                            description: 'Check domain with subdomains'
+                        },
+                        pagesLimit: {
+                            type: 'integer',
+                            minimum: constants_js_1.MIN_PAGES_LIMIT,
+                            description: 'Scan pages limit'
+                        },
+                        scanSpeed: {
+                            type: 'integer',
+                            minimum: constants_js_1.MIN_SCAN_SPEED,
+                            maximum: constants_js_1.MAX_SCAN_SPEED,
+                            description: 'Scan speed (1-30, every increment of 3 adds one thread)'
+                        },
+                        autoSpeed: {
+                            type: 'boolean',
+                            description: 'Auto speed control'
+                        },
+                        scanNoIndex: {
+                            type: 'boolean',
+                            description: 'Scan NoIndex pages'
+                        },
+                        autoUserAgent: {
+                            type: 'boolean',
+                            description: 'Automatic change of user agent'
+                        },
+                        scanWrongCanonical: {
+                            type: 'boolean',
+                            description: 'Scan wrong Canonical pages'
+                        },
+                        scanDuration: {
+                            type: 'integer',
+                            minimum: constants_js_1.MIN_SCAN_DURATION,
+                            description: 'Scan duration in hours'
+                        },
+                        folderDepth: {
+                            type: 'integer',
+                            minimum: constants_js_1.MIN_FOLDER_DEPTH,
+                            description: 'Maximum folders in URL path'
+                        },
+                        urlDepth: {
+                            type: 'integer',
+                            minimum: constants_js_1.MIN_URL_DEPTH,
+                            description: 'Maximum clicks from main page'
+                        },
+                        userAgent: {
+                            type: 'integer',
+                            enum: constants_js_1.SITE_AUDIT_USER_AGENT_IDS,
+                            description: 'User agent ID (0=Chrome, 1=Serpstat, 2=Google, 3=Yandex, 4=Firefox, 5=IE)'
+                        },
+                        robotsTxt: {
+                            type: 'boolean',
+                            description: 'Verify robots.txt compliance'
+                        },
+                        withImages: {
+                            type: 'boolean',
+                            description: 'Scan images'
+                        }
+                    },
+                    required: ['domain', 'name', 'subdomainsCheck', 'pagesLimit', 'scanSpeed', 'autoSpeed', 'scanNoIndex', 'autoUserAgent', 'scanWrongCanonical', 'scanDuration', 'folderDepth', 'urlDepth', 'userAgent', 'robotsTxt', 'withImages']
+                },
+                dontScanKeywordsBlock: {
+                    type: 'object',
+                    properties: {
+                        checked: { type: 'boolean', description: 'Apply exclusion rule' },
+                        keywords: { type: 'string', description: 'Keywords to exclude (comma-separated)' }
+                    },
+                    required: ['checked', 'keywords'],
+                    description: 'Exclude pages with these keywords in URL'
+                },
+                onlyScanKeywordsBlock: {
+                    type: 'object',
+                    properties: {
+                        checked: { type: 'boolean', description: 'Apply inclusion rule' },
+                        keywords: { type: 'string', description: 'Keywords to include (comma-separated)' }
+                    },
+                    required: ['checked', 'keywords'],
+                    description: 'Only scan pages with these keywords in URL'
+                },
+                baseAuthBlock: {
+                    type: 'object',
+                    properties: {
+                        login: { type: 'string', description: 'HTTP Basic auth login' },
+                        password: { type: 'string', description: 'HTTP Basic auth password' }
+                    },
+                    required: ['login', 'password'],
+                    description: 'HTTP Basic authentication credentials'
+                },
+                mailTriggerSettings: {
+                    type: 'object',
+                    properties: {
+                        emails: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Email addresses for notifications'
+                        },
+                        interval: {
+                            type: 'integer',
+                            enum: constants_js_1.SITE_AUDIT_INTERVAL_IDS,
+                            description: 'Notification interval (0=manual, 1=daily, 2=every 3 days, 3=weekly, 4=every 2 weeks, 5=monthly)'
+                        },
+                        enabled: { type: 'boolean', description: 'Enable email notifications' }
+                    },
+                    required: ['emails', 'interval', 'enabled'],
+                    description: 'Email notification settings'
+                },
+                scheduleSettings: {
+                    type: 'object',
+                    properties: {
+                        scheduleRepeatOption: {
+                            type: 'integer',
+                            enum: constants_js_1.SITE_AUDIT_SCHEDULE_REPEAT_IDS,
+                            description: 'Scan schedule (0=manual, 1=daily, 2=every 3 days, 3=weekly, 4=every 2 weeks, 5=monthly)'
+                        }
+                    },
+                    required: ['scheduleRepeatOption'],
+                    description: 'Scan scheduling settings'
+                },
+                scanSetting: {
+                    type: 'object',
+                    properties: {
+                        type: {
+                            type: 'integer',
+                            enum: constants_js_1.SITE_AUDIT_SCAN_TYPES,
+                            description: 'Scan type (1=all site, 2=URL list, 3=sitemap list)'
+                        },
+                        list: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'URLs to scan (for types 2 and 3)'
+                        },
+                        importedFilename: {
+                            type: 'string',
+                            description: 'Imported filename (optional)'
+                        }
+                    },
+                    required: ['type', 'list'],
+                    description: 'Scan type and URL list settings'
+                },
+                errorsSettings: {
+                    type: 'object',
+                    properties: {
+                        tiny_title: { type: 'integer', minimum: constants_js_1.MIN_TITLE_LENGTH, description: 'Min title length' },
+                        long_title: { type: 'integer', minimum: constants_js_1.MIN_TITLE_LENGTH, description: 'Max title length' },
+                        tiny_desc: { type: 'integer', minimum: constants_js_1.MIN_DESC_LENGTH, description: 'Min description length' },
+                        long_desc: { type: 'integer', minimum: constants_js_1.MIN_DESC_LENGTH, description: 'Max description length' },
+                        long_url: { type: 'integer', minimum: constants_js_1.MIN_URL_LENGTH, description: 'Max URL length' },
+                        large_image_size: { type: 'integer', minimum: constants_js_1.MIN_IMAGE_SIZE, description: 'Max image size (KB)' },
+                        large_page_size: { type: 'integer', minimum: constants_js_1.MIN_PAGE_SIZE, description: 'Max page size (MB)' },
+                        many_external_links: { type: 'integer', minimum: constants_js_1.MIN_EXTERNAL_LINKS, description: 'Max external links' }
+                    },
+                    description: 'Error detection thresholds (optional)'
+                }
+            },
+            required: ['projectId', 'mainSettings', 'dontScanKeywordsBlock', 'onlyScanKeywordsBlock', 'baseAuthBlock', 'mailTriggerSettings', 'scheduleSettings', 'scanSetting']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.setSiteAuditSettingsSchema.parse(call.arguments);
+            const result = await this.siteAuditService.setSettings(params);
+            return this.createSuccessResponse({ success: true, result });
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.SetSiteAuditSettingsHandler = SetSiteAuditSettingsHandler;
+class StartSiteAuditHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'start_site_audit';
+    }
+    getDescription() {
+        return 'Launch audit scan for a project. Returns reportId to track progress. Check completion with get_site_audits_list (progress field). API COST: 1 credit per page without JS rendering, 10 credits per page with JS rendering (scanJsPage setting). Wait for progress=100 before analyzing results.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_PROJECT_ID,
+                    description: 'Project ID to start audit for'
+                }
+            },
+            required: ['projectId']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.startSiteAuditSchema.parse(call.arguments);
+            const result = await this.siteAuditService.start(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.StartSiteAuditHandler = StartSiteAuditHandler;
+class StopSiteAuditHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'stop_site_audit';
+    }
+    getDescription() {
+        return 'Stop active audit scan for a project. Partial results may be available. Check get_site_audits_list to see if audit was stopped (stoped field).';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_PROJECT_ID,
+                    description: 'Project ID to stop audit for'
+                }
+            },
+            required: ['projectId']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.stopSiteAuditSchema.parse(call.arguments);
+            const result = await this.siteAuditService.stop(params);
+            return this.createSuccessResponse({ success: result });
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.StopSiteAuditHandler = StopSiteAuditHandler;
+class GetCategoriesStatisticHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'get_site_audit_results_by_categories';
+    }
+    getDescription() {
+        return 'Get AGGREGATED error statistics by category. Returns sum of errors grouped by priority for each category. Each category shows: highCount, mediumCount, lowCount, informationCount. Use this for quick overview to identify problematic categories. Categories are fixed: pages_status, meta_tags, headings, content, multimedia, indexation, redirects, links, server_params, https, hreflang, amp, markup, pagespeed_desktop, pagespeed_mobile. Does not consume API credits. For specific error breakdown use get_site_audit_deteailed_report.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                reportId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_REPORT_ID,
+                    description: 'Audit report ID to get statistics for'
+                }
+            },
+            required: ['reportId']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getCategoriesStatisticSchema.parse(call.arguments);
+            const result = await this.siteAuditService.getCategoriesStatistic(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetCategoriesStatisticHandler = GetCategoriesStatisticHandler;
+class GetHistoryByCountErrorHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'get_site_audit_history';
+    }
+    getDescription() {
+        return 'Track how a SPECIFIC error type changed over time across all audits in project. Returns array with reportId, date, and count for each audit. Use this to: verify if fixes are working (count should decrease), monitor if errors are growing, track specific problem areas. The errorName must be from the fixed enum list (same as error.key from get_site_audit_deteailed_report). Example: errorName=\'no_desc\' shows trend of pages without meta description. Does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_PROJECT_ID,
+                    description: 'Project ID to get error history for'
+                },
+                errorName: {
+                    type: 'string',
+                    enum: constants_js_1.SITE_AUDIT_ERROR_NAMES,
+                    description: 'Error type name (e.g., h1_missing, no_desc, long_title)'
+                },
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    default: constants_js_1.DEFAULT_AUDIT_LIMIT,
+                    description: 'Number of history items to return'
+                },
+                offset: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_AUDIT_OFFSET,
+                    default: constants_js_1.MIN_AUDIT_OFFSET,
+                    description: 'Offset for pagination'
+                }
+            },
+            required: ['projectId', 'errorName']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getHistoryByCountErrorSchema.parse(call.arguments);
+            const result = await this.siteAuditService.getHistoryByCountError(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetHistoryByCountErrorHandler = GetHistoryByCountErrorHandler;
+class GetSiteAuditsListHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'get_site_audits_list';
+    }
+    getDescription() {
+        return 'STARTING POINT for audit analysis. Returns list of all audit reports for a project. Use reportId from response with other audit methods. Returns: reportId (use with other methods), date, SDO score (0-100), pages scanned/limit, critical/non-critical issue counts, viruses, progress (0-100), completion status, hasDetailData flag (true=full data available, false=in progress/failed). Does not consume API credits. TIP: Sort by date to get most recent audit first.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_PROJECT_ID,
+                    description: 'Project ID to get audits list for'
+                },
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    default: constants_js_1.DEFAULT_AUDIT_LIMIT,
+                    description: 'Number of audits to return'
+                },
+                offset: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_AUDIT_OFFSET,
+                    default: constants_js_1.MIN_AUDIT_OFFSET,
+                    description: 'Offset for pagination'
+                }
+            },
+            required: ['projectId']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getSiteAuditsListSchema.parse(call.arguments);
+            const result = await this.siteAuditService.getSiteAuditsList(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetSiteAuditsListHandler = GetSiteAuditsListHandler;
+class GetScanUserUrlListHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'get_site_audit_scanned_urls_list';
+    }
+    getDescription() {
+        return 'Get CONFIGURED URL list for scanning (not actual scan results). ONLY works when scanSetting.type is 2 (URL list) or 3 (sitemap list). Returns error \'Scan url list not found\' when type=1 (scan all site) because no specific URLs are configured. This shows INPUT configuration, not OUTPUT of what was scanned. Check get_site_audits_list response for actual scanned page count. Does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_PROJECT_ID,
+                    description: 'Project ID to get scanned URLs list for'
+                }
+            },
+            required: ['projectId']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getScanUserUrlListSchema.parse(call.arguments);
+            const result = await this.siteAuditService.getScanUserUrlList(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetScanUserUrlListHandler = GetScanUserUrlListHandler;
+class GetDefaultSettingsHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'get_site_audit_project_default_settings';
+    }
+    getDescription() {
+        return 'Get DEFAULT TEMPLATE settings for creating new projects (NOT settings of existing project). Returns server-side recommended defaults. Use this to: populate new project form with sensible defaults, avoid hardcoding values, ensure settings stay current if Serpstat changes recommendations. Workflow: 1) Call this method, 2) Modify returned object (set domain, name, adjust limits), 3) Call set_site_audit_settings to save. Key differences from project settings: domain=\'\' (must set), name=\'\' (must set), pagesLimit=5000 (default), scheduleRepeatOption=3 (weekly). Does not consume API credits and does not require projectId.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {},
+            required: []
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getDefaultSettingsSchema.parse(call.arguments);
+            const result = await this.siteAuditService.getDefaultSettings(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetDefaultSettingsHandler = GetDefaultSettingsHandler;
+class GetBasicInfoHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'get_site_audit_bref_info';
+    }
+    getDescription() {
+        return 'Get quick summary of a single audit for dashboard display. Returns: sdo (0-100 score), highCount/mediumCount/lowCount/informationCount (errors by priority), checkedPageCount (pages scanned), progress (0-100), stoped flag, captchaDetected flag, redirectCount. Lightweight method, does not consume API credits. For detailed analysis use get_site_audit_results_by_categories or get_site_audit_deteailed_report.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                reportId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_REPORT_ID,
+                    description: 'The unique identifier for an audit report'
+                }
+            },
+            required: ['reportId']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getBasicInfoSchema.parse(call.arguments);
+            const result = await this.siteAuditService.getBasicInfo(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetBasicInfoHandler = GetBasicInfoHandler;
+class GetReportWithoutDetailsHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'get_site_audit_deteailed_report';
+    }
+    getDescription() {
+        return 'Get COMPLETE error breakdown organized by categories. Main method for detailed audit analysis. Returns categories array, each with errors array containing: key (error identifier like \'no_desc\', \'h1_missing\'), priority (high/medium/low/information), countAll (total errors), countNew (new vs compareReportId), countFixed (fixed vs compareReportId). Use compareReportId parameter to track changes between audits. Use error.key with get_site_audit_history (track across all audits) or get_site_audit_pages_spec_errors (see affected pages). Does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                reportId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_REPORT_ID,
+                    description: 'The unique identifier for an audit report'
+                },
+                compareReportId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_REPORT_ID,
+                    description: 'Another unique identifier for an audit report from the same project to compare'
+                }
+            },
+            required: ['reportId']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getReportWithoutDetailsSchema.parse(call.arguments);
+            const result = await this.siteAuditService.getReportWithoutDetails(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetReportWithoutDetailsHandler = GetReportWithoutDetailsHandler;
+class GetErrorElementsHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'get_site_audit_pages_spec_errors';
+    }
+    getDescription() {
+        return 'DRILL-DOWN STEP 1: Get list of elements (pages/images) with specific error. Returns: url (problematic page or image URL), urlCrc/imageCrc (unique numeric ID for drill-down), count (occurrences). The CRC is used with get_site_audit_elements_with_issues for deeper analysis. Mode parameter: \'all\' (all errors), \'new\' (new vs compareReportId), \'solved\' (fixed vs compareReportId). Example flow: get pages with \'image_no_alt\' error → get imageCrc → use with get_site_audit_elements_with_issues to see which pages use that image. Does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                reportId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_REPORT_ID,
+                    description: 'The unique identifier for an audit report'
+                },
+                compareReportId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_REPORT_ID,
+                    description: 'Another unique identifier for an audit report from the same project to compare'
+                },
+                projectId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_PROJECT_ID,
+                    description: 'The unique identifier for an audit site project'
+                },
+                errorName: {
+                    type: 'string',
+                    description: 'Error name to filter by'
+                },
+                mode: {
+                    type: 'string',
+                    enum: [...constants_js_1.SITE_AUDIT_ERROR_DISPLAY_MODES],
+                    default: 'all',
+                    description: 'Error display mode: all (all errors), new (new errors), solved (fixed errors)'
+                },
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    default: constants_js_1.DEFAULT_ERROR_ELEMENTS_LIMIT,
+                    description: 'Count of returned items in response'
+                },
+                offset: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_AUDIT_OFFSET,
+                    default: constants_js_1.MIN_AUDIT_OFFSET,
+                    description: 'Batch number required for pagination'
+                }
+            },
+            required: ['reportId', 'compareReportId', 'projectId', 'errorName']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getErrorElementsSchema.parse(call.arguments);
+            const result = await this.siteAuditService.getErrorElements(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetErrorElementsHandler = GetErrorElementsHandler;
+class GetSubElementsByCrcHandler extends base_js_1.BaseHandler {
+    siteAuditService;
+    constructor() {
+        super();
+        const config = (0, config_js_1.loadConfig)();
+        this.siteAuditService = new site_audit_js_1.SiteAuditService(config);
+    }
+    getName() {
+        return 'get_site_audit_elements_with_issues';
+    }
+    getDescription() {
+        return 'DRILL-DOWN STEP 2: Shows WHERE a problematic element is used. Use crc from get_site_audit_pages_spec_errors response. ONLY works for hierarchical errors (images, scripts, links). Does NOT work for page-level errors (no_desc, no_title, h1_missing) - returns \'Error don\'t have sub elements\'. Example: Step 1 finds image without alt (imageCrc=12345), Step 2 shows which pages use that image. The crc parameter must match urlCrc/imageCrc from previous method. Does not consume API credits.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                reportId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_REPORT_ID,
+                    description: 'The unique identifier for an audit report'
+                },
+                compareReportId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_REPORT_ID,
+                    description: 'Another unique identifier for an audit report from the same project to compare'
+                },
+                projectId: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_PROJECT_ID,
+                    description: 'The unique identifier for an audit site project'
+                },
+                errorName: {
+                    type: 'string',
+                    description: 'Error name to filter by'
+                },
+                mode: {
+                    type: 'string',
+                    enum: [...constants_js_1.SITE_AUDIT_ERROR_DISPLAY_MODES],
+                    default: 'all',
+                    description: 'Error display mode: all (all errors), new (new errors), solved (fixed errors)'
+                },
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    default: constants_js_1.DEFAULT_AUDIT_LIMIT,
+                    description: 'Count of returned items in response'
+                },
+                offset: {
+                    type: 'integer',
+                    minimum: constants_js_1.MIN_AUDIT_OFFSET,
+                    default: constants_js_1.MIN_AUDIT_OFFSET,
+                    description: 'Batch number required for pagination'
+                },
+                crc: {
+                    type: 'integer',
+                    description: 'URL CRC from get_site_audit_pages_spec_errors response'
+                }
+            },
+            required: ['reportId', 'projectId', 'errorName', 'crc']
+        };
+    }
+    async handle(call) {
+        try {
+            const params = validation_js_1.getSubElementsByCrcSchema.parse(call.arguments);
+            const result = await this.siteAuditService.getSubElementsByCrc(params);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            return this.createErrorResponse(error);
+        }
+    }
+}
+exports.GetSubElementsByCrcHandler = GetSubElementsByCrcHandler;
+//# sourceMappingURL=site_audit_tools.js.map