# 找客户 · Find Customers｜销售线索与评论区获客 (npm · ppxc-leads-mcp)

Find sales leads in Douyin, Xiaohongshu, and Kuaishou comments; installs its Skill with approval.

- Trust score: 50/100 (low)
- Change this week: +12
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `ppxc-leads-mcp`: 50/100 (this document), [markdown](https://verifymcp.io/servers/yuanjian068yuan-ppxc-leads-mcp/ppxc-leads-mcp.md), [page](https://verifymcp.io/servers/yuanjian068yuan-ppxc-leads-mcp/ppxc-leads-mcp)

## Channel facts

- Registry: `npm`
- Package: `ppxc-leads-mcp`
- Version: `0.1.28`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 6/100
  - Repository check failed: no source repository is declared.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: the license (UNLICENSED) isn't a recognized OSI-approved license.
  - Actively maintained (last published 15 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 42/100
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 2312 tokens (~136/item across 17 items; 17 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 96/100
  - 94% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add yuanjian068yuan-ppxc-leads-mcp -- npx -y ppxc-leads-mcp
```

### Codex

```bash
codex mcp add yuanjian068yuan-ppxc-leads-mcp -- npx -y ppxc-leads-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "yuanjian068yuan-ppxc-leads-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "ppxc-leads-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add yuanjian068yuan-ppxc-leads-mcp --command npx --arg -y --arg ppxc-leads-mcp
```

### Hermes

```yaml
mcp_servers:
  yuanjian068yuan-ppxc-leads-mcp:
    command: "npx"
    args: ["-y", "ppxc-leads-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "yuanjian068yuan-ppxc-leads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ppxc-leads-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 50, +50)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional regression] License: unverified → fail
- [functional improvement] Schema quality: unverified → fair
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Tool coverage: unverified → 94
- [functional] Licence: UNLICENSED

### 2026-08-01 (score 0, −14)

- [functional regression] Tool coverage: 94 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-31 (score 14, −6)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 20, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 38)

First indexed and scored.

## MCP tools (17)

### `setup_companion_skill` (~173 tokens)

检查或安装与本 MCP 配套的找客户 Agent Skill。首次使用找客户前先调用 action=status（只读）；如果返回 missing/outdated，必须先向用户说明目标目录并取得明确同意，之后才可调用 action=install、指定当前宿主 target 并传 confirm=true。严禁未经用户同意安装或更新 Skill。

Input parameters:

- `action` (string): status=只读检查；install=在用户明确同意后安装或更新。默认 status。
- `confirm` (boolean): 只有用户已经明确同意写入显示的 Skill 目录时才传 true。status 不需要。
- `target` (string): 当前智能体宿主。自动检测不唯一时必须明确指定，不能同时安装到多个宿主。

### `analyze_video_comments` (~310 tokens)

分析单条抖音/小红书/快手内容链接的公开评论，生成客户线索和在线战报。

Input parameters:

- `commentMaxAgeDays` (integer): 只分析最近 N 天的评论，支持 3、7。不传默认近 7 天；不会分析 7 天外的评论。
- `maxComments` (integer): 最多读多少条评论，默认 30。
- `platform` (string): 可选：douyin | xiaohongshu | kuaishou。不传则从链接自动识别。
- `problemSolved` (string): 未登录试用时可填：解决的痛点。
- `productDescription` (string): 未登录试用时填写：适合谁、解决什么问题、主要卖点。
- `productId` (string): 已登录用户的产品 id；试用扫描可不传。
- `productName` (string): 未登录试用时填写：用户卖的产品/服务名称。
- `save` (boolean): 是否落客户池，默认 false。只有用户明确要保存完整名单到客户池时才传 true。
- `sellingPoints` (array): 未登录试用时可填：卖点列表。
- `targetPersona` (string): 未登录试用时可填：目标人群。
- `videoUrl` (string, required): 内容链接（抖音视频/小红书笔记/快手视频）或 ID。

### `cancel_current_search_run` (~84 tokens)

取消当前正在运行的搜索任务，释放任务锁。

Input parameters:

- `batchId` (string): 可选：要取消的 start_batch_search_run 返回的 batchId。
- `reason` (string): 取消原因，用于诊断和最终状态展示。
- `runId` (string): 可选：要取消的 start_search_run 返回的 runId。

### `check_status_and_login` (~62 tokens)

检查 OPC 与平台登录状态；需要时弹出对应平台或 OPC 登录窗口。

Input parameters:

- `action` (string): status=只查不弹窗；login_* 为显式登录。试用扫描前不要先调用 login_ppxc。

### `export_diagnostics` (~31 tokens)

导出脱敏诊断信息，方便排查 MCP 安装、登录、搜索和运行问题。

### `get_batch_search_run_status` (~49 tokens)

轮询批量关键词搜索任务状态，获取进度、战报链接和最终汇总。

Input parameters:

- `batchId` (string, required): start_batch_search_run 返回的 batchId。

### `get_search_run_status` (~47 tokens)

轮询单次关键词搜索任务状态，获取进度、战报链接和客户线索。

Input parameters:

- `runId` (string, required): start_search_run 返回的 runId。

### `get_workflow_manifest` (~28 tokens)

读取后端最新找客户工作流、能力清单和 Skill 更新提示。

### `list_products` (~28 tokens)

列出用户在 OPC 保存的产品，用于客户池、保存和复盘流程。

### `mark_lead_feedback` (~116 tokens)

记录用户对客户线索质量的反馈，用于后续优化。

Input parameters:

- `leadId` (string, required): 客户线索 id，来自 query_leads 或找客户结果。
- `reason` (string): 用户补充原因，最多会由后端截取保存。
- `tag` (string, required): 用户判断：accurate=准；inaccurate=不准；too_broad=太泛；feels_like_buyer=像客户；feels_like_passerby=像路人。

### `query_leads` (~113 tokens)

查询已保存的客户池线索，支持按产品、平台、关键词等条件回看。

Input parameters:

- `days` (integer): 只看最近 N 天入池的客户。
- `keyword` (string): 只看这个搜索词挖到的客户。
- `limit` (integer): 最多返回几条，默认 30。
- `productId` (string): 产品 id；不传则查当前账号全部产品。
- `status` (string): 按跟进状态过滤。

### `review_followup_queue` (~86 tokens)

复盘客户池里的待跟进线索，生成跟进建议。

Input parameters:

- `days` (integer): 只看最近 N 天入池客户，默认 7 天。
- `limit` (integer): 每组最多返回几条样例，默认 5。
- `productId` (string): 产品 id；不传则查当前账号全部产品。

### `search_keyword_for_leads` (~413 tokens)

LEGACY 同步关键词搜索入口；长任务优先使用 start_search_run 或 start_batch_search_run。

Input parameters:

- `allowLegacySync` (boolean): 只有宿主缺少 async/batch 工具且用户明确要求极小同步扫描时才可传 true。
- `commentMaxAgeDays` (integer): 只分析最近 N 天的评论，支持 3、7。不传默认近 7 天；不会分析 7 天外的评论。
- `hostProfile` (string): 宿主名称；WorkBuddy/压力测试场景传 workbuddy 后本 legacy 工具会被拒绝。
- `keywords` (array, required): 搜索词列表，最多 10 个。
- `maxComments` (integer): 每条内容最多读多少条评论。
- `maxVideosPerKeyword` (integer): 每个关键词最多读几条内容，默认 1。
- `platform` (string, required): 在哪个平台搜：douyin | xiaohongshu | kuaishou。
- `pressureTest` (boolean): 是否压力测试；true 时禁止使用本 legacy 同步入口。
- `problemSolved` (string): 未登录试用时可填：解决的痛点。
- `productDescription` (string): 未登录试用时填写：适合谁、解决什么问题、主要卖点。
- `productId` (string): 已登录用户的产品 id；试用扫描可不传。
- `productName` (string): 未登录试用时填写：用户卖的产品/服务名称。
- `save` (boolean): 是否落客户池，默认 false。试用扫描不要传 true。
- `sellingPoints` (array): 未登录试用时可填：卖点列表。
- `targetPersona` (string): 未登录试用时可填：目标人群。
- `useCase` (string): 调用场景；batch、pressure_test、long_task、async_workflow 会被拒绝。

### `start_batch_search_run` (~282 tokens)

提交批量关键词搜索计划，由 MCP 内部串行执行，适合 WorkBuddy 和压力测试。

Input parameters:

- `commentMaxAgeDays` (integer): 只分析最近 N 天的评论，支持 3、7。不传默认近 7 天；不会分析 7 天外的评论。
- `maxComments` (integer): 每条内容最多读多少条评论。
- `plan` (array, required): 批量计划，MCP 会按顺序串行执行。
- `platform` (string, required): 在哪个平台搜：douyin | xiaohongshu | kuaishou。
- `problemSolved` (string): 未登录试用时可填：解决的痛点。
- `productDescription` (string): 未登录试用时填写：适合谁、解决什么问题、主要卖点。
- `productId` (string): 已登录用户的产品 id；试用扫描可不传。
- `productName` (string): 未登录试用时填写：用户卖的产品/服务名称。
- `save` (boolean): 是否落客户池，默认 false。试用扫描不要传 true。
- `sellingPoints` (array): 未登录试用时可填：卖点列表。
- `targetPersona` (string): 未登录试用时可填：目标人群。

### `start_search_run` (~372 tokens)

启动单批关键词搜索任务，返回 runId 后用 get_search_run_status 轮询。

Input parameters:

- `commentMaxAgeDays` (integer): 只分析最近 N 天的评论，支持 3、7。不传默认近 7 天；不会分析 7 天外的评论。
- `committeeKeywordLimit` (integer): 从后端想词委员会最多取几个词，默认 10。
- `keywords` (array): 搜索词列表；最多 10 个。
- `maxComments` (integer): 每条内容最多读多少条评论。
- `maxVideosPerKeyword` (integer): 每个关键词最多读几条内容；快手建议先 1。
- `platform` (string, required): 在哪个平台搜：douyin | xiaohongshu | kuaishou。
- `problemSolved` (string): 未登录试用时可填：解决的痛点。
- `productDescription` (string): 未登录试用时填写：适合谁、解决什么问题、主要卖点。
- `productId` (string): 已登录用户的产品 id；试用扫描可不传。
- `productName` (string): 未登录试用时填写：用户卖的产品/服务名称。
- `regenerateCommitteeKeywords` (boolean): 是否强制触发后端重新想词；只有用户明确要换一批词时传 true。
- `save` (boolean): 是否落客户池，默认 false。试用扫描不要传 true。
- `sellingPoints` (array): 未登录试用时可填：卖点列表。
- `targetPersona` (string): 未登录试用时可填：目标人群。
- `useCommitteeKeywords` (boolean): 是否强制使用后端想词委员会。

### `suggest_search_keywords` (~66 tokens)

根据产品信息生成或预览搜索关键词。

Input parameters:

- `productId` (string, required): 产品 id，用于读取后端想词委员会。
- `regenerate` (boolean): 强制重新生成一轮（会消耗电力）。默认 false：直接读现成词单。

### `update_lead_status` (~52 tokens)

更新客户线索跟进状态。

Input parameters:

- `leadId` (string, required): 客户线索 id，来自 query_leads 或找客户结果。
- `status` (string, required): 新的跟进状态。

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/yuanjian068yuan-ppxc-leads-mcp/ppxc-leads-mcp#diagnostics

## Score history

- 2026-08-03: 50
- 2026-08-02: 50
- 2026-08-01: 0
- 2026-07-31: 14
- 2026-07-30: 20
- 2026-07-28: 38
- 2026-07-27: 38

## Links

- npm package: https://www.npmjs.com/package/ppxc-leads-mcp
- Socket report: https://socket.dev/npm/package/ppxc-leads-mcp
- Changelog RSS feed: https://verifymcp.io/servers/yuanjian068yuan-ppxc-leads-mcp/ppxc-leads-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/yuanjian068yuan-ppxc-leads-mcp/ppxc-leads-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/yuanjian068yuan-ppxc-leads-mcp/ppxc-leads-mcp