@reftrixmcp/mcp-server 0.1.7

package/dist/services/page/playwright-crawler.service.js

@@ -0,0 +1,373 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaywrightCrawlerService = exports.CrawlError = exports.InvalidProtocolError = exports.SSRFBlockedError = exports.DEFAULT_CRAWL_OPTIONS = void 0;
+exports.crawlPage = crawlPage;
+exports.closeSharedService = closeSharedService;
+const playwright_1 = require("playwright");
+const url_validator_1 = require("../../utils/url-validator");
+const logger_1 = require("../../utils/logger");
+const timeout_utils_1 = require("../../tools/page/handlers/timeout-utils");
+const core_1 = require("@reftrixmcp/core");
+/**
+ * デフォルトのクロールオプション
+ */
+exports.DEFAULT_CRAWL_OPTIONS = {
+    timeout: 30000,
+    // WebGL/3Dサイト対応: domcontentloadedをデフォルトに（loadは3Dサイトで非常に時間がかかる）
+    waitUntil: "domcontentloaded",
+    viewport: { width: 1440, height: 900 },
+};
+// =====================================================
+// エラークラス
+// =====================================================
+/**
+ * SSRFブロックエラー
+ */
+class SSRFBlockedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SSRFBlockedError";
+    }
+}
+exports.SSRFBlockedError = SSRFBlockedError;
+/**
+ * プロトコルエラー
+ */
+class InvalidProtocolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidProtocolError";
+    }
+}
+exports.InvalidProtocolError = InvalidProtocolError;
+/**
+ * クロールエラー
+ */
+class CrawlError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.name = "CrawlError";
+        this.statusCode = statusCode;
+    }
+}
+exports.CrawlError = CrawlError;
+// =====================================================
+// ヘルパー関数
+// =====================================================
+/**
+ * URLのプロトコルを検証
+ */
+function validateProtocol(url) {
+    const allowedProtocols = ["http:", "https:"];
+    try {
+        const urlObj = new URL(url);
+        if (!allowedProtocols.includes(urlObj.protocol)) {
+            throw new InvalidProtocolError(`Invalid protocol: only http and https are allowed, got ${urlObj.protocol}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof InvalidProtocolError) {
+            throw error;
+        }
+        throw new CrawlError(`Invalid URL format: ${url}`);
+    }
+}
+/**
+ * URLのSSRF検証
+ */
+function validateUrlForSSRF(url) {
+    const result = (0, url_validator_1.validateExternalUrl)(url);
+    if (!result.valid) {
+        throw new SSRFBlockedError(result.error ?? "URL is blocked for security reasons");
+    }
+}
+/**
+ * HTMLからメタデータを抽出
+ */
+function extractMetadataFromHtml(html) {
+    const result = {};
+    // description
+    const descMatch = html.match(/<meta[^>]*name=["']description["'][^>]*content=["']([^"']*)["']/i);
+    if (!descMatch) {
+        // content が先に来るパターン
+        const descMatchAlt = html.match(/<meta[^>]*content=["']([^"']*)["'][^>]*name=["']description["']/i);
+        if (descMatchAlt && descMatchAlt[1]) {
+            result.description = descMatchAlt[1].trim();
+        }
+    }
+    else if (descMatch[1]) {
+        result.description = descMatch[1].trim();
+    }
+    return result;
+}
+// =====================================================
+// PlaywrightCrawlerService クラス
+// =====================================================
+/**
+ * Playwrightを使用したWebクローラーサービス
+ */
+class PlaywrightCrawlerService {
+    browser = null;
+    /**
+     * ブラウザを初期化（健全性チェック付き）
+     *
+     * Note: BullMQ Worker環境でシングルトンブラウザを使用する際、
+     * ブラウザがクローズ済みの場合にレースコンディションが発生するため、
+     * 健全性チェックを実施してクローズ済みの場合はリセットする。
+     */
+    async ensureBrowser() {
+        // 健全性チェック: 既存ブラウザがクローズ済みかどうか確認
+        if (this.browser) {
+            try {
+                // ブラウザが生きているか確認（contexts()がエラーを投げたらクローズ済み）
+                await this.browser.contexts();
+            }
+            catch (error) {
+                // ブラウザがクローズ済みの場合はリセット
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn("[PlaywrightCrawlerService] Browser was closed unexpectedly, resetting instance", {
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+                this.browser = null;
+            }
+        }
+        if (!this.browser) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.debug("[PlaywrightCrawlerService] Launching browser");
+            }
+            this.browser = await playwright_1.chromium.launch({
+                headless: true,
+                args: [
+                    "--no-sandbox",
+                    "--disable-setuid-sandbox",
+                    "--disable-dev-shm-usage",
+                    "--disable-gpu",
+                ],
+            });
+        }
+        return this.browser;
+    }
+    /**
+     * Webページをクロール
+     *
+     * @param url - クロールするURL
+     * @param options - クロールオプション
+     * @returns クロール結果
+     * @throws SSRFBlockedError - SSRF攻撃の可能性がある場合
+     * @throws InvalidProtocolError - 無効なプロトコルの場合
+     * @throws CrawlError - クロール中のエラー
+     */
+    async crawl(url, options = {}) {
+        const opts = { ...exports.DEFAULT_CRAWL_OPTIONS, ...options };
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.debug("[PlaywrightCrawlerService] crawl called", {
+                url,
+                timeout: opts.timeout,
+                waitUntil: opts.waitUntil,
+                viewport: opts.viewport,
+            });
+        }
+        // プロトコル検証
+        validateProtocol(url);
+        // SSRF検証
+        validateUrlForSSRF(url);
+        // robots.txt チェック（RFC 9309準拠）
+        const robotsResult = await (0, core_1.isUrlAllowedByRobotsTxt)(url, opts.respectRobotsTxt);
+        if (!robotsResult.allowed) {
+            throw new CrawlError(`Blocked by robots.txt: ${url} (domain: ${robotsResult.domain}, reason: ${robotsResult.reason}). ` +
+                `Use respect_robots_txt: false to override. ` +
+                `Note: Overriding robots.txt may have legal implications depending on jurisdiction (e.g., EU DSM Directive Article 4).`);
+        }
+        let context = null;
+        let page = null;
+        try {
+            const browser = await this.ensureBrowser();
+            // 新しいコンテキストを作成（分離のため）
+            context = await browser.newContext({
+                viewport: opts.viewport ?? null,
+                userAgent: core_1.ROBOTS_TXT.USER_AGENT,
+                // セキュリティ設定
+                javaScriptEnabled: true,
+                bypassCSP: false,
+            });
+            page = await context.newPage();
+            // ナビゲーション（WebGL/3Dサイト対応: domcontentloadedをデフォルトに）
+            const response = await page.goto(url, {
+                waitUntil: opts.waitUntil ?? "domcontentloaded",
+                timeout: opts.timeout ?? 30000,
+            });
+            // レスポンスステータスのチェック
+            if (response) {
+                const status = response.status();
+                if (status >= 400) {
+                    if (status === 404) {
+                        throw new CrawlError(`Page not found: 404 error for ${url}`, 404);
+                    }
+                    else if (status >= 500) {
+                        throw new CrawlError(`Server error: ${status} for ${url}`, status);
+                    }
+                    else {
+                        throw new CrawlError(`HTTP error: ${status} for ${url}`, status);
+                    }
+                }
+            }
+            // HTML取得（タイムアウト付き: 重いJSサイトでpage.content()が無限ハングする対策）
+            const operationTimeout = opts.timeout ?? 30000;
+            const html = await (0, timeout_utils_1.withTimeout)(page.content(), operationTimeout, "page.content()");
+            // タイトル取得
+            const title = await page.title();
+            // メタデータ抽出
+            const metadata = extractMetadataFromHtml(html);
+            // スクリーンショット取得（タイムアウト付き）
+            const screenshotBuffer = await (0, timeout_utils_1.withTimeout)(page.screenshot({
+                type: "png",
+                fullPage: false, // viewportサイズのみ
+            }), operationTimeout, "page.screenshot()");
+            const screenshot = screenshotBuffer.toString("base64");
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.debug("[PlaywrightCrawlerService] crawl completed", {
+                    url,
+                    htmlLength: html.length,
+                    hasTitle: !!title,
+                    hasDescription: !!metadata.description,
+                    screenshotSize: screenshot.length,
+                });
+            }
+            return {
+                html,
+                title: title || undefined,
+                description: metadata.description,
+                screenshot,
+            };
+        }
+        catch (error) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.error("[PlaywrightCrawlerService] crawl error", { url, error });
+            }
+            // ブラウザがクローズされたエラーの場合はインスタンスをリセット
+            // "Target page, context or browser has been closed" エラーに対応
+            if (error instanceof Error) {
+                const isBrowserClosedError = error.message.includes("has been closed") ||
+                    error.message.includes("Target closed") ||
+                    error.message.includes("browser has been closed") ||
+                    error.message.includes("context has been closed");
+                if (isBrowserClosedError) {
+                    if ((0, logger_1.isDevelopment)()) {
+                        logger_1.logger.warn("[PlaywrightCrawlerService] Browser closed error detected, resetting instance", {
+                            url,
+                            error: error.message,
+                        });
+                    }
+                    // ブラウザインスタンスをリセット（次回呼び出し時に再起動）
+                    this.browser = null;
+                    throw new CrawlError(`Browser was closed unexpectedly. Please retry: ${error.message}`);
+                }
+            }
+            // 既知のエラータイプは再スロー
+            if (error instanceof SSRFBlockedError ||
+                error instanceof InvalidProtocolError ||
+                error instanceof CrawlError) {
+                throw error;
+            }
+            // Playwrightのタイムアウトエラー
+            if (error instanceof Error) {
+                if (error.message.includes("Timeout") || error.message.includes("timeout")) {
+                    throw new CrawlError(`Timeout: page load exceeded ${opts.timeout}ms`);
+                }
+                // DNS/ネットワークエラー
+                if (error.message.includes("net::ERR_NAME_NOT_RESOLVED") ||
+                    error.message.includes("DNS") ||
+                    error.message.includes("ENOTFOUND")) {
+                    throw new CrawlError(`Network error: unable to resolve DNS for ${url}`);
+                }
+                // その他のネットワークエラー
+                if (error.message.includes("net::") ||
+                    error.message.includes("Network") ||
+                    error.message.includes("ECONNREFUSED")) {
+                    throw new CrawlError(`Network error: ${error.message}`);
+                }
+            }
+            // 不明なエラー
+            throw new CrawlError(`Crawl failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+        finally {
+            // リソースクリーンアップ
+            if (page) {
+                await page.close().catch(() => {
+                    // ページクローズエラーは無視
+                });
+            }
+            if (context) {
+                await context.close().catch(() => {
+                    // コンテキストクローズエラーは無視
+                });
+            }
+        }
+    }
+    /**
+     * ブラウザを閉じる
+     */
+    async close() {
+        if (this.browser) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.debug("[PlaywrightCrawlerService] Closing browser");
+            }
+            await this.browser.close();
+            this.browser = null;
+        }
+    }
+}
+exports.PlaywrightCrawlerService = PlaywrightCrawlerService;
+// =====================================================
+// スタンドアロン関数
+// =====================================================
+/**
+ * シングルトンインスタンス
+ */
+let sharedService = null;
+/**
+ * 共有サービスインスタンスを取得
+ */
+function getSharedService() {
+    if (!sharedService) {
+        sharedService = new PlaywrightCrawlerService();
+    }
+    return sharedService;
+}
+/**
+ * Webページをクロール（スタンドアロン関数）
+ *
+ * @param url - クロールするURL
+ * @param options - クロールオプション
+ * @returns クロール結果
+ *
+ * @example
+ * ```typescript
+ * const result = await crawlPage('https://example.com', {
+ *   timeout: 10000,
+ *   waitUntil: 'networkidle',
+ *   viewport: { width: 1920, height: 1080 },
+ * });
+ * console.log(result.html);
+ * console.log(result.title);
+ * console.log(result.screenshot); // base64
+ * ```
+ */
+async function crawlPage(url, options = {}) {
+    const service = getSharedService();
+    return service.crawl(url, options);
+}
+/**
+ * 共有サービスを閉じる
+ */
+async function closeSharedService() {
+    if (sharedService) {
+        await sharedService.close();
+        sharedService = null;
+    }
+}
+//# sourceMappingURL=playwright-crawler.service.js.map

package/dist/services/page/playwright-crawler.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-crawler.service.js","sourceRoot":"","sources":["../../../src/services/page/playwright-crawler.service.ts"],"names":[],"mappings":"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"}

package/dist/services/page/quality-evaluator.service.d.ts

@@ -0,0 +1,107 @@
+import { type Grade } from "../../tools/page/schemas";
+/**
+ * 検出されたクリシェ
+ */
+export interface DetectedCliche {
+    type: string;
+    description: string;
+    severity: "high" | "medium" | "low";
+}
+/**
+ * 推奨事項
+ */
+export interface Recommendation {
+    id: string;
+    category: "originality" | "craftsmanship" | "contextuality";
+    priority: "high" | "medium" | "low";
+    title: string;
+    description: string;
+    /** 期待される改善効果（例: "+5 points"） */
+    expectedImpact: string;
+}
+/**
+ * 軸別スコア
+ */
+export interface AxisScores {
+    originality: number;
+    craftsmanship: number;
+    contextuality: number;
+}
+/**
+ * 軸別グレード
+ */
+export interface AxisGrades {
+    originality: Grade;
+    craftsmanship: Grade;
+    contextuality: Grade;
+}
+/**
+ * 軸別詳細
+ */
+export interface AxisDetails {
+    originality: string[];
+    craftsmanship: string[];
+    contextuality: string[];
+}
+/**
+ * 品質評価オプション
+ */
+export interface QualityEvaluatorOptions {
+    /** strictモード: クリシェ検出を厳格化 */
+    strict?: boolean;
+    /** 重み付け */
+    weights?: {
+        originality?: number;
+        craftsmanship?: number;
+        contextuality?: number;
+    };
+    /** 業界 */
+    targetIndustry?: string;
+    /** ターゲットオーディエンス */
+    targetAudience?: string;
+    /** 推奨事項を含める */
+    includeRecommendations?: boolean;
+}
+/**
+ * 品質評価結果
+ */
+export interface QualityEvaluatorResult {
+    success: boolean;
+    overallScore: number;
+    grade: Grade;
+    axisScores: AxisScores;
+    clicheCount: number;
+    processingTimeMs: number;
+    axisGrades?: AxisGrades;
+    axisDetails?: AxisDetails;
+    cliches?: DetectedCliche[];
+    recommendations?: Recommendation[];
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * 品質評価サービス
+ *
+ * Webデザインの品質を3軸で評価し、AIクリシェ検出と推奨事項生成を行う
+ */
+export declare class QualityEvaluatorService {
+    /**
+     * HTMLを評価し、品質スコアと詳細を返す
+     *
+     * @param html - 評価対象のHTML
+     * @param options - 評価オプション
+     * @returns 品質評価結果
+     */
+    evaluate(html: string, options?: QualityEvaluatorOptions): Promise<QualityEvaluatorResult>;
+}
+/**
+ * 共有インスタンスを取得
+ */
+export declare function getQualityEvaluatorService(): QualityEvaluatorService;
+/**
+ * 共有インスタンスをリセット（テスト用）
+ */
+export declare function resetQualityEvaluatorService(): void;
+//# sourceMappingURL=quality-evaluator.service.d.ts.map

package/dist/services/page/quality-evaluator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-evaluator.service.d.ts","sourceRoot":"","sources":["../../../src/services/page/quality-evaluator.service.ts"],"names":[],"mappings":"AAeA,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAgBpE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC;IAC5D,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,KAAK,CAAC;IACnB,aAAa,EAAE,KAAK,CAAC;IACrB,aAAa,EAAE,KAAK,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW;IACX,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,SAAS;IACT,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAqqCD;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC;;;;;;OAMG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC;CA8HnC;AAQD;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,uBAAuB,CAKpE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}