ppxc-leads-mcp 0.1.0

package/dist/mcp/server.js

@@ -0,0 +1,829 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpServer = createMcpServer;
+exports.startMcpServer = startMcpServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const platform_runner_1 = require("../browser/platform-runner");
+const detect_platform_1 = require("../browser/platforms/detect-platform");
+const registry_1 = require("../browser/platforms/registry");
+const logger_1 = require("../browser/kernel/logger");
+const ppxc_login_window_1 = require("../backend/ppxc-login-window");
+const ppxc_client_1 = require("../backend/ppxc-client");
+const battle_report_1 = require("./battle-report");
+const content_insights_1 = require("./content-insights");
+const diagnostics_1 = require("./diagnostics");
+const version_1 = require("../version");
+const PLATFORM_ZOD = zod_1.z.enum(["douyin", "xiaohongshu", "kuaishou"]);
+function jsonText(payload) {
+    return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
+}
+function sleepMs(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+const KEYWORD_CATEGORY_LABELS = {
+    generic: "泛需求词",
+    experience: "体验感受词",
+    persona_pain: "人群痛点词",
+    decision: "决策对比词",
+    problem_failure: "问题翻车词",
+};
+const KEYWORD_SOURCE_LABELS = {
+    main_committee: "AI 精选",
+    rule_based: "规则兜底",
+    custom: "用户自定义",
+};
+function rankCommitteeKeywords(keywords) {
+    const tier = (k) => {
+        if (k.source === "main_committee") {
+            return k.priority === "main" ? 0 : k.priority === "supplement" ? 2 : 1;
+        }
+        if (k.source === "custom")
+            return 3;
+        return 4;
+    };
+    return [...keywords].sort((a, b) => tier(a) - tier(b));
+}
+function toReportLead(lead, extra) {
+    return {
+        nickname: lead.nickname,
+        intent: lead.intent,
+        demandType: lead.demandType,
+        comment: lead.comment,
+        reason: lead.reason,
+        script: lead.script,
+        saleScore: lead.saleScore,
+        ipLabel: lead.ipLabel || undefined,
+        profileUrl: lead.contact?.profileUrl || undefined,
+        fromContent: extra?.fromContent,
+        fromKeyword: extra?.fromKeyword,
+    };
+}
+async function productNameOf(productId) {
+    try {
+        const products = await (0, ppxc_client_1.listProducts)();
+        return products.find((p) => p.id === productId)?.name;
+    }
+    catch {
+        return undefined;
+    }
+}
+function topPickOf(reportLeads) {
+    const sorted = [...reportLeads].sort((a, b) => (b.saleScore ?? 0) - (a.saleScore ?? 0));
+    const top = sorted[0];
+    if (!top)
+        return undefined;
+    return { nickname: top.nickname || "（未留昵称）", why: (0, battle_report_1.rankReason)(top) };
+}
+function formatCommitteeKeywords(keywords, cap = 40) {
+    return rankCommitteeKeywords(keywords)
+        .slice(0, cap)
+        .map((k) => ({
+        keyword: k.keyword,
+        source: KEYWORD_SOURCE_LABELS[k.source] ?? k.source,
+        ...(k.category ? { category: KEYWORD_CATEGORY_LABELS[k.category] ?? k.category } : {}),
+        ...(k.priority
+            ? { priority: k.priority === "main" ? "主力" : k.priority === "supplement" ? "补充" : "普通" }
+            : {}),
+        ...(k.reason ? { reason: k.reason } : {}),
+    }));
+}
+const RUNNER_HINTS = {
+    LOGIN_REQUIRED: "还没登录。请先用 check_status_and_login 对应平台的登录动作扫码，再重试。",
+    VERIFICATION_REQUIRED: "平台要求验证，已弹出窗口。请完成验证后再重试，不要换词硬刷。",
+    FETCH_TIMEOUT: "评论没拉回来，可能是网络或风控。稍等一下再试。",
+    BAD_VIDEO_LINK: "链接无法识别，请确认是有效的内容链接。",
+    EMPTY_COMMENTS: "暂时没有可分析的评论。",
+    BUSY: "上一个任务还在进行中，请等它结束后再发起新的。",
+    RATE_LIMITED: "为保护账号安全，两次抓取之间需要间隔半分钟。",
+    DAILY_LIMITED: "今天的安全抓取额度已用完，请明天再继续。",
+    NO_SEARCH_RESULT: "没搜到合适的内容，换个词或稍后再试。",
+    INTERNAL: "内部出错了，请稍后重试。",
+};
+function runnerErrorText(err, platform) {
+    const name = (0, registry_1.getPlatformAdapter)(platform).displayName;
+    const hints = {
+        ...RUNNER_HINTS,
+        LOGIN_REQUIRED: `${name}还没登录。请先用 check_status_and_login 登录 ${name}，再重试。`,
+        VERIFICATION_REQUIRED: `${name}要求验证，已弹出窗口。请完成验证后再重试。`,
+        BAD_VIDEO_LINK: `这个链接里没认出${name}内容，请确认链接正确。`,
+        DAILY_LIMITED: `今天 ${name} 的安全抓取额度已用完，请明天再继续。`,
+    };
+    return {
+        ok: false,
+        code: err.code,
+        userHint: hints[err.code] ?? "出错了，请稍后重试。",
+        detail: err.message,
+    };
+}
+async function allPlatformLoginStatus() {
+    const out = {};
+    for (const adapter of (0, registry_1.listPlatformAdapters)()) {
+        try {
+            const st = await (0, platform_runner_1.getLoginStatus)(adapter.id);
+            out[adapter.id] = st.loggedIn;
+        }
+        catch {
+            out[adapter.id] = false;
+        }
+    }
+    return out;
+}
+function createMcpServer() {
+    const server = new mcp_js_1.McpServer({
+        name: "ppxc-leads-mcp",
+        version: version_1.OWN_VERSION,
+    });
+    const registerTool = server.registerTool.bind(server);
+    registerTool("check_status_and_login", {
+        description: "检查抖音/小红书/快手 + PPXC 登录态。action=login_douyin|login_xiaohongshu|login_kuaishou 弹对应平台扫码窗；action=login_ppxc 弹 PPXC 账号登录窗；默认只查状态。",
+        inputSchema: {
+            action: zod_1.z
+                .enum([
+                "status",
+                "login_douyin",
+                "login_xiaohongshu",
+                "login_kuaishou",
+                "login_ppxc",
+            ])
+                .optional()
+                .describe("status=只查；login_*=弹对应平台登录窗；login_ppxc=PPXC 账号登录。"),
+        },
+    }, async (args) => {
+        const action = args.action ?? "status";
+        try {
+            const loginPlatformMap = {
+                login_douyin: "douyin",
+                login_xiaohongshu: "xiaohongshu",
+                login_kuaishou: "kuaishou",
+            };
+            if (action in loginPlatformMap) {
+                const platform = loginPlatformMap[action];
+                const adapter = (0, registry_1.getPlatformAdapter)(platform);
+                const result = await (0, platform_runner_1.startPlatformLogin)(platform);
+                const platforms = await allPlatformLoginStatus();
+                return jsonText({
+                    ok: true,
+                    platform,
+                    loggedIn: result.loggedIn,
+                    platforms,
+                    ppxcLoggedIn: (0, ppxc_login_window_1.isPpxcLoggedIn)(),
+                    hint: result.loggedIn
+                        ? `${adapter.displayName}已登录。`
+                        : `还没检测到${adapter.displayName}登录成功。请在弹出窗口扫码，扫完再调用本工具确认。`,
+                    logFile: logger_1.LOG_FILE_PATH,
+                });
+            }
+            if (action === "login_ppxc") {
+                const result = await (0, ppxc_login_window_1.openPpxcLoginWindow)();
+                const platforms = await allPlatformLoginStatus();
+                return jsonText({
+                    ok: result.ok,
+                    platforms,
+                    ppxcLoggedIn: (0, ppxc_login_window_1.isPpxcLoggedIn)(),
+                    hint: result.ok
+                        ? "PPXC 账号已登录。"
+                        : `PPXC 登录未完成：${result.message ?? "请重试"}`,
+                    logFile: logger_1.LOG_FILE_PATH,
+                });
+            }
+            const platforms = await allPlatformLoginStatus();
+            const ppxc = (0, ppxc_login_window_1.isPpxcLoggedIn)();
+            const missing = [];
+            for (const adapter of (0, registry_1.listPlatformAdapters)()) {
+                if (!platforms[adapter.id]) {
+                    missing.push(`${adapter.displayName}（action=login_${adapter.id === "xiaohongshu" ? "xiaohongshu" : adapter.id}）`);
+                }
+            }
+            if (!ppxc)
+                missing.push("PPXC 账号（action=login_ppxc）");
+            return jsonText({
+                ok: true,
+                platforms,
+                ppxcLoggedIn: ppxc,
+                hint: missing.length === 0
+                    ? "各平台与 PPXC 都已登录，可以开始找客户了。"
+                    : `还需要登录：${missing.join("、")}`,
+                logFile: logger_1.LOG_FILE_PATH,
+            });
+        }
+        catch (err) {
+            if (err instanceof platform_runner_1.RunnerError && err.code === "BUSY") {
+                return jsonText({
+                    ok: false,
+                    code: "BUSY",
+                    userHint: "上一个任务还在进行中，请等它结束后再操作登录。",
+                    detail: err.message,
+                });
+            }
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "检查登录态时出错了，请稍后重试。",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+    registerTool("list_products", {
+        description: "列出当前 PPXC 账号下的产品，返回 id 和名称。分析评论前用它拿到 productId。",
+        inputSchema: {},
+    }, async () => {
+        try {
+            const products = await (0, ppxc_client_1.listProducts)();
+            return jsonText({
+                ok: true,
+                products,
+                hint: products.length === 0
+                    ? "这个账号下还没有产品，请先到 PPXC 网页端创建一个产品。"
+                    : "把其中一个产品的 id 作为 productId 传给 analyze_video_comments。",
+            });
+        }
+        catch (err) {
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 401) {
+                return jsonText({
+                    ok: false,
+                    code: "PPXC_LOGIN_REQUIRED",
+                    userHint: "PPXC 未登录或登录失效，请先用 check_status_and_login（action=login_ppxc）登录。",
+                });
+            }
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "获取产品列表失败，请稍后重试。",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+    registerTool("analyze_video_comments", {
+        description: "给一条抖音/小红书/快手内容链接 + productId：读评论 → PPXC AI 分析 → 客户战报 + 落客户池。platform 可省略，会从链接自动识别。" +
+            "挖到客户时会在用户桌面生成一份战报网页文件（结果里的 reportFile），汇报时务必告诉用户文件位置和首推客户及理由（topPick）。" +
+            "结果里的 contentAngles 是从这批评论提炼的内容选题方向（拍什么/为什么/客户原话），汇报后可主动提议「要不要根据这些评论写下一条视频脚本」。",
+        inputSchema: {
+            videoUrl: zod_1.z.string().describe("内容链接（抖音视频/小红书笔记/快手视频）或 ID。"),
+            productId: zod_1.z.string().describe("产品 id，用 list_products 获取。"),
+            platform: PLATFORM_ZOD
+                .optional()
+                .describe("可选：douyin | xiaohongshu | kuaishou。不传则从链接自动识别。"),
+            maxComments: zod_1.z.number().int().min(1).max(50).optional().describe("最多读多少条评论，默认 30。"),
+            save: zod_1.z.boolean().optional().describe("是否落客户池，默认 true。"),
+        },
+    }, async (args) => {
+        const videoUrl = args.videoUrl;
+        const productId = args.productId;
+        const maxComments = args.maxComments;
+        const save = args.save;
+        const platform = (0, detect_platform_1.normalizePlatformId)(args.platform, videoUrl);
+        if (!productId || typeof productId !== "string") {
+            return jsonText({
+                ok: false,
+                code: "NO_PRODUCT",
+                userHint: "缺少 productId。请先用 list_products 选一个产品。",
+            });
+        }
+        let fetched;
+        try {
+            fetched = await (0, platform_runner_1.fetchContentComments)(platform, videoUrl, maxComments ?? 30);
+        }
+        catch (err) {
+            if (err instanceof platform_runner_1.RunnerError) {
+                return jsonText(runnerErrorText(err, platform));
+            }
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "拉评论时内部出错，请稍后重试。",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+        if (fetched.comments.length === 0) {
+            return jsonText({
+                ok: false,
+                code: "EMPTY_COMMENTS",
+                userHint: "这条内容暂时没有可分析的评论。",
+                content: { id: fetched.contentId, url: fetched.contentUrl, platform },
+            });
+        }
+        try {
+            const analysis = await (0, ppxc_client_1.analyzeComments)({
+                productId,
+                comments: fetched.comments,
+                videoUrl: fetched.contentUrl,
+                save: save !== false,
+            });
+            const reportLeads = analysis.leads.map((l) => toReportLead(l, { fromContent: fetched.contentUrl }));
+            const topPick = topPickOf(reportLeads);
+            const paywall = analysis.paywall;
+            const paywallLocked = paywall?.locked === true && (paywall.lockedCount ?? 0) > 0;
+            let report = {};
+            if (reportLeads.length > 0) {
+                const exported = (0, battle_report_1.exportBattleReport)({
+                    kind: "link",
+                    platformName: (0, registry_1.getPlatformAdapter)(platform).displayName,
+                    productName: await productNameOf(productId),
+                    contentUrl: fetched.contentUrl,
+                    summary: analysis.summary,
+                    leads: reportLeads,
+                    savedToPool: analysis.saved,
+                    skippedDuplicates: analysis.skippedDuplicates,
+                    paywall: paywallLocked
+                        ? {
+                            lockedCount: paywall.lockedCount ?? 0,
+                            lockedIntents: paywall.lockedIntents,
+                            unlockHint: paywall.unlockHint,
+                        }
+                        : undefined,
+                });
+                if (exported.ok)
+                    report = { file: exported.file };
+            }
+            const baseVerdict = analysis.summary.demandsFound > 0
+                ? `看了 ${analysis.summary.commentsAnalyzed} 条评论，挑出 ${analysis.summary.demandsFound} 个潜在客户，其中 ${analysis.summary.highIntentCount} 个意向较高。`
+                : `看了 ${analysis.summary.commentsAnalyzed} 条评论，暂时没看到明确的潜在客户。`;
+            const lockedTail = paywallLocked
+                ? `你当前是体验版，只解锁了前 ${reportLeads.length} 个完整客户；${paywall.unlockHint}`
+                : "";
+            return jsonText({
+                ok: true,
+                platform,
+                content: { id: fetched.contentId, url: fetched.contentUrl },
+                summary: {
+                    ...analysis.summary,
+                    commentsFetched: fetched.comments.length,
+                    verdict: (topPick ? `${baseVerdict}首推「${topPick.nickname}」（${topPick.why}）。` : baseVerdict) +
+                        (lockedTail ? `（${lockedTail}）` : ""),
+                },
+                topPick,
+                paywall,
+                contentAngles: (0, content_insights_1.deriveContentAngles)(reportLeads),
+                leads: analysis.leads,
+                savedToPool: analysis.saved,
+                skippedDuplicates: analysis.skippedDuplicates ?? 0,
+                saveFailed: analysis.saveFailed === true,
+                ...(report.file
+                    ? {
+                        reportFile: report.file,
+                        reportHint: paywallLocked
+                            ? `已生成战报（网页文件），里面只展示了解锁的前 ${reportLeads.length} 个客户；其余已锁，开通套餐后全部解锁。文件在：${report.file}`
+                            : `已生成一份客户战报（网页文件，含话术，可转发同事照着跟进），放在：${report.file}`,
+                    }
+                    : {}),
+            });
+        }
+        catch (err) {
+            if (err instanceof ppxc_client_1.PpxcApiError) {
+                if (err.status === 401) {
+                    return jsonText({
+                        ok: false,
+                        code: "PPXC_LOGIN_REQUIRED",
+                        userHint: "PPXC 未登录或登录失效，请用 check_status_and_login（action=login_ppxc）登录后重试。",
+                    });
+                }
+                if (err.status === 402) {
+                    return jsonText({
+                        ok: false,
+                        code: "INSUFFICIENT_CREDITS",
+                        userHint: `${err.message}。请到 PPXC 网页端给 AI 充电后再试。`,
+                    });
+                }
+                if (err.status === 403) {
+                    return jsonText({
+                        ok: false,
+                        code: "NO_PRODUCT_ACCESS",
+                        userHint: "这个产品不属于当前账号，请用 list_products 重新选一个。",
+                    });
+                }
+                if (err.status === 429) {
+                    return jsonText({
+                        ok: false,
+                        code: "BACKEND_RATE_LIMITED",
+                        userHint: `后端提示请求太频繁：${err.message}`,
+                    });
+                }
+                return jsonText({ ok: false, code: "BACKEND_ERROR", userHint: `后端分析失败：${err.message}` });
+            }
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "送后端分析时内部出错，请稍后重试。",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+    registerTool("search_keyword_for_leads", {
+        description: "关键词 + productId + platform：搜内容 → 读评论 → AI 分析 → 汇总战报。支持 douyin/xiaohongshu/kuaishou。多关键词 2 窗口并行（抖音）；小红书/快手更保守。" +
+            "挖到客户时会在用户桌面生成一份战报网页文件（结果里的 reportFile），汇报时务必告诉用户文件位置和首推客户及理由（topPick）。" +
+            "结果里的 contentAngles 是从这批评论提炼的内容选题方向（拍什么/为什么/客户原话），汇报后可主动提议「要不要根据这些评论写下一条视频脚本」。",
+        inputSchema: {
+            platform: PLATFORM_ZOD.describe("在哪个平台搜：douyin | xiaohongshu | kuaishou。"),
+            keywords: zod_1.z
+                .array(zod_1.z.string())
+                .min(1)
+                .max(6)
+                .describe("搜索词列表，最多 6 个。"),
+            productId: zod_1.z.string().describe("产品 id，用 list_products 获取。"),
+            maxVideosPerKeyword: zod_1.z
+                .number()
+                .int()
+                .min(1)
+                .max(8)
+                .optional()
+                .describe("每个关键词最多读几条内容；合计有平台上限（抖音 12、小红书/快手 8）。"),
+            save: zod_1.z.boolean().optional().describe("是否落客户池，默认 true。"),
+        },
+    }, async (args) => {
+        const platform = (0, detect_platform_1.normalizePlatformId)(args.platform);
+        const keywords = args.keywords ?? [];
+        const productId = args.productId;
+        const maxVideosPerKeyword = args.maxVideosPerKeyword;
+        const save = args.save;
+        const adapter = (0, registry_1.getPlatformAdapter)(platform);
+        if (!productId || typeof productId !== "string") {
+            return jsonText({ ok: false, code: "NO_PRODUCT", userHint: "缺少 productId。" });
+        }
+        if (!Array.isArray(keywords) || keywords.length === 0) {
+            return jsonText({ ok: false, code: "NO_KEYWORD", userHint: "缺少搜索词。" });
+        }
+        let outcomes;
+        try {
+            outcomes = await (0, platform_runner_1.searchKeywordsBatch)(platform, keywords, maxVideosPerKeyword ?? 5);
+        }
+        catch (err) {
+            if (err instanceof platform_runner_1.RunnerError) {
+                return jsonText(runnerErrorText(err, platform));
+            }
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "搜索时内部出错，请稍后重试。",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+        const allLeads = [];
+        let commentsAnalyzed = 0;
+        let demandsFound = 0;
+        let highIntentCount = 0;
+        let savedToPool = 0;
+        let skippedDuplicates = 0;
+        let saveFailedCount = 0;
+        let itemsRead = 0;
+        let lockedFromBackend = 0;
+        let anyLocked = false;
+        const perKeyword = [];
+        for (const oc of outcomes) {
+            if (!oc.ok || !oc.result) {
+                perKeyword.push({ keyword: oc.keyword, ok: false, code: oc.errorCode });
+                continue;
+            }
+            let kwDemands = 0;
+            const contentItems = oc.result.items ?? oc.result.videos ?? [];
+            for (const v of contentItems) {
+                itemsRead += 1;
+                const itemUrl = v.contentUrl ?? v.videoUrl ?? "";
+                try {
+                    const analysis = await (0, ppxc_client_1.analyzeComments)({
+                        productId,
+                        comments: v.comments,
+                        videoUrl: itemUrl,
+                        videoDesc: v.title,
+                        save: save !== false,
+                    });
+                    commentsAnalyzed += analysis.summary.commentsAnalyzed;
+                    demandsFound += analysis.summary.demandsFound;
+                    kwDemands += analysis.summary.demandsFound;
+                    highIntentCount += analysis.summary.highIntentCount;
+                    savedToPool += analysis.saved;
+                    skippedDuplicates += analysis.skippedDuplicates ?? 0;
+                    if (analysis.saveFailed === true)
+                        saveFailedCount += 1;
+                    lockedFromBackend += analysis.paywall?.lockedCount ?? 0;
+                    if (analysis.paywall?.locked)
+                        anyLocked = true;
+                    for (const lead of analysis.leads) {
+                        allLeads.push({ ...lead, fromContent: itemUrl, fromKeyword: oc.keyword, platform });
+                    }
+                }
+                catch (err) {
+                    if (err instanceof ppxc_client_1.PpxcApiError && err.status === 401) {
+                        return jsonText({
+                            ok: false,
+                            code: "PPXC_LOGIN_REQUIRED",
+                            userHint: "PPXC 未登录或登录失效，请用 check_status_and_login（action=login_ppxc）登录后重试。",
+                        });
+                    }
+                    if (err instanceof ppxc_client_1.PpxcApiError && err.status === 402) {
+                        return jsonText({
+                            ok: false,
+                            code: "INSUFFICIENT_CREDITS",
+                            userHint: `${err.message}。请到 PPXC 网页端给 AI 充电后再试。`,
+                            partial: allLeads.length > 0
+                                ? { leads: allLeads, commentsAnalyzed, demandsFound, savedToPool }
+                                : undefined,
+                        });
+                    }
+                    if (err instanceof ppxc_client_1.PpxcApiError && err.status === 403) {
+                        return jsonText({
+                            ok: false,
+                            code: "NO_PRODUCT_ACCESS",
+                            userHint: "这个产品不属于当前账号，请用 list_products 重新选一个。",
+                        });
+                    }
+                }
+            }
+            perKeyword.push({
+                keyword: oc.keyword,
+                ok: true,
+                itemsRead: contentItems.length,
+                demands: kwDemands,
+            });
+        }
+        const hitVerification = outcomes.some((o) => !o.ok && o.errorCode === "VERIFICATION_REQUIRED");
+        const hitLoginRequired = outcomes.some((o) => !o.ok && o.errorCode === "LOGIN_REQUIRED");
+        if (commentsAnalyzed === 0) {
+            if (hitVerification) {
+                return jsonText({
+                    ok: false,
+                    code: "VERIFICATION_REQUIRED",
+                    userHint: `${adapter.displayName}要求验证，已弹出窗口，本次搜索已停止。请先完成验证，不要换词重试。`,
+                    perKeyword,
+                });
+            }
+            if (hitLoginRequired) {
+                return jsonText({
+                    ok: false,
+                    code: "LOGIN_REQUIRED",
+                    userHint: `${adapter.displayName}登录已失效，请先登录后再重试。`,
+                    perKeyword,
+                });
+            }
+            return jsonText({
+                ok: false,
+                code: "EMPTY_COMMENTS",
+                userHint: "搜到的内容没读到可分析的评论，换个词试试。",
+                perKeyword,
+            });
+        }
+        allLeads.sort((a, b) => (b.saleScore ?? 0) - (a.saleScore ?? 0));
+        const SEARCH_FREE_PREVIEW = 2;
+        const visibleAllLeads = anyLocked ? allLeads.slice(0, SEARCH_FREE_PREVIEW) : allLeads;
+        const lockedTotal = anyLocked
+            ? allLeads.length - visibleAllLeads.length + lockedFromBackend
+            : 0;
+        const paywallLocked = anyLocked && lockedTotal > 0;
+        const unlockHint = `还有 ${lockedTotal} 个潜在客户（含完整评论、跟进话术、主页链接）已找到，开通套餐后全部解锁。`;
+        const reportLeads = visibleAllLeads.map((l) => toReportLead(l, { fromContent: l.fromContent, fromKeyword: l.fromKeyword }));
+        const topPick = topPickOf(reportLeads);
+        let report = {};
+        if (reportLeads.length > 0) {
+            const exported = (0, battle_report_1.exportBattleReport)({
+                kind: "search",
+                platformName: adapter.displayName,
+                productName: await productNameOf(productId),
+                keywords: outcomes.map((o) => o.keyword),
+                summary: { itemsRead, commentsAnalyzed, demandsFound, highIntentCount },
+                leads: reportLeads,
+                perKeyword: perKeyword,
+                savedToPool,
+                skippedDuplicates,
+                paywall: paywallLocked ? { lockedCount: lockedTotal, unlockHint } : undefined,
+            });
+            if (exported.ok)
+                report = { file: exported.file };
+        }
+        const kwLabel = outcomes.map((o) => o.keyword).join("、");
+        const warning = hitVerification
+            ? `注意：搜索中途${adapter.displayName}要求验证，部分关键词未完成，请先验证再继续。`
+            : undefined;
+        let baseVerdict = demandsFound > 0
+            ? `在${adapter.displayName}搜「${kwLabel}」读了 ${itemsRead} 条内容共 ${commentsAnalyzed} 条评论，挑出 ${demandsFound} 个潜在客户，其中 ${highIntentCount} 个意向较高。`
+            : `在${adapter.displayName}搜「${kwLabel}」读了 ${itemsRead} 条内容，暂时没看到明确的潜在客户。`;
+        if (topPick)
+            baseVerdict += `首推「${topPick.nickname}」（${topPick.why}）。`;
+        const lockedTail = paywallLocked
+            ? `你当前是体验版，只解锁了前 ${visibleAllLeads.length} 个完整客户；${unlockHint}`
+            : "";
+        return jsonText({
+            ok: true,
+            platform,
+            keywords: outcomes.map((o) => o.keyword),
+            warning,
+            summary: {
+                keywordsSearched: outcomes.length,
+                itemsRead,
+                commentsAnalyzed,
+                demandsFound,
+                highIntentCount,
+                verdict: (warning ? `${baseVerdict}（${warning}）` : baseVerdict) +
+                    (lockedTail ? `（${lockedTail}）` : ""),
+            },
+            topPick,
+            paywall: paywallLocked ? { locked: true, lockedCount: lockedTotal, unlockHint } : { locked: false },
+            contentAngles: (0, content_insights_1.deriveContentAngles)(reportLeads),
+            leads: visibleAllLeads,
+            perKeyword,
+            savedToPool,
+            skippedDuplicates,
+            saveFailed: saveFailedCount > 0,
+            ...(report.file
+                ? {
+                    reportFile: report.file,
+                    reportHint: paywallLocked
+                        ? `已生成战报（网页文件），只展示了解锁的前 ${visibleAllLeads.length} 个客户；其余已锁，开通套餐后全部解锁。文件在：${report.file}`
+                        : `已生成一份客户战报（网页文件，含每个词的成绩和话术，可转发同事照着跟进），放在：${report.file}`,
+                }
+                : {}),
+        });
+    });
+    registerTool("suggest_search_keywords", {
+        description: "给 productId，返回 PPXC 想词委员会为该产品生成的精选搜索词（带词型分类和推荐理由）。" +
+            "词单通常在产品创建/编辑时已自动生成，本工具默认直接读现成结果；没有现成词单时会触发一轮生成并等待（约 1 分钟）。" +
+            "开搜前先调它，从主力词里挑 3~6 个传给 search_keyword_for_leads，比现场编词命中率高得多。" +
+            "regenerate=true 强制重新生成（消耗用户电力，仅当用户明确要求换一批词时使用）。",
+        inputSchema: {
+            productId: zod_1.z.string().describe("产品 id，用 list_products 获取。"),
+            regenerate: zod_1.z
+                .boolean()
+                .optional()
+                .describe("强制重新生成一轮（会消耗电力）。默认 false：直接读现成词单。"),
+        },
+    }, async (args) => {
+        const productId = args.productId;
+        const regenerate = args.regenerate === true;
+        if (!productId || typeof productId !== "string") {
+            return jsonText({ ok: false, code: "NO_PRODUCT", userHint: "缺少 productId。请先用 list_products 选一个产品。" });
+        }
+        try {
+            let current = await (0, ppxc_client_1.getCommitteeKeywords)(productId);
+            const needTrigger = regenerate ||
+                (current.keywords.length === 0 &&
+                    current.generationStatus !== "running" &&
+                    current.generationStatus !== "queued");
+            if (needTrigger) {
+                await (0, ppxc_client_1.triggerCommitteeRun)(productId);
+            }
+            const shouldWait = needTrigger || current.generationStatus === "running" || current.generationStatus === "queued";
+            if (shouldWait) {
+                const deadline = Date.now() + 100000;
+                do {
+                    await sleepMs(8000);
+                    current = await (0, ppxc_client_1.getCommitteeKeywords)(productId);
+                } while (Date.now() < deadline &&
+                    current.generationStatus !== "done" &&
+                    current.generationStatus !== "error");
+            }
+            if (current.keywords.length === 0) {
+                if (current.generationStatus === "error") {
+                    return jsonText({
+                        ok: false,
+                        code: "COMMITTEE_FAILED",
+                        userHint: `这一轮想词没跑出来${current.errorMessage ? `（${current.errorMessage}）` : ""}。可以稍后用 regenerate=true 再试一次。`,
+                    });
+                }
+                return jsonText({
+                    ok: false,
+                    code: "COMMITTEE_PENDING",
+                    userHint: "搜词还在后台生成，请过一两分钟再调用本工具读取结果。",
+                });
+            }
+            const list = formatCommitteeKeywords(current.keywords);
+            const mainCount = list.filter((k) => k.priority === "主力" || k.source === "AI 精选").length;
+            return jsonText({
+                ok: true,
+                generationStatus: current.generationStatus,
+                total: current.keywords.length,
+                keywords: list,
+                hint: `共 ${current.keywords.length} 个搜索词（返回前 ${list.length} 个，AI 精选 ${mainCount} 个在前）。` +
+                    "建议从靠前的主力词里挑 3~6 个传给 search_keyword_for_leads；注意每个平台有每日安全额度（抖音 20 词、小红书/快手各 10 词），先小批验证哪些词出客户，再决定是否加词。",
+            });
+        }
+        catch (err) {
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 401) {
+                return jsonText({
+                    ok: false,
+                    code: "PPXC_LOGIN_REQUIRED",
+                    userHint: "PPXC 未登录或登录失效，请先用 check_status_and_login（action=login_ppxc）登录。",
+                });
+            }
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 403) {
+                return jsonText({ ok: false, code: "NO_PRODUCT_ACCESS", userHint: "这个产品不属于当前账号，请用 list_products 重新选一个。" });
+            }
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 503) {
+                return jsonText({ ok: false, code: "COMMITTEE_DISABLED", userHint: "想词功能暂未对这个产品开放，请直接根据产品和目标人群拟 3~6 个搜索词使用。" });
+            }
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "获取搜索词时出错了，请稍后重试。",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+    registerTool("query_leads", {
+        description: "查 PPXC 客户池里已挖到的潜在客户（只读）。支持按产品、来源搜索词、最近天数、跟进状态过滤，" +
+            "默认返回最新 30 条，每条带昵称、评论原文、意向、判断理由、跟进话术、跟进状态。" +
+            "用户问「之前找到的客户 / 高意向的有哪些 / 某个词搜出来的客户」时用它。",
+        inputSchema: {
+            productId: zod_1.z.string().optional().describe("产品 id；不传则查当前账号全部产品。"),
+            keyword: zod_1.z.string().optional().describe("只看这个搜索词挖到的客户。"),
+            days: zod_1.z.number().int().min(1).max(90).optional().describe("只看最近 N 天入池的客户。"),
+            status: zod_1.z
+                .enum(["待处理", "已联系", "已转化", "未转化", "忽略"])
+                .optional()
+                .describe("按跟进状态过滤。"),
+            limit: zod_1.z.number().int().min(1).max(100).optional().describe("最多返回几条，默认 30。"),
+        },
+    }, async (args) => {
+        const productId = args.productId;
+        const keyword = args.keyword;
+        const days = args.days;
+        const status = args.status;
+        const limit = Math.max(1, Math.min(100, args.limit ?? 30));
+        try {
+            const since = days ? new Date(Date.now() - days * 86400000).toISOString() : undefined;
+            const { rows, paywallLocked } = await (0, ppxc_client_1.queryLeads)({ productId, keyword, since });
+            const filtered = status ? rows.filter((r) => r.status === status) : rows;
+            const byStatus = {};
+            const byIntent = {};
+            for (const r of filtered) {
+                byStatus[r.status] = (byStatus[r.status] ?? 0) + 1;
+                if (r.urgency)
+                    byIntent[r.urgency] = (byIntent[r.urgency] ?? 0) + 1;
+            }
+            const leads = filtered.slice(0, limit).map((r) => ({
+                id: r.id,
+                nickname: r.user_nickname,
+                intent: r.urgency,
+                demandType: r.demand_type,
+                comment: r.comment_text,
+                reason: r.reason,
+                script: r.script,
+                status: r.status,
+                ...(r.source_keyword ? { fromKeyword: r.source_keyword } : {}),
+                ...(r.sale_score !== undefined ? { saleScore: r.sale_score } : {}),
+                ...(r.ip_label ? { region: r.ip_label } : {}),
+                ...(r.user_profile_url ? { profileUrl: r.user_profile_url } : {}),
+                videoUrl: r.video_url,
+                capturedAt: r.captured_at,
+            }));
+            const baseHint = filtered.length === 0
+                ? "没查到符合条件的客户。可以放宽条件，或先用 search_keyword_for_leads 去挖新客户。"
+                : `共 ${filtered.length} 条符合条件（按入池时间从新到旧，返回前 ${leads.length} 条）。完整客户池在 PPXC 网页端可看。`;
+            return jsonText({
+                ok: true,
+                totalMatched: filtered.length,
+                returned: leads.length,
+                byStatus,
+                byIntent,
+                paywall: paywallLocked ? { locked: true } : { locked: false },
+                leads,
+                hint: paywallLocked
+                    ? `${baseHint}（你当前是体验版，名单里的跟进话术和联系方式已锁，开通套餐后解锁。）`
+                    : baseHint,
+            });
+        }
+        catch (err) {
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 401) {
+                return jsonText({
+                    ok: false,
+                    code: "PPXC_LOGIN_REQUIRED",
+                    userHint: "PPXC 未登录或登录失效，请先用 check_status_and_login（action=login_ppxc）登录。",
+                });
+            }
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 403) {
+                return jsonText({ ok: false, code: "NO_PRODUCT_ACCESS", userHint: "这个产品不属于当前账号，请用 list_products 重新选一个。" });
+            }
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "查询客户池时出错了，请稍后重试。",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+    registerTool("export_diagnostics", {
+        description: "用户反馈「不好用 / 出错了 / 需要排查」时调用：把本机运行日志打包成一个诊断文件（默认放到桌面），告诉用户文件位置，让用户发给 PPXC 支持人员。不含账号密码等敏感信息。",
+        inputSchema: {},
+    }, async () => {
+        const result = (0, diagnostics_1.exportDiagnostics)();
+        if (!result.ok) {
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "诊断文件没生成出来，请稍后再试一次。",
+                detail: result.error,
+            });
+        }
+        return jsonText({
+            ok: true,
+            file: result.file,
+            hint: `诊断文件已放到：${result.file}。请把这个文件发给 PPXC 支持人员，里面只有运行记录，没有账号密码。`,
+        });
+    });
+    return server;
+}
+async function startMcpServer() {
+    const server = createMcpServer();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map