ppxc-leads-mcp 0.1.1 → 0.1.3

package/README.md

@@ -2,6 +2,10 @@
 
 把 PPXC「从评论区发现高意向客户」的能力，做成智能体可直接调用的 MCP 工具包。
 
+发布包：<https://www.npmjs.com/package/ppxc-leads-mcp>  
+官网接入页：<https://opc1.me/download/mcp>  
+公开仓库：<https://github.com/yuanjian068yuan/ppxc-leads-mcp>
+
 > **先读这两份，再动手：**
 > 1. [`AGENTS.md`](./AGENTS.md) — 本仓库的硬性边界规则（AI 协作员必读第一文件）
 > 2. [`docs/开发手册.md`](./docs/开发手册.md) — 架构、工具契约、平台适配层、验收标准
@@ -17,19 +21,29 @@
   "mcpServers": {
     "ppxc-leads": {
       "command": "npx",
-      "args": ["-y", "ppxc-leads-mcp"],
-      "env": {
-        "ELECTRON_MIRROR": "https://npmmirror.com/mirrors/electron/"
-      }
+      "args": ["-y", "ppxc-leads-mcp"]
     }
   }
 }
 ```
 
-- 首次使用会自动下载运行环境（约 100MB），国内网络保留上面的 `ELECTRON_MIRROR` 配置可显著提速。
+- 首次使用会自动下载运行环境（约 100MB）。如果下载失败，换网络重试；国内网络可在 `env` 里额外加 `ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/`。
 - 默认连 PPXC 生产站；开发联调时在 `env` 里加 `PPXC_API_BASE` 指向本地后端。
 - 装好后对智能体说「检查登录状态」，按提示完成 PPXC 登录和平台扫码即可使用。
 
+Windows 宿主如果不能直接执行 `npx`，用：
+
+```json
+{
+  "mcpServers": {
+    "ppxc-leads": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "ppxc-leads-mcp"]
+    }
+  }
+}
+```
+
 ## 一句话定位
 
 用户在智能体里一行配置装好本工具包；首次登录 PPXC 账号 + 按需扫各平台二维码；之后对智能体说「分析这条内容 / 用这个词在小红书找客户」，工具包用自带的隐藏浏览器内核抓取数据、送 PPXC 后端分析，把「总体判断 + 高意向客户 + 跟进话术 + 内容选题」直接返回给智能体。
@@ -48,6 +62,14 @@
 - **不是**浏览器插件：不依赖用户手动安装插件
 - **不是**爬虫平台：借用户本人登录态、保守频率、撞验证就请真人处理，不做任何过验证 / 共享账号的灰色手段
 
+## 隐私与安全
+
+- 平台登录态和 PPXC 登录凭证只保存在用户本机。
+- 不上传平台 token / Cookie，不把它们写进日志或诊断包。
+- 评论文本会通过 HTTPS 发送到 PPXC 后端做 AI 意向判断和话术生成。
+- 分析出的客户结果会写入用户自己的 PPXC 客户池。
+- 遇到验证码或平台安全验证时，组件只会弹出窗口让用户本人处理，不做自动绕过。
+
 ## 形态（方案 A：自带浏览器内核的 CDP MCP）
 
 ```
@@ -72,6 +94,28 @@
 | `query_leads` | 问「之前挖到的客户 / 高意向有哪些」→ 只读查客户池，支持按词/天数/状态筛 | 0.2 新增 |
 | `export_diagnostics` | 用户说「不好用 / 要反馈」→ 把运行日志打包成桌面上的诊断文件 | 已实测 |
 
+## FAQ
+
+### 需要什么环境？
+
+macOS 或 Windows，Node.js 18+，以及一个 PPXC 账号。目标平台账号由用户本人扫码登录。
+
+### 为什么不能云托管？
+
+本工具依赖用户本机的平台登录态和扫码/验证码窗口，必须在用户自己的电脑上运行。市场上架时请选择 Local / stdio 模式。
+
+### 第一次启动慢怎么办？
+
+首次会下载 Electron 浏览器内核，约 100MB。下载失败通常是网络问题，换网络重试即可；国内网络可按官网 FAQ 加镜像环境变量。
+
+### 能不能自动私信客户？
+
+不做。工具只帮助识别潜在客户、生成跟进话术和主页/来源链接，具体触达由用户本人判断和执行。
+
+### 怎么反馈问题？
+
+对智能体说「导出诊断信息」，它会在桌面生成脱敏诊断文件，发给 PPXC 支持人员即可。
+
 ## 桌面战报（0.2）
 
 两件分析工具挖到客户后，会在用户桌面自动生成一份**客户战报**（自包含网页文件，离线可开）：总览数字、行动清单（先跟谁 + 为什么）、客户卡片（评论原话 / 判断理由 / 一键复制话术 / 主页直达）、每个词的成绩单。可转发给同事直接照着跟进。

package/dist/backend/ppxc-client.js

@@ -68,6 +68,7 @@ async function analyzeComments(input) {
         productId: input.productId,
         videoUrl: input.videoUrl ?? "",
         videoDesc: input.videoDesc ?? "",
+        sourceKeyword: input.sourceKeyword ?? "",
         save: input.save !== false,
         comments: input.comments.map((c) => ({
             text: c.text,

package/dist/mcp/server.js

@@ -486,6 +486,7 @@ function createMcpServer() {
                         comments: v.comments,
                         videoUrl: itemUrl,
                         videoDesc: v.title,
+                        sourceKeyword: oc.keyword,
                         save: save !== false,
                     });
                     commentsAnalyzed += analysis.summary.commentsAnalyzed;

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "ppxc-leads-mcp",
   "productName": "PPXC Leads MCP",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "PPXC 找客户能力的 MCP 工具包：智能体可调用的抖音/小红书/快手评论客户发现工具",
   "license": "UNLICENSED",
+  "homepage": "https://opc1.me/download/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yuanjian068yuan/ppxc-leads-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yuanjian068yuan/ppxc-leads-mcp/issues"
+  },
   "main": "dist/main.js",
   "type": "commonjs",
   "bin": {