ppxc-leads-mcp 0.1.8 → 0.1.10

package/LICENSE.md

@@ -1,11 +1,11 @@
-# PPXC Leads MCP Proprietary License
+# OPC 评论线索雷达 MCP Proprietary License
 
-Copyright (c) PPXC. All rights reserved.
+Copyright (c) OPC. All rights reserved.
 
-This package is provided only for use with the PPXC service.
+This package is provided only for use with the OPC service.
 
-You may install and run this package to connect an MCP-capable assistant to your own PPXC account.
+You may install and run this package to connect an MCP-capable assistant to your own OPC account.
 
-You may not copy, modify, decompile, reverse engineer, republish, redistribute, sublicense, sell, rent, host, or use this package or any substantial part of it to build a competing or derivative service without prior written permission from PPXC.
+You may not copy, modify, decompile, reverse engineer, republish, redistribute, sublicense, sell, rent, host, or use this package or any substantial part of it to build a competing or derivative service without prior written permission from OPC.
 
-This package is provided "as is" without warranties of any kind. PPXC may update, limit, suspend, or discontinue access to service-backed functionality according to PPXC account, billing, safety, and abuse-control rules.
+This package is provided "as is" without warranties of any kind. OPC may update, limit, suspend, or discontinue access to service-backed functionality according to OPC account, billing, safety, and abuse-control rules.

package/README.md

@@ -1,10 +1,24 @@
-# PPXC Leads MCP
+# OPC 评论线索雷达 MCP
 
-PPXC Leads MCP lets an MCP-capable assistant help a PPXC user find potential customers from public comments on supported social platforms.
+OPC 评论线索雷达是一款找客户 Agent Skill / MCP 工具，帮助商家从抖音、小红书、快手公开评论中识别购买意向、销售线索和可跟进客户名单。
+
+OPC Comment Lead Radar is an Agent Skill and MCP tool for lead generation from short-video comments, helping teams discover customer intent and sales leads from Douyin, Xiaohongshu, and Kuaishou.
+
+OPC 评论线索雷达 MCP lets an MCP-capable assistant turn public comments on supported social platforms into customer signals, ranked leads, follow-up scripts, and reusable customer-pool records.
 
 Package: <https://www.npmjs.com/package/ppxc-leads-mcp>  
 Setup guide: <https://opc1.me/download/mcp>
 
+## What It Does
+
+- Finds high-intent sales leads from public comments.
+- Detects purchase intent, comparison questions, complaints, and recommendation requests.
+- Generates follow-up scripts that a sales or private-traffic team can use.
+- Saves the results into the user's customer pool for later review.
+- Helps content teams turn real customer questions into the next content angles.
+
+Best-fit searches: lead generation, sales leads, social media leads, comment analysis, intent detection, customer discovery, CRM, social listening, local business leads, Xiaohongshu leads, Douyin leads, Kuaishou leads.
+
 ## Install MCP
 
 Add this server to an MCP-capable host:
@@ -49,26 +63,30 @@ Install the whole `skills/ppxc-find-customers/` folder into your assistant's ski
 ~/.codex/skills/ppxc-find-customers/
 ```
 
-MCP installation exposes the tools. Skill installation teaches the assistant the safe workflow: check login, choose product, suggest keywords, search for leads, query the customer pool, and export diagnostics when needed.
+MCP installation exposes the tools. Skill installation teaches the assistant the safe workflow: verify the connector and platform login, run a trial analysis from a product description, show the first customer signals, then ask the user to log in only when they want to save, unlock, or query the full customer pool.
 
 ## Tools
 
-The package exposes seven MCP tools:
+The package exposes eleven MCP tools:
 
 - `check_status_and_login`
+- `get_workflow_manifest`
 - `list_products`
 - `suggest_search_keywords`
 - `search_keyword_for_leads`
 - `analyze_video_comments`
 - `query_leads`
+- `mark_lead_feedback`
+- `update_lead_status`
+- `review_followup_queue`
 - `export_diagnostics`
 
 ## Privacy And Safety
 
-- Platform login sessions and PPXC login credentials stay on the user's machine.
-- Platform tokens and cookies are not uploaded to PPXC and are not written to diagnostics.
-- Public comment text is sent to PPXC over HTTPS for customer-intent analysis, follow-up suggestions, and customer-pool storage.
-- Results are saved only to the user's own PPXC customer pool.
+- Platform login sessions and OPC login credentials stay on the user's machine.
+- Platform tokens and cookies are not uploaded to OPC and are not written to diagnostics.
+- Public comment text is sent to OPC over HTTPS for customer-intent analysis, follow-up suggestions, and customer-pool storage.
+- Results are saved only to the user's own OPC customer pool.
 - Captchas, QR-code login, and security checks are handled by the user in a local window. This package does not bypass verification.
 - The tool does not send private messages or automate outreach.
 
@@ -80,8 +98,8 @@ If startup is slow, wait for the browser runtime download to finish. In mainland
 
 If a platform asks for QR-code login or verification, complete it manually in the local window, then retry the assistant request.
 
-If something fails, ask the assistant to run `export_diagnostics` and send the generated diagnostic file to PPXC support.
+If something fails, ask the assistant to run `export_diagnostics` and send the generated diagnostic file to OPC support.
 
 ## License
 
-This package is proprietary. It may be installed and used as part of the PPXC service, but copying, modifying, reverse engineering, republishing, or redistributing it is not allowed except with written permission from PPXC.
+This package is proprietary. It may be installed and used as part of the OPC service, but copying, modifying, reverse engineering, republishing, or redistributing it is not allowed except with written permission from OPC.

package/dist/backend/config.js

@@ -4,8 +4,17 @@ exports.getApiBase = getApiBase;
 exports.isHttpUrl = isHttpUrl;
 const PRODUCTION_API_BASE = "https://opc1.me";
 function getApiBase() {
-    const raw = (process.env.PPXC_API_BASE || PRODUCTION_API_BASE).trim().replace(/\/+$/, "");
-    return raw;
+    const raw = (process.env.PPXC_API_BASE || PRODUCTION_API_BASE).trim();
+    try {
+        const url = new URL(raw);
+        url.pathname = "";
+        url.search = "";
+        url.hash = "";
+        return url.toString().replace(/\/+$/, "");
+    }
+    catch {
+        return raw.replace(/\/+$/, "");
+    }
 }
 function isHttpUrl(value) {
     return /^https?:\/\//i.test(value);

package/dist/backend/ppxc-client.js

@@ -1,11 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PpxcApiError = void 0;
+exports.getMcpCapabilities = getMcpCapabilities;
 exports.listProducts = listProducts;
 exports.analyzeComments = analyzeComments;
 exports.getCommitteeKeywords = getCommitteeKeywords;
 exports.triggerCommitteeRun = triggerCommitteeRun;
 exports.queryLeads = queryLeads;
+exports.markLeadFeedback = markLeadFeedback;
+exports.updateLeadStatus = updateLeadStatus;
 const logger_1 = require("../browser/kernel/logger");
 const version_1 = require("../version");
 const config_1 = require("./config");
@@ -13,6 +16,7 @@ const token_store_1 = require("./token-store");
 const log = logger_1.logger.scope("ppxc-client");
 const LIST_TIMEOUT_MS = 15000;
 const ANALYZE_TIMEOUT_MS = 180000;
+const CAPABILITIES_TIMEOUT_MS = 10000;
 class PpxcApiError extends Error {
     constructor(status, message) {
         super(message);
@@ -24,16 +28,19 @@ exports.PpxcApiError = PpxcApiError;
 function authHeaders() {
     const token = (0, token_store_1.readToken)();
     if (!token)
-        throw new PpxcApiError(401, "PPXC 未登录");
+        throw new PpxcApiError(401, "OPC 账号未登录");
+    return optionalAuthHeaders(token);
+}
+function optionalAuthHeaders(token = (0, token_store_1.readToken)()) {
     return {
-        Authorization: `Bearer ${token}`,
         "Content-Type": "application/json",
         "X-PPXC-MCP-Version": version_1.OWN_VERSION,
+        ...(token ? { Authorization: `Bearer ${token}` } : {}),
     };
 }
 function handleUnauthorized() {
     (0, token_store_1.clearToken)();
-    return new PpxcApiError(401, "PPXC 登录已失效");
+    return new PpxcApiError(401, "OPC 登录已失效");
 }
 async function fetchWithTimeout(url, init, timeoutMs) {
     try {
@@ -46,6 +53,12 @@ async function fetchWithTimeout(url, init, timeoutMs) {
         throw err;
     }
 }
+async function getMcpCapabilities() {
+    const res = await fetchWithTimeout(`${(0, config_1.getApiBase)()}/api/v2/mcp/capabilities`, { method: "GET", headers: optionalAuthHeaders() }, CAPABILITIES_TIMEOUT_MS);
+    if (!res.ok)
+        throw new PpxcApiError(res.status, `读取动态工作流失败 (${res.status})`);
+    return (await res.json());
+}
 async function listProducts() {
     const res = await fetchWithTimeout(`${(0, config_1.getApiBase)()}/api/v2/products`, { method: "GET", headers: authHeaders() }, LIST_TIMEOUT_MS);
     if (res.status === 401)
@@ -65,11 +78,16 @@ async function listProducts() {
 }
 async function analyzeComments(input) {
     const body = {
-        productId: input.productId,
+        productId: input.productId ?? "",
+        productName: input.productName ?? "",
+        productDescription: input.productDescription ?? "",
+        sellingPoints: input.sellingPoints ?? [],
+        problemSolved: input.problemSolved ?? "",
+        targetPersona: input.targetPersona ?? "",
         videoUrl: input.videoUrl ?? "",
         videoDesc: input.videoDesc ?? "",
         sourceKeyword: input.sourceKeyword ?? "",
-        save: input.save !== false,
+        save: input.productId ? input.save !== false : false,
         comments: input.comments.map((c) => ({
             text: c.text,
             nickname: c.nickname,
@@ -80,7 +98,11 @@ async function analyzeComments(input) {
             createTime: c.createTime,
         })),
     };
-    const res = await fetchWithTimeout(`${(0, config_1.getApiBase)()}/api/v2/comments/analyze`, { method: "POST", headers: authHeaders(), body: JSON.stringify(body) }, ANALYZE_TIMEOUT_MS);
+    const res = await fetchWithTimeout(`${(0, config_1.getApiBase)()}/api/v2/comments/analyze`, {
+        method: "POST",
+        headers: input.productId ? authHeaders() : optionalAuthHeaders(),
+        body: JSON.stringify(body),
+    }, ANALYZE_TIMEOUT_MS);
     if (res.status === 401)
         throw handleUnauthorized();
     if (res.status === 403)
@@ -133,6 +155,13 @@ async function triggerCommitteeRun(productId) {
     log.info("committee run triggered", { productId });
 }
 const LEADS_TIMEOUT_MS = 30000;
+function readHeaderInt(headers, name) {
+    const raw = headers.get(name);
+    if (!raw)
+        return 0;
+    const value = Number(raw);
+    return Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
+}
 async function queryLeads(opts) {
     const params = new URLSearchParams();
     if (opts.productId)
@@ -152,5 +181,52 @@ async function queryLeads(opts) {
         throw new PpxcApiError(res.status, `查询客户池失败 (${res.status})`);
     const data = (await res.json());
     const paywallLocked = res.headers.get("x-ppxc-paywall") === "locked";
-    return { rows: Array.isArray(data) ? data : [], paywallLocked };
+    const lockedCount = readHeaderInt(res.headers, "x-ppxc-paywall-locked-count");
+    return {
+        rows: Array.isArray(data) ? data : [],
+        paywall: paywallLocked
+            ? {
+                locked: true,
+                lockedCount,
+                lockedIntents: {
+                    high: readHeaderInt(res.headers, "x-ppxc-paywall-locked-high"),
+                    medium: readHeaderInt(res.headers, "x-ppxc-paywall-locked-medium"),
+                    low: readHeaderInt(res.headers, "x-ppxc-paywall-locked-low"),
+                },
+                unlockHint: lockedCount > 0
+                    ? `另有 ${lockedCount} 个潜在客户已锁定，开通套餐后重新查询即可解锁完整结果。`
+                    : "名单里的更多信息已锁定，开通套餐后重新查询即可解锁完整结果。",
+            }
+            : { locked: false },
+    };
+}
+async function markLeadFeedback(input) {
+    const res = await fetchWithTimeout(`${(0, config_1.getApiBase)()}/api/v2/lead-feedback`, {
+        method: "POST",
+        headers: authHeaders(),
+        body: JSON.stringify({
+            leadId: input.leadId,
+            tag: input.tag,
+            ...(input.reason ? { reason: input.reason } : {}),
+        }),
+    }, LIST_TIMEOUT_MS);
+    if (res.status === 401)
+        throw handleUnauthorized();
+    if (res.status === 403)
+        throw new PpxcApiError(403, "无权操作这条客户线索");
+    if (!res.ok)
+        throw new PpxcApiError(res.status, `提交线索反馈失败 (${res.status})`);
+}
+async function updateLeadStatus(input) {
+    const res = await fetchWithTimeout(`${(0, config_1.getApiBase)()}/api/v2/leads`, {
+        method: "PATCH",
+        headers: authHeaders(),
+        body: JSON.stringify({ id: input.leadId, status: input.status }),
+    }, LIST_TIMEOUT_MS);
+    if (res.status === 401)
+        throw handleUnauthorized();
+    if (res.status === 403)
+        throw new PpxcApiError(403, "无权操作这条客户线索");
+    if (!res.ok)
+        throw new PpxcApiError(res.status, `更新跟进状态失败 (${res.status})`);
 }

package/dist/backend/ppxc-login-window.js

@@ -37,14 +37,14 @@ function isPpxcLoggedIn() {
 async function openPpxcLoginWindow() {
     const apiBase = (0, config_1.getApiBase)();
     if (!(0, config_1.isHttpUrl)(apiBase)) {
-        return { ok: false, code: "api_base_invalid", message: "后端地址无效，请配置 PPXC_API_BASE" };
+        return { ok: false, code: "api_base_invalid", message: "OPC 服务地址无效，请检查 PPXC_API_BASE" };
     }
     if (activeLoginWindow && !activeLoginWindow.isDestroyed()) {
         activeLoginWindow.focus();
         return { ok: false, code: "user_cancelled", message: "登录窗口已在打开中" };
     }
     const win = new electron_1.BrowserWindow({
-        title: "登录 PPXC",
+        title: "登录 OPC 评论线索雷达",
         width: 460,
         height: 680,
         show: false,
@@ -95,7 +95,7 @@ async function openPpxcLoginWindow() {
         if (!win.isDestroyed())
             win.destroy();
         activeLoginWindow = null;
-        return { ok: false, code: "network_error", message: "无法打开登录页，请检查后端地址是否可达" };
+        return { ok: false, code: "network_error", message: "无法打开 OPC 登录页，请检查网络是否能访问 opc1.me" };
     }
     win.show();
     return new Promise((resolve) => {

package/dist/mcp/battle-report.js

@@ -119,11 +119,12 @@ const STYLE = `
           text-align:center; }
   .lock-icon { font-size:26px; }
   .lock-title { font-size:18px; font-weight:800; color:#9a3412; margin:6px 0 4px; }
-  .lock-sub { font-size:14px; color:#7c5a3a; line-height:1.7; }
+  .lock-sub { font-size:14px; color:#7c5a3a; line-height:1.7; max-width:620px; margin:0 auto; }
   .lock-rows { display:flex; justify-content:center; gap:12px; flex-wrap:wrap; margin:14px 0 4px; }
   .lock-chip { background:#fff; border:1px solid #f0d9bf; border-radius:999px; padding:6px 16px; font-size:13px; color:#9a3412; }
   .lock-cta { display:inline-block; margin-top:14px; background:#ea7a26; color:#fff; font-weight:700;
-              padding:10px 26px; border-radius:999px; font-size:14px; }
+              padding:10px 26px; border-radius:999px; font-size:14px; text-decoration:none; }
+  .lock-note { margin-top:10px; font-size:12px; color:#9a6a3a; }
   .links { margin-top:12px; font-size:13px; display:flex; gap:18px; flex-wrap:wrap; }
   .links a { color:var(--green-deep); text-decoration:none; border-bottom:1px dashed currentColor; padding-bottom:1px; }
   .tablewrap { background:var(--card); border-radius:18px; box-shadow:var(--shadow); overflow:hidden; }
@@ -225,7 +226,8 @@ function renderPaywall(input) {
     <div class="lock-title">还有 ${pw.lockedCount} 个潜在客户没解锁</div>
     <div class="lock-sub">${esc(pw.unlockHint || "开通套餐后，这些客户的评论、跟进话术和主页链接全部解锁。")}</div>
     ${chips ? `<div class="lock-rows">${chips}</div>` : ""}
-    <div class="lock-cta">开通套餐 · 解锁全部客户</div>
+    <a class="lock-cta" href="https://opc1.me/recharge" target="_blank">开通套餐 · 解锁全部客户</a>
+    <div class="lock-note">付款后让智能体重新查询客户池或重新生成战报，完整客户会自动放开。</div>
   </div>`;
 }
 function renderBattleReport(input, generatedAt = new Date()) {

package/dist/mcp/server.js

@@ -70,6 +70,33 @@ async function productNameOf(productId) {
         return undefined;
     }
 }
+function stringArg(args, key) {
+    const value = args[key];
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function stringArrayArg(args, key) {
+    const value = args[key];
+    if (!Array.isArray(value))
+        return undefined;
+    const arr = value.map((item) => String(item ?? "").trim()).filter(Boolean).slice(0, 8);
+    return arr.length > 0 ? arr : undefined;
+}
+function productContextFromArgs(args) {
+    return {
+        productId: stringArg(args, "productId"),
+        productName: stringArg(args, "productName"),
+        productDescription: stringArg(args, "productDescription"),
+        sellingPoints: stringArrayArg(args, "sellingPoints"),
+        problemSolved: stringArg(args, "problemSolved"),
+        targetPersona: stringArg(args, "targetPersona"),
+    };
+}
+function hasProductContext(ctx) {
+    return Boolean(ctx.productId || ctx.productName);
+}
+function productContextHint() {
+    return "先告诉我你卖的产品/服务名称，最好再补一句适合谁、解决什么问题；我可以先试跑一轮，给你看前 2 条线索。";
+}
 function topPickOf(reportLeads) {
     const sorted = [...reportLeads].sort((a, b) => (b.saleScore ?? 0) - (a.saleScore ?? 0));
     const top = sorted[0];
@@ -131,6 +158,32 @@ async function allPlatformLoginStatus() {
     }
     return out;
 }
+async function workflowManifestPayload() {
+    try {
+        const manifest = await (0, ppxc_client_1.getMcpCapabilities)();
+        return {
+            ok: true,
+            workflowVersion: manifest.workflowVersion,
+            skill: manifest.skill,
+            mcpPackage: manifest.mcpPackage,
+            capabilities: manifest.capabilities,
+            workflow: manifest.workflow,
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            workflowVersion: "local-fallback",
+            warning: "后端动态工作流暂时不可用，已使用 MCP 内置流程继续执行。",
+            detail: err instanceof Error ? err.message : String(err),
+            capabilities: {
+                leadFeedback: true,
+                leadStatusUpdate: true,
+                followupReview: true,
+            },
+        };
+    }
+}
 function createMcpServer() {
     const server = new mcp_js_1.McpServer({
         name: "ppxc-leads-mcp",
@@ -138,7 +191,7 @@ function createMcpServer() {
     });
     const registerTool = server.registerTool.bind(server);
     registerTool("check_status_and_login", {
-        description: "检查抖音/小红书/快手 + PPXC 登录态。action=login_douyin|login_xiaohongshu|login_kuaishou 弹对应平台扫码窗；action=login_ppxc 弹 PPXC 账号登录窗；默认只查状态。",
+        description: "检查 OPC 账号 + 抖音/小红书/快手登录态。action=login_douyin|login_xiaohongshu|login_kuaishou 弹对应平台扫码窗；action=login_ppxc 弹 OPC 账号登录窗；默认只查状态。",
         inputSchema: {
             action: zod_1.z
                 .enum([
@@ -149,7 +202,7 @@ function createMcpServer() {
                 "login_ppxc",
             ])
                 .optional()
-                .describe("status=只查；login_*=弹对应平台登录窗；login_ppxc=PPXC 账号登录。"),
+                .describe("status=只查；login_*=弹对应平台登录窗；login_ppxc=OPC 账号登录。"),
         },
     }, async (args) => {
         const action = args.action ?? "status";
@@ -159,6 +212,7 @@ function createMcpServer() {
                 login_xiaohongshu: "xiaohongshu",
                 login_kuaishou: "kuaishou",
             };
+            const workflowManifest = await workflowManifestPayload();
             if (action in loginPlatformMap) {
                 const platform = loginPlatformMap[action];
                 const adapter = (0, registry_1.getPlatformAdapter)(platform);
@@ -173,6 +227,7 @@ function createMcpServer() {
                     hint: result.loggedIn
                         ? `${adapter.displayName}已登录。`
                         : `还没检测到${adapter.displayName}登录成功。请在弹出窗口扫码，扫完再调用本工具确认。`,
+                    workflowManifest,
                     logFile: logger_1.LOG_FILE_PATH,
                 });
             }
@@ -184,8 +239,9 @@ function createMcpServer() {
                     platforms,
                     ppxcLoggedIn: (0, ppxc_login_window_1.isPpxcLoggedIn)(),
                     hint: result.ok
-                        ? "PPXC 账号已登录。"
-                        : `PPXC 登录未完成：${result.message ?? "请重试"}`,
+                        ? "OPC 账号已登录。"
+                        : `OPC 登录未完成：${result.message ?? "请重试"}`,
+                    workflowManifest,
                     logFile: logger_1.LOG_FILE_PATH,
                 });
             }
@@ -198,14 +254,15 @@ function createMcpServer() {
                 }
             }
             if (!ppxc)
-                missing.push("PPXC 账号（action=login_ppxc）");
+                missing.push("OPC 账号（action=login_ppxc）");
             return jsonText({
                 ok: true,
                 platforms,
                 ppxcLoggedIn: ppxc,
                 hint: missing.length === 0
-                    ? "各平台与 PPXC 都已登录，可以开始找客户了。"
+                    ? "OPC 账号与各平台都已登录，可以开始找客户了。"
                     : `还需要登录：${missing.join("、")}`,
+                workflowManifest,
                 logFile: logger_1.LOG_FILE_PATH,
             });
         }
@@ -227,7 +284,7 @@ function createMcpServer() {
         }
     });
     registerTool("list_products", {
-        description: "列出当前 PPXC 账号下的产品，返回 id 和名称。分析评论前用它拿到 productId。",
+        description: "列出当前 OPC 账号下的产品，返回 id 和名称。分析评论前用它拿到 productId。",
         inputSchema: {},
     }, async () => {
         try {
@@ -236,7 +293,7 @@ function createMcpServer() {
                 ok: true,
                 products,
                 hint: products.length === 0
-                    ? "这个账号下还没有产品，请先到 PPXC 网页端创建一个产品。"
+                    ? "这个账号下还没有产品，请先到 OPC 网页端创建一个产品。"
                     : "把其中一个产品的 id 作为 productId 传给 analyze_video_comments。",
             });
         }
@@ -245,7 +302,7 @@ function createMcpServer() {
                 return jsonText({
                     ok: false,
                     code: "PPXC_LOGIN_REQUIRED",
-                    userHint: "PPXC 未登录或登录失效，请先用 check_status_and_login（action=login_ppxc）登录。",
+                    userHint: "OPC 账号未登录或登录失效，请先用 check_status_and_login（action=login_ppxc）登录。",
                 });
             }
             return jsonText({
@@ -257,12 +314,17 @@ function createMcpServer() {
         }
     });
     registerTool("analyze_video_comments", {
-        description: "给一条抖音/小红书/快手内容链接 + productId：读评论 → PPXC AI 分析 → 客户战报 + 落客户池。platform 可省略，会从链接自动识别。" +
+        description: "给一条抖音/小红书/快手内容链接 + productId 或 productName：读评论 → OPC AI 分析 → 客户战报。未登录用户可只传 productName 先试跑，返回前 2 条线索；登录后传 productId 才会落客户池。platform 可省略，会从链接自动识别。" +
             "挖到客户时会在用户桌面生成一份战报网页文件（结果里的 reportFile），汇报时务必告诉用户文件位置和首推客户及理由（topPick）。" +
             "结果里的 contentAngles 是从这批评论提炼的内容选题方向（拍什么/为什么/客户原话），汇报后可主动提议「要不要根据这些评论写下一条视频脚本」。",
         inputSchema: {
             videoUrl: zod_1.z.string().describe("内容链接（抖音视频/小红书笔记/快手视频）或 ID。"),
-            productId: zod_1.z.string().describe("产品 id，用 list_products 获取。"),
+            productId: zod_1.z.string().optional().describe("已登录用户的产品 id，用 list_products 获取；未登录试用可不传。"),
+            productName: zod_1.z.string().optional().describe("未登录试用时填写：用户卖的产品/服务名称。"),
+            productDescription: zod_1.z.string().optional().describe("未登录试用时填写：适合谁、解决什么问题、主要卖点。"),
+            sellingPoints: zod_1.z.array(zod_1.z.string()).max(8).optional().describe("未登录试用时可填：卖点列表。"),
+            problemSolved: zod_1.z.string().optional().describe("未登录试用时可填：解决的痛点。"),
+            targetPersona: zod_1.z.string().optional().describe("未登录试用时可填：目标人群。"),
             platform: PLATFORM_ZOD
                 .optional()
                 .describe("可选：douyin | xiaohongshu | kuaishou。不传则从链接自动识别。"),
@@ -271,15 +333,15 @@ function createMcpServer() {
         },
     }, async (args) => {
         const videoUrl = args.videoUrl;
-        const productId = args.productId;
+        const productContext = productContextFromArgs(args);
         const maxComments = args.maxComments;
         const save = args.save;
         const platform = (0, detect_platform_1.normalizePlatformId)(args.platform, videoUrl);
-        if (!productId || typeof productId !== "string") {
+        if (!hasProductContext(productContext)) {
             return jsonText({
                 ok: false,
-                code: "NO_PRODUCT",
-                userHint: "缺少 productId。请先用 list_products 选一个产品。",
+                code: "NO_PRODUCT_CONTEXT",
+                userHint: productContextHint(),
             });
         }
         let fetched;
@@ -307,7 +369,7 @@ function createMcpServer() {
         }
         try {
             const analysis = await (0, ppxc_client_1.analyzeComments)({
-                productId,
+                ...productContext,
                 comments: fetched.comments,
                 videoUrl: fetched.contentUrl,
                 save: save !== false,
@@ -321,7 +383,7 @@ function createMcpServer() {
                 const exported = (0, battle_report_1.exportBattleReport)({
                     kind: "link",
                     platformName: (0, registry_1.getPlatformAdapter)(platform).displayName,
-                    productName: await productNameOf(productId),
+                    productName: productContext.productName || (productContext.productId ? await productNameOf(productContext.productId) : undefined),
                     contentUrl: fetched.contentUrl,
                     summary: analysis.summary,
                     leads: reportLeads,
@@ -365,7 +427,7 @@ function createMcpServer() {
                     ? {
                         reportFile: report.file,
                         reportHint: paywallLocked
-                            ? `已生成战报（网页文件），里面只展示了解锁的前 ${reportLeads.length} 个客户；其余已锁，开通套餐后全部解锁。文件在：${report.file}`
+                            ? `已生成战报（网页文件），里面只展示了解锁的前 ${reportLeads.length} 个客户；其余已锁。开通套餐后，重新查询客户池或重新生成战报即可拿到完整结果。文件在：${report.file}`
                             : `已生成一份客户战报（网页文件，含话术，可转发同事照着跟进），放在：${report.file}`,
                     }
                     : {}),
@@ -377,14 +439,16 @@ function createMcpServer() {
                     return jsonText({
                         ok: false,
                         code: "PPXC_LOGIN_REQUIRED",
-                        userHint: "PPXC 未登录或登录失效，请用 check_status_and_login（action=login_ppxc）登录后重试。",
+                        userHint: productContext.productId
+                            ? "OPC 账号未登录或登录失效，请用 check_status_and_login（action=login_ppxc）登录后重试。"
+                            : "试用分析暂时没跑通。可以先登录 OPC，或补充产品名称后重试。",
                     });
                 }
                 if (err.status === 402) {
                     return jsonText({
                         ok: false,
                         code: "INSUFFICIENT_CREDITS",
-                        userHint: `${err.message}。请到 PPXC 网页端给 AI 充电后再试。`,
+                        userHint: `${err.message}。请到 OPC 网页端给 AI 充电后再试。`,
                     });
                 }
                 if (err.status === 403) {
@@ -398,21 +462,21 @@ function createMcpServer() {
                     return jsonText({
                         ok: false,
                         code: "BACKEND_RATE_LIMITED",
-                        userHint: `后端提示请求太频繁：${err.message}`,
+                        userHint: `OPC 服务提示请求太频繁：${err.message}`,
                     });
                 }
-                return jsonText({ ok: false, code: "BACKEND_ERROR", userHint: `后端分析失败：${err.message}` });
+                return jsonText({ ok: false, code: "BACKEND_ERROR", userHint: `OPC 分析服务失败：${err.message}` });
             }
             return jsonText({
                 ok: false,
                 code: "INTERNAL",
-                userHint: "送后端分析时内部出错，请稍后重试。",
+                userHint: "送 OPC 分析服务时内部出错，请稍后重试。",
                 detail: err instanceof Error ? err.message : String(err),
             });
         }
     });
     registerTool("search_keyword_for_leads", {
-        description: "关键词 + productId + platform：搜内容 → 读评论 → AI 分析 → 汇总战报。支持 douyin/xiaohongshu/kuaishou。多关键词 2 窗口并行（抖音）；小红书/快手更保守。" +
+        description: "关键词 + productId 或 productName + platform：搜内容 → 读评论 → AI 分析 → 汇总战报。未登录用户可只传 productName 先试跑，返回前 2 条线索；登录后传 productId 才会落客户池。支持 douyin/xiaohongshu/kuaishou。多关键词 2 窗口并行（抖音）；小红书/快手更保守。" +
             "挖到客户时会在用户桌面生成一份战报网页文件（结果里的 reportFile），汇报时务必告诉用户文件位置和首推客户及理由（topPick）。" +
             "结果里的 contentAngles 是从这批评论提炼的内容选题方向（拍什么/为什么/客户原话），汇报后可主动提议「要不要根据这些评论写下一条视频脚本」。",
         inputSchema: {
@@ -422,7 +486,12 @@ function createMcpServer() {
                 .min(1)
                 .max(6)
                 .describe("搜索词列表，最多 6 个。"),
-            productId: zod_1.z.string().describe("产品 id，用 list_products 获取。"),
+            productId: zod_1.z.string().optional().describe("已登录用户的产品 id，用 list_products 获取；未登录试用可不传。"),
+            productName: zod_1.z.string().optional().describe("未登录试用时填写：用户卖的产品/服务名称。"),
+            productDescription: zod_1.z.string().optional().describe("未登录试用时填写：适合谁、解决什么问题、主要卖点。"),
+            sellingPoints: zod_1.z.array(zod_1.z.string()).max(8).optional().describe("未登录试用时可填：卖点列表。"),
+            problemSolved: zod_1.z.string().optional().describe("未登录试用时可填：解决的痛点。"),
+            targetPersona: zod_1.z.string().optional().describe("未登录试用时可填：目标人群。"),
             maxVideosPerKeyword: zod_1.z
                 .number()
                 .int()
@@ -435,12 +504,12 @@ function createMcpServer() {
     }, async (args) => {
         const platform = (0, detect_platform_1.normalizePlatformId)(args.platform);
         const keywords = args.keywords ?? [];
-        const productId = args.productId;
+        const productContext = productContextFromArgs(args);
         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 (!hasProductContext(productContext)) {
+            return jsonText({ ok: false, code: "NO_PRODUCT_CONTEXT", userHint: productContextHint() });
         }
         if (!Array.isArray(keywords) || keywords.length === 0) {
             return jsonText({ ok: false, code: "NO_KEYWORD", userHint: "缺少搜索词。" });
@@ -483,7 +552,7 @@ function createMcpServer() {
                 const itemUrl = v.contentUrl ?? v.videoUrl ?? "";
                 try {
                     const analysis = await (0, ppxc_client_1.analyzeComments)({
-                        productId,
+                        ...productContext,
                         comments: v.comments,
                         videoUrl: itemUrl,
                         videoDesc: v.title,
@@ -510,14 +579,16 @@ function createMcpServer() {
                         return jsonText({
                             ok: false,
                             code: "PPXC_LOGIN_REQUIRED",
-                            userHint: "PPXC 未登录或登录失效，请用 check_status_and_login（action=login_ppxc）登录后重试。",
+                            userHint: productContext.productId
+                                ? "OPC 账号未登录或登录失效，请用 check_status_and_login（action=login_ppxc）登录后重试。"
+                                : "试用分析暂时没跑通。可以先登录 OPC，或补充产品名称后重试。",
                         });
                     }
                     if (err instanceof ppxc_client_1.PpxcApiError && err.status === 402) {
                         return jsonText({
                             ok: false,
                             code: "INSUFFICIENT_CREDITS",
-                            userHint: `${err.message}。请到 PPXC 网页端给 AI 充电后再试。`,
+                            userHint: `${err.message}。请到 OPC 网页端给 AI 充电后再试。`,
                             partial: allLeads.length > 0
                                 ? { leads: allLeads, commentsAnalyzed, demandsFound, savedToPool }
                                 : undefined,
@@ -580,7 +651,7 @@ function createMcpServer() {
             const exported = (0, battle_report_1.exportBattleReport)({
                 kind: "search",
                 platformName: adapter.displayName,
-                productName: await productNameOf(productId),
+                productName: productContext.productName || (productContext.productId ? await productNameOf(productContext.productId) : undefined),
                 keywords: outcomes.map((o) => o.keyword),
                 summary: { itemsRead, commentsAnalyzed, demandsFound, highIntentCount },
                 leads: reportLeads,
@@ -630,14 +701,14 @@ function createMcpServer() {
                 ? {
                     reportFile: report.file,
                     reportHint: paywallLocked
-                        ? `已生成战报（网页文件），只展示了解锁的前 ${visibleAllLeads.length} 个客户；其余已锁，开通套餐后全部解锁。文件在：${report.file}`
+                        ? `已生成战报（网页文件），只展示了解锁的前 ${visibleAllLeads.length} 个客户；其余已锁。开通套餐后，重新查询客户池或重新生成战报即可拿到完整结果。文件在：${report.file}`
                         : `已生成一份客户战报（网页文件，含每个词的成绩和话术，可转发同事照着跟进），放在：${report.file}`,
                 }
                 : {}),
         });
     });
     registerTool("suggest_search_keywords", {
-        description: "给 productId，返回 PPXC 想词委员会为该产品生成的精选搜索词（带词型分类和推荐理由）。" +
+        description: "给 productId，返回 OPC 想词委员会为该产品生成的精选搜索词（带词型分类和推荐理由）。" +
             "词单通常在产品创建/编辑时已自动生成，本工具默认直接读现成结果；没有现成词单时会触发一轮生成并等待（约 1 分钟）。" +
             "开搜前先调它，从主力词里挑 3~6 个传给 search_keyword_for_leads，比现场编词命中率高得多。" +
             "regenerate=true 强制重新生成（消耗用户电力，仅当用户明确要求换一批词时使用）。",
@@ -684,7 +755,7 @@ function createMcpServer() {
                 return jsonText({
                     ok: false,
                     code: "COMMITTEE_PENDING",
-                    userHint: "搜词还在后台生成，请过一两分钟再调用本工具读取结果。",
+                    userHint: "搜词还在生成，请过一两分钟再调用本工具读取结果。",
                 });
             }
             const list = formatCommitteeKeywords(current.keywords);
@@ -703,7 +774,7 @@ function createMcpServer() {
                 return jsonText({
                     ok: false,
                     code: "PPXC_LOGIN_REQUIRED",
-                    userHint: "PPXC 未登录或登录失效，请先用 check_status_and_login（action=login_ppxc）登录。",
+                    userHint: "OPC 账号未登录或登录失效，请先用 check_status_and_login（action=login_ppxc）登录。",
                 });
             }
             if (err instanceof ppxc_client_1.PpxcApiError && err.status === 403) {
@@ -720,8 +791,12 @@ function createMcpServer() {
             });
         }
     });
+    registerTool("get_workflow_manifest", {
+        description: "读取 OPC 后端最新动态工作流、能力清单和 Skill 升级提示。每次开始找客户或复盘前优先调用；如果失败，可以继续使用 MCP 内置流程。",
+        inputSchema: {},
+    }, async () => jsonText(await workflowManifestPayload()));
     registerTool("query_leads", {
-        description: "查 PPXC 客户池里已挖到的潜在客户（只读）。支持按产品、来源搜索词、最近天数、跟进状态过滤，" +
+        description: "查 OPC 客户池里已挖到的潜在客户（只读）。支持按产品、来源搜索词、最近天数、跟进状态过滤，" +
             "默认返回最新 30 条，每条带昵称、评论原文、意向、判断理由、跟进话术、跟进状态。" +
             "用户问「之前找到的客户 / 高意向的有哪些 / 某个词搜出来的客户」时用它。",
         inputSchema: {
@@ -742,7 +817,8 @@ function createMcpServer() {
         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 { rows, paywall } = await (0, ppxc_client_1.queryLeads)({ productId, keyword, since });
+            const paywallLocked = paywall.locked === true;
             const filtered = status ? rows.filter((r) => r.status === status) : rows;
             const byStatus = {};
             const byIntent = {};
@@ -769,17 +845,17 @@ function createMcpServer() {
             }));
             const baseHint = filtered.length === 0
                 ? "没查到符合条件的客户。可以放宽条件，或先用 search_keyword_for_leads 去挖新客户。"
-                : `共 ${filtered.length} 条符合条件（按入池时间从新到旧，返回前 ${leads.length} 条）。完整客户池在 PPXC 网页端可看。`;
+                : `共 ${filtered.length} 条符合条件（按入池时间从新到旧，返回前 ${leads.length} 条）。完整客户池在 OPC 网页端可看。`;
             return jsonText({
                 ok: true,
                 totalMatched: filtered.length,
                 returned: leads.length,
                 byStatus,
                 byIntent,
-                paywall: paywallLocked ? { locked: true } : { locked: false },
+                paywall,
                 leads,
                 hint: paywallLocked
-                    ? `${baseHint}（你当前是体验版，名单里的跟进话术和联系方式已锁，开通套餐后解锁。）`
+                    ? `${baseHint}（你当前是体验版，已返回可预览的客户；${paywall.unlockHint ?? "开通套餐后重新查询即可解锁完整结果。"}）`
                     : baseHint,
             });
         }
@@ -788,7 +864,7 @@ function createMcpServer() {
                 return jsonText({
                     ok: false,
                     code: "PPXC_LOGIN_REQUIRED",
-                    userHint: "PPXC 未登录或登录失效，请先用 check_status_and_login（action=login_ppxc）登录。",
+                    userHint: "OPC 账号未登录或登录失效，请先用 check_status_and_login（action=login_ppxc）登录。",
                 });
             }
             if (err instanceof ppxc_client_1.PpxcApiError && err.status === 403) {
@@ -802,8 +878,160 @@ function createMcpServer() {
             });
         }
     });
+    registerTool("mark_lead_feedback", {
+        description: "记录用户对某条客户线索的主观判断。准不准由用户说了算；用户说「这个准 / 不准 / 太泛 / 像客户 / 像路人」时调用，用于后端持续学习。",
+        inputSchema: {
+            leadId: zod_1.z.string().describe("客户线索 id，来自 query_leads 或找客户结果。"),
+            tag: zod_1.z
+                .enum(["accurate", "inaccurate", "too_broad", "feels_like_buyer", "feels_like_passerby"])
+                .describe("用户判断：accurate=准；inaccurate=不准；too_broad=太泛；feels_like_buyer=像客户；feels_like_passerby=像路人。"),
+            reason: zod_1.z.string().optional().describe("用户补充原因，最多会由后端截取保存。"),
+        },
+    }, async (args) => {
+        const leadId = stringArg(args, "leadId");
+        const tag = args.tag;
+        const reason = stringArg(args, "reason");
+        if (!leadId || !tag) {
+            return jsonText({ ok: false, code: "BAD_INPUT", userHint: "需要提供 leadId 和反馈类型。" });
+        }
+        try {
+            await (0, ppxc_client_1.markLeadFeedback)({ leadId, tag, reason });
+            return jsonText({
+                ok: true,
+                leadId,
+                tag,
+                hint: "已记录你的判断。后端会把这类反馈用于后续找客户和想词学习。",
+            });
+        }
+        catch (err) {
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 401) {
+                return jsonText({
+                    ok: false,
+                    code: "PPXC_LOGIN_REQUIRED",
+                    userHint: "需要先登录 OPC，才能把反馈写入你的客户池。请调用 check_status_and_login（action=login_ppxc）。",
+                });
+            }
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 403) {
+                return jsonText({ ok: false, code: "NO_LEAD_ACCESS", userHint: "这条客户线索不属于当前账号，不能标记。" });
+            }
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "记录线索反馈时出错了，请稍后重试。",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+    registerTool("update_lead_status", {
+        description: "更新客户线索跟进状态。用户说「已联系 / 已成交 / 没转化 / 忽略」时调用，用于形成真实跟进闭环和后续复盘。",
+        inputSchema: {
+            leadId: zod_1.z.string().describe("客户线索 id，来自 query_leads 或找客户结果。"),
+            status: zod_1.z
+                .enum(["待处理", "已联系", "已转化", "未转化", "忽略"])
+                .describe("新的跟进状态。"),
+        },
+    }, async (args) => {
+        const leadId = stringArg(args, "leadId");
+        const status = args.status;
+        if (!leadId || !status) {
+            return jsonText({ ok: false, code: "BAD_INPUT", userHint: "需要提供 leadId 和跟进状态。" });
+        }
+        try {
+            await (0, ppxc_client_1.updateLeadStatus)({ leadId, status });
+            return jsonText({
+                ok: true,
+                leadId,
+                status,
+                hint: `已把这条客户标记为「${status}」。后续可以用 review_followup_queue 复盘待处理和成交情况。`,
+            });
+        }
+        catch (err) {
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 401) {
+                return jsonText({
+                    ok: false,
+                    code: "PPXC_LOGIN_REQUIRED",
+                    userHint: "需要先登录 OPC，才能更新客户池状态。请调用 check_status_and_login（action=login_ppxc）。",
+                });
+            }
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 403) {
+                return jsonText({ ok: false, code: "NO_LEAD_ACCESS", userHint: "这条客户线索不属于当前账号，不能更新。" });
+            }
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "更新跟进状态时出错了，请稍后重试。",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+    registerTool("review_followup_queue", {
+        description: "复盘客户池跟进队列：统计待处理、已联系、已转化、未转化和忽略，并列出下一批最该处理的客户。用户问「昨天那批怎么样 / 哪些还没跟 / 成交情况」时调用。",
+        inputSchema: {
+            productId: zod_1.z.string().optional().describe("产品 id；不传则查当前账号全部产品。"),
+            days: zod_1.z.number().int().min(1).max(90).optional().describe("只看最近 N 天入池客户，默认 7 天。"),
+            limit: zod_1.z.number().int().min(1).max(50).optional().describe("每组最多返回几条样例，默认 5。"),
+        },
+    }, async (args) => {
+        const productId = stringArg(args, "productId");
+        const days = Math.max(1, Math.min(90, args.days ?? 7));
+        const limit = Math.max(1, Math.min(50, args.limit ?? 5));
+        try {
+            const since = new Date(Date.now() - days * 86400000).toISOString();
+            const { rows, paywall } = await (0, ppxc_client_1.queryLeads)({ productId, since });
+            const byStatus = {};
+            for (const row of rows) {
+                byStatus[row.status] = (byStatus[row.status] ?? 0) + 1;
+            }
+            const pick = (status) => rows
+                .filter((row) => row.status === status)
+                .slice(0, limit)
+                .map((row) => ({
+                id: row.id,
+                nickname: row.user_nickname,
+                intent: row.urgency,
+                demandType: row.demand_type,
+                comment: row.comment_text,
+                script: row.script,
+                ...(row.sale_score !== undefined ? { saleScore: row.sale_score } : {}),
+                ...(row.source_keyword ? { fromKeyword: row.source_keyword } : {}),
+            }));
+            const pending = pick("待处理");
+            const contacted = pick("已联系");
+            const converted = pick("已转化");
+            return jsonText({
+                ok: true,
+                days,
+                total: rows.length,
+                byStatus,
+                paywall,
+                nextActions: {
+                    pending,
+                    contactedNeedsResult: contacted,
+                    converted,
+                },
+                hint: rows.length === 0
+                    ? "最近没有可复盘的客户。可以先跑一次 search_keyword_for_leads 或 analyze_video_comments。"
+                    : `最近 ${days} 天有 ${rows.length} 条客户记录。优先处理「待处理」客户；已联系的客户要回填已转化或未转化，这样后端才能继续学习。`,
+            });
+        }
+        catch (err) {
+            if (err instanceof ppxc_client_1.PpxcApiError && err.status === 401) {
+                return jsonText({
+                    ok: false,
+                    code: "PPXC_LOGIN_REQUIRED",
+                    userHint: "需要先登录 OPC，才能复盘客户池。请调用 check_status_and_login（action=login_ppxc）。",
+                });
+            }
+            return jsonText({
+                ok: false,
+                code: "INTERNAL",
+                userHint: "复盘客户池时出错了，请稍后重试。",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
     registerTool("export_diagnostics", {
-        description: "用户反馈「不好用 / 出错了 / 需要排查」时调用：把本机运行日志打包成一个诊断文件（默认放到桌面），告诉用户文件位置，让用户发给 PPXC 支持人员。不含账号密码等敏感信息。",
+        description: "用户反馈「不好用 / 出错了 / 需要排查」时调用：把本机运行日志打包成一个诊断文件（默认放到桌面），告诉用户文件位置，让用户发给 OPC 支持人员。不含账号密码等敏感信息。",
         inputSchema: {},
     }, async () => {
         const result = (0, diagnostics_1.exportDiagnostics)();
@@ -818,7 +1046,7 @@ function createMcpServer() {
         return jsonText({
             ok: true,
             file: result.file,
-            hint: `诊断文件已放到：${result.file}。请把这个文件发给 PPXC 支持人员，里面只有运行记录，没有账号密码。`,
+            hint: `诊断文件已放到：${result.file}。请把这个文件发给 OPC 支持人员，里面只有运行记录，没有账号密码。`,
         });
     });
     return server;

package/package.json

@@ -1,8 +1,24 @@
 {
   "name": "ppxc-leads-mcp",
-  "productName": "PPXC Leads MCP",
-  "version": "0.1.8",
-  "description": "PPXC 找客户能力的 MCP 本地连接器",
+  "productName": "Social Leads Signal MCP",
+  "version": "0.1.10",
+  "description": "Detect high-intent customer signals from social comments",
+  "keywords": [
+    "mcp",
+    "lead-generation",
+    "sales-leads",
+    "social-media-leads",
+    "comment-analysis",
+    "intent-detection",
+    "customer-discovery",
+    "crm",
+    "sales-assistant",
+    "douyin",
+    "xiaohongshu",
+    "kuaishou",
+    "social-listening",
+    "follow-up-scripts"
+  ],
   "license": "UNLICENSED",
   "homepage": "https://opc1.me/download/mcp",
   "main": "dist/main.js",

package/skills/ppxc-find-customers/SKILL.md

@@ -1,11 +1,20 @@
 ---
 name: ppxc-find-customers
-description: 用 PPXC 找客户小组件（MCP）从抖音/小红书/快手评论区挖潜在客户的标准工作流。当用户说「帮我找客户」「谁想买我的产品」「分析这条视频/笔记的评论区」「用XX词搜搜看」「之前挖到的客户怎么样了」时使用。要求已接入 ppxc-leads-mcp 的 MCP 工具。
+description: OPC 评论线索雷达：找客户、销售线索、评论分析、关键词、客户池、跟进话术、小红书获客、抖音获客、快手获客、短视频获客、评论区获客、客户发现。用于从抖音/小红书/快手公开评论里识别购买意向、AI 销售线索、高意向客户和可跟进客户名单。当用户说「找客户」「获客」「分析评论区」「谁想买我的产品」「从小红书/抖音/快手找销售线索」「整理客户名单」时使用。要求已接入 ppxc-leads-mcp 的 MCP 工具。
 ---
 
-# PPXC 找客户 · 标准工作流
+# OPC 评论线索雷达 · 标准工作流
 
-你是用户的找客户助手。底层能力由 PPXC 找客户小组件（MCP 工具）提供：用用户本人的账号、像真人一样去抖音/小红书/快手看评论区，AI 判断谁是潜在客户，并把结果存入用户的 PPXC 客户池。
+你是用户的社媒获客助手。底层能力由客户信号检测工具提供：用用户本人的账号、像真人一样去抖音/小红书/快手看公开评论，判断谁正在表达购买意向，并把结果存入用户自己的客户池。
+
+统一定位句：OPC 评论线索雷达是一款找客户 Agent Skill / MCP 工具，帮助商家从抖音、小红书、快手公开评论中识别购买意向、销售线索和可跟进客户名单。
+
+## 命名和故障口径
+
+- 对用户称呼这套能力为「OPC 评论线索雷达」或「评论线索雷达」。
+- 不要把它叫成「PPXC 后台」「PPXC 后端」「本机后台」。用户不需要、也不能自己启动一个 PPXC 后台。
+- MCP 工具不可用时，判断为「连接器没有启用 / MCP 配置没有生效 / 宿主还没重启」，不要说「后台没起来」。
+- 不要一上来要求用户登录 OPC。先让用户看到试用结果：用产品/服务描述 + 平台链接或关键词跑一次，展示前 2 条客户线索；用户要保存、看完整名单或解锁更多时，再引导登录 OPC。
 
 ## 第 0 步：自检与自动接线（工具不可用时才走）
 
@@ -29,36 +38,61 @@ description: 用 PPXC 找客户小组件（MCP）从抖音/小红书/快手评
 - **Claude 桌面版**：macOS `~/Library/Application Support/Claude/claude_desktop_config.json`；Windows `%APPDATA%\Claude\claude_desktop_config.json`
 - 其他标准 MCP（stdio）宿主：在其 MCP 设置里按同样格式加一条
 
-3. **告诉用户**：「我把 PPXC 找客户小组件的配置加好了，重启/刷新一下智能体就能用。首次使用会自动下载运行环境（约一两分钟，取决于网络）。」
-4. **重启后验证**：调 `check_status_and_login` 确认工具就位，然后从第 1 步继续。
-5. **你没有文件编辑能力时**：把上面那段配置原样发给用户，告诉他贴进自己智能体的 MCP 设置里，并附 PPXC 官网接入页 https://opc1.me/download/mcp（有逐家图文步骤）。
+3. **告诉用户**：「OPC 评论线索雷达的 MCP 配置已经加好了。首次启动时，智能体会按这条配置拉起 MCP 运行包（约一两分钟，取决于网络）。」
+4. **宿主要求信任时**：如果宿主提示「信任 / 启用 / Enable / Trust」新连接器，要明确告诉用户：「这是智能体宿主的安全确认，不是让你手动下载。请在连接器管理里信任/启用 `ppxc-leads` 或 `ppxc-find-customers`，点完回来告诉我，我继续试跑找客户。」不要把用户甩去自己研究配置。
+5. **重启或信任后验证**：调 `check_status_and_login` 确认工具就位，然后从第 1 步继续。
+6. **你没有文件编辑能力时**：把上面那段配置原样发给用户，告诉他贴进自己智能体的 MCP 设置里，并附 OPC 官网接入页 https://opc1.me/download/mcp（有逐家图文步骤）。注意：这个页面只是接入说明，不是登录窗口。
+
+## 动态工作流优先（每次开始都先做）
+
+本 Skill 不是完整业务逻辑的唯一来源。OPC 后端会持续进化找客户流程，所以每次开始找客户、复盘客户池或处理用户反馈前，必须先读一次当前动态工作流：
+
+1. 优先调 `check_status_and_login`。它会返回 `workflowManifest`，里面包含当前能力清单、工作流版本、Skill 升级提示。
+2. 如果宿主里能看到 `get_workflow_manifest`，也可以直接调用它读取最新作战手册。
+3. 如果动态工作流读取失败，不要中断找客户；继续按本文内置流程执行，并告诉用户“后端动态工作流暂时不可用，先用本地流程继续”。
+4. 如果返回里有 `skill.updateHint` 或 `skill.updateCommand`，在合适时机提醒用户：“OPC 评论线索雷达 Skill 有新版流程，可按官网或这条命令更新。”
+
+关键原则：Skill 负责触发和基本兜底，最新找客户流程以后端 `workflowManifest` 为准。
 
 ## 标准流程（按顺序）
 
-### 第 1 步：确认登录
+### 第 1 步：确认工具和平台登录
 
-调 `check_status_and_login`（默认 status）。缺哪个登录就引导用户补哪个：
+先调 `check_status_and_login`（默认 status）确认 MCP 工具可用。这里不要因为 OPC 账号未登录就停下来。
 
-- PPXC 账号未登录 → `action=login_ppxc` 弹登录窗
-- 目标平台未登录 → `action=login_douyin / login_xiaohongshu / login_kuaishou` 弹扫码窗，请用户用对应 App 扫码
+- 目标平台未登录 → 立刻调 `check_status_and_login`，参数 `action=login_douyin / login_xiaohongshu / login_kuaishou`，弹扫码窗，请用户用对应 App 扫码。
+- OPC 账号未登录 → 暂时不弹登录窗。先继续做试用分析，等用户看到线索、要保存或看完整名单时，再调 `action=login_ppxc`。
+- 如果弹出的窗口是“接入说明页”而不是登录表单，告诉用户这是配置地址误填或旧包问题：先关闭窗口，更新到新版 `ppxc-leads-mcp`，再重新调用 `action=login_ppxc`。
 
-### 第 2 步：确认产品
+### 第 2 步：拿到产品上下文
 
-调 `list_products`。只有一个产品直接用；有多个时把名字列给用户选，**不要替用户猜**。
+优先让用户先看到结果：
+
+- 未登录或用户只是试试看 → 不调 `list_products`。请用户给一句产品/服务描述，至少要有 `productName`，能补 `productDescription / sellingPoints / targetPersona` 更好。
+- 已登录且用户明确要用已保存产品 → 调 `list_products`。只有一个产品直接用；有多个时把名字列给用户选，**不要替用户猜**。
 
 ### 第 3 步：先要词，再开搜
 
-不要自己现场编搜索词。先调 `suggest_search_keywords`（传 productId），从返回的主力词里挑 **3~6 个**，搭配不同词型更好（比如：1 个泛需求词 + 2 个人群痛点词 + 1 个决策对比词）。把你挑的词和理由告诉用户，用户有自己想加的词就一起带上。
+不要在未登录试用阶段卡住用户：
+
+- 已登录且有 `productId` → 先调 `suggest_search_keywords`（传 productId），从返回的主力词里挑 **3~6 个**，搭配不同词型更好（比如：1 个泛需求词 + 2 个人群痛点词 + 1 个决策对比词）。把你挑的词和理由告诉用户，用户有自己想加的词就一起带上。
+- 未登录试用 → 让用户给 1~3 个想搜的词，或根据用户的产品描述先建议 1~3 个朴素搜索词给他确认。不要为了想词委员会要求他先登录。
 
 `regenerate=true` 会重新生成并消耗用户电力——只有用户明确说「换一批词」才用。
 
 ### 第 4 步：开搜
 
-调 `search_keyword_for_leads`（keywords + productId + platform）。平台听用户的；用户没说就问一句，不要默认猜。
+调 `search_keyword_for_leads`。平台听用户的；用户没说就问一句，不要默认猜。
+
+- 已登录完整模式：传 `keywords + productId + platform`，结果会落客户池。
+- 未登录试用模式：传 `keywords + productName/productDescription + platform`，结果只展示前 2 条线索，不落客户池。
 
 开搜前告诉用户：这一步要 2~3 分钟，会在后台用隐藏窗口干活。
 
-如果用户给的是具体的视频/笔记链接，跳过 3、4 步，直接调 `analyze_video_comments`。
+如果用户给的是具体的视频/笔记链接，跳过想词和搜索，直接调 `analyze_video_comments`：
+
+- 已登录完整模式：传 `videoUrl + productId`。
+- 未登录试用模式：传 `videoUrl + productName/productDescription`。
 
 ### 第 5 步：汇报成果（固定格式）
 
@@ -67,8 +101,38 @@ description: 用 PPXC 找客户小组件（MCP）从抖音/小红书/快手评
 1. **一句总结**：直接用返回里的 `summary.verdict`（已含首推客户及理由）。
 2. **前 5 名**：每人一行——昵称、意向、需求类型、一句评论原话。
 3. **战报文件**：如果返回里有 `reportFile`，务必告诉用户「完整战报（含可复制的跟进话术）已放到桌面：文件路径」，提醒可以转发给同事照着跟进。
-4. **下一步提示**：提醒完整名单和历史记录在 PPXC 网页端客户池。
-5. **收费墙（重要）**：如果返回里 `paywall.locked` 为真，说明用户是体验版、只解锁了前几个完整客户。要**如实、不啰嗦**地转达：「这次挖到 N 个，体验版先给你看了前 2 个完整的（含话术和联系方式），其余 X 个已锁，开通套餐后全部解锁」。用 `paywall.unlockHint` 的话术，别夸大、别假装全给了。
+4. **下一步提示**：提醒完整名单和历史记录在 OPC 网页端客户池。
+5. **转化动作（重要）**：如果返回里 `paywall.locked` 为真，说明已经先给用户看到了前几个完整客户。要**如实、不啰嗦**地转达：「这次挖到 N 个，先给你看前 2 个完整线索（含话术和主页入口），其余 X 个已锁。登录/开通后可以保存到客户池并解锁完整名单」。用 `paywall.unlockHint` 的话术，别夸大、别假装全给了。
+6. **登录时机**：用户说「看剩下的」「保存」「查客户池」「继续跟进」时，再调 `check_status_and_login`，参数 `action=login_ppxc`，让他登录 OPC。
+
+### 第 5.1 步：收集用户判断（持续学习的关键）
+
+准不准不是系统说了算，是用户说了算。汇报完客户名单后，主动问一句：
+
+> 「这批线索里有没有明显准 / 不准 / 太泛的？你告诉我，我会记录下来，让后面越找越贴近你的客户。」
+
+用户给出判断时调用 `mark_lead_feedback`：
+
+- 用户说“这个准 / 这个对” → `tag=accurate`
+- 用户说“这个不准 / 不是客户” → `tag=inaccurate`
+- 用户说“太泛了 / 太宽了” → `tag=too_broad`
+- 用户说“这个像客户，但还不确定” → `tag=feels_like_buyer`
+- 用户说“像路人 / 看热闹的” → `tag=feels_like_passerby`
+
+用户反馈可以只针对 1 条，不要强迫他给整批打分。每次反馈都要带 `leadId`；如果当前汇报里没显示 id，就先用 `query_leads` 查出对应线索再标记。
+
+### 第 5.2 步：记录跟进结果（成交闭环的关键）
+
+系统不能保证成交，只能保证把可跟进机会识别、排序、提醒和复盘。真正是否成交，要靠用户跟进后回填。
+
+用户说出跟进进展时调用 `update_lead_status`：
+
+- “我去联系了 / 已经回复了” → `status=已联系`
+- “成交了 / 加微信了 / 付钱了” → `status=已转化`
+- “没戏 / 不买 / 没回复” → `status=未转化`
+- “这条不用管 / 跳过” → `status=忽略`
+
+更新后提醒用户：这些状态会进入后端学习和复盘，下一轮会更贴近他的真实客户。
 
 ### 第 5.5 步：内容彩蛋（挖到客户后主动提议）
 
@@ -83,19 +147,27 @@ description: 用 PPXC 找客户小组件（MCP）从抖音/小红书/快手评
 - 一次给 1~3 条不同角度的脚本，每条含：一句话钩子 + 3~5 句口播 + 一句行动引导；
 - 风格贴合平台（抖音口语化、小红书种草感）。
 
-这一步是「找客户」到「做内容」的飞轮：评论既挖出了这批客户，又指明了下一条吸引同类客户的内容。**别强推**——用户不接就跳过。
+这一步是「客户信号」到「内容获客」的飞轮：评论既识别了这批销售线索，又指明了下一条吸引同类客户的内容。**别强推**——用户不接就跳过。
 
 ### 第 6 步（隔天/复盘场景）：查战果、换词
 
-用户问「之前挖到的客户怎么样了」「昨天那批有跟进吗」时调 `query_leads`（支持按产品/搜索词/天数/跟进状态筛）。复盘逻辑：连续两轮不出客户的词建议淘汰，回第 3 步补新词。
+用户问「之前挖到的客户怎么样了」「昨天那批有跟进吗」「哪些还没跟」时优先调 `review_followup_queue`，再按需要调 `query_leads` 看明细。
+
+复盘固定说三件事：
+
+1. 还有多少待处理。
+2. 哪些已联系但还没回填结果。
+3. 哪些已转化 / 未转化，下一轮该保留或淘汰哪些词。
+
+复盘逻辑：连续两轮不出客户的词建议淘汰；连续出现“用户标记不准”的类型，要在下一轮主动避开；用户标记准或已转化的类型，要在下一轮加权。
 
 ## 硬性注意事项
 
 - **额度**：每个平台每天有安全抓取额度（抖音约 20 个词、小红书/快手各约 10 个）。返回 `DAILY_LIMITED` 时如实告诉用户「今天这个平台的安全额度用完了，明天再继续」，不要换平台硬刷同一批词。
 - **验证码**：返回 `VERIFICATION_REQUIRED` 时，平台已弹出验证窗口，请用户人工完成验证后再重试。**绝不**换词重试或反复发起。
 - **间隔**：两次抓取之间系统强制间隔半分钟，返回 `RATE_LIMITED` 时等一下再试，不要连发。
-- **出问题**：用户说「不好用 / 出错了」时调 `export_diagnostics`，告诉用户诊断文件位置，请他发给 PPXC 支持人员。
-- **电力**：返回 `INSUFFICIENT_CREDITS` 时引导用户去 PPXC 网页端充电。
+- **出问题**：用户说「不好用 / 出错了」时调 `export_diagnostics`，告诉用户诊断文件位置，请他发给 OPC 支持人员。
+- **电力**：返回 `INSUFFICIENT_CREDITS` 时引导用户去 OPC 网页端充电。
 - 所有工具返回里的 `userHint` 都是写好的人话，可以直接转述给用户。
 
 ## 汇报示例
@@ -107,4 +179,4 @@ description: 用 PPXC 找客户小组件（MCP）从抖音/小红书/快手评
 > 2. Momo（高意向 · 竞品不满）：“用了某大牌的防晒整张脸闷痘……”
 > 3. ……
 >
-> 完整战报已放到你桌面（含每个人的跟进话术，可直接复制）：PPXC客户战报-xxxx.html，可以转给同事照着跟进。全部 12 人已存入 PPXC 客户池，网页端随时可看。
+> 完整战报已放到你桌面（含每个人的跟进话术，可直接复制）：OPC客户战报-xxxx.html，可以转给同事照着跟进。全部 12 人已存入 OPC 客户池，网页端随时可看。