leadsradar-agent 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. package/README.md +41 -12
  2. package/README_en.md +86 -97
  3. package/leadsradar-agent.mjs +995 -4118
  4. package/package.json +27 -27
  5. package/skills/leadsradar-closer/SKILL.md +93 -0
  6. package/skills/leadsradar-creator/SKILL.md +93 -0
  7. package/skills/leadsradar-helper/SKILL.md +153 -0
  8. package/skills/leadsradar-insights/SKILL.md +124 -60
  9. package/skills/leadsradar-radar/SKILL.md +227 -0
  10. package/skills/leadsradar-assets/SKILL.md +0 -80
  11. package/skills/leadsradar-patrol/SKILL.md +0 -79
  12. package/skills/leadsradar-research/SKILL.md +0 -139
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](README_en.md) | 中文
4
4
 
5
- ![version](https://img.shields.io/badge/version-1.2.12-E63946) ![hosts](https://img.shields.io/badge/hosts-10-%E5%8D%83%E9%97%AE%E5%8A%9E%E5%85%AC%20%7C%20%E8%B1%86%E5%8C%85%20%7C%20WorkBuddy%20%7C%20Trae%20%7C%20Claude%20%7C%20Codex%20%7C%20Cherry%20%7C%20%E9%98%B6%E8%B7%83%20%7C%20DeepSeek-3B82F6) ![platform](https://img.shields.io/badge/platform-%E5%B0%8F%E7%BA%A2%E4%B9%A6%20%7C%20%E6%8A%96%E9%9F%B3-8A8A8C)
5
+ ![version](https://img.shields.io/badge/version-1.0.0-E63946) ![hosts](https://img.shields.io/badge/hosts-WorkBuddy%20%7C%20%E8%B1%86%E5%8C%85%E5%B7%A5%E4%BD%9C%20%7C%20%E5%8D%83%E9%97%AE%E5%8A%9E%E5%85%AC%20%7C%20Trae%20%7C%20DeepSeek-3B82F6) ![platform](https://img.shields.io/badge/platform-%E5%B0%8F%E7%BA%A2%E4%B9%A6%20%7C%20%E6%8A%96%E9%9F%B3-8A8A8C)
6
6
 
7
7
  > 把你的 AI 助手变成获客雷达的远程驾驶员——**手机上发一句话，电脑上的探栗插件替你跑腿**。
8
8
 
@@ -39,12 +39,13 @@ Chrome 探栗插件（数据全部在本机浏览器内采集）
39
39
 
40
40
  | 技能 | 一句话 | 状态 |
41
41
  |---|---|---|
42
- | **[随手调研](skills/leadsradar-research/)** | 发作品/账号/关键词/截图，立刻得到客户线索与赛道洞察 | ✅ 可用 |
43
- | **[素材管家](skills/leadsradar-assets/)** | 发作品说一句话——存选题、下无水印素材、提文案 | ✅ 可用 |
44
- | **[对标巡逻](skills/leadsradar-patrol/)** | 扫一遍对标和自己的号——谁更新了、谁爆了 | ✅ 可用 |
45
- | **[数据问答](skills/leadsradar-insights/)** | 张口就问：选题仓库、作品、账号、评论、研究报告 | ✅ 可用 |
42
+ | **[情报栗](skills/leadsradar-radar/)** | 发作品/账号/关键词「探一下」——现采现报：客户线索、赛道机会、对标巡逻 | ✅ 可用 |
43
+ | **[洞察栗](skills/leadsradar-insights/)** | 拆解爆款为什么爆、查历史研究报告并解读成人话 | ✅ 可用 |
44
+ | **[创作栗](skills/leadsradar-creator/)** | 发作品说一句话——存选题、下无水印素材、提文案 | ✅ 可用 |
45
+ | **[成交栗](skills/leadsradar-closer/)** | 从评论区挖客户——意向分级、跟进名单、可直接发的回复话术 | ✅ 可用 |
46
+ | **[管家栗](skills/leadsradar-helper/)** | 「栗子在吗」的应答前台——查连接登录、报库存、答教程 | ✅ 可用 |
46
47
 
47
- 状态说明：四技能全量可用——数据问答已支持查本地缓存的四类 AI 研究报告（作品拆解/账号研究/赛道研究/账号复盘，附 web 直达链接）；监控/档案/日报类查询通道开发中，上线后技能自动点亮。
48
+ 状态说明：五技能全量可用（⭐R53 四大数字员工重组：随手调研+对标巡逻合并为情报栗、数据问答升级洞察栗、素材管家更名创作栗、成交栗/管家栗新建）——洞察栗支持查本地缓存的四类 AI 研究报告（作品拆解/账号研究/赛道研究/账号复盘，附 web 直达链接）；监控/档案/日报类查询通道开发中，上线后技能自动点亮。
48
49
 
49
50
  **唤醒词**：对装好技能的 AI 说 **「栗子」**（称呼，如「栗子，存一下这个选题」）或 **「探一下」**（动作，如「探一下：家装获客这个词还有机会吗」）即可调用——「探栗」「线索雷达」也认；没有唤醒词但意图明确时同样会触发。
50
51
 
@@ -58,7 +59,7 @@ Chrome 探栗插件（数据全部在本机浏览器内采集）
58
59
 
59
60
  **方式一 · WorkBuddy / 豆包工作（推荐，全自动）**
60
61
 
61
- 1. 打开插件**设置页 → 智能体接管**，选择你的宿主
62
+ 1. 打开插件**设置页 → 智能体连接**，选择你的宿主
62
63
  2. 点**「一键复制 XX 提示词」**（接入包自动下载到本机）
63
64
  3. 粘贴给你的 AI，照它提示操作——你唯一要动手的是在插件里**核对指纹码后点「批准」**
64
65
 
@@ -72,17 +73,45 @@ Chrome 探栗插件（数据全部在本机浏览器内采集）
72
73
 
73
74
  </details>
74
75
 
75
- **方式二 · Codex / Claude Desktop 等 STDIO MCP 宿主（手动）**
76
+ **方式二 · Trae（一键导入）**
77
+
78
+ 在浏览器地址栏打开下面的链接，Trae 会自动唤起并填好配置（国内版；海外版把前缀 `trae-cn` 换成 `trae`）：
79
+
80
+ ```
81
+ trae-cn://trae.ai-ide/mcp-import?type=stdio&name=leadsradar&config=eyJtY3BTZXJ2ZXJzIjp7ImxlYWRzcmFkYXIiOnsiY29tbWFuZCI6Im5weCIsImFyZ3MiOlsiLXkiLCJsZWFkc3JhZGFyLWFnZW50Il0sImVudiI6eyJMRUFEU1JBREFSX0FHRU5UX0hPU1QiOiJ0cmFlIn19fX0%3D
82
+ ```
83
+
84
+ 首次使用会自动从 npm 拉取 [`leadsradar-agent`](https://www.npmjs.com/package/leadsradar-agent)，然后在探栗插件里核对指纹并批准配对即可。
85
+
86
+ **方式三 · DeepSeek（DSH 官方插件）**
76
87
 
77
88
  ```bash
78
- codex plugin marketplace add https://github.com/Kaochicken/leadsradar-skills
89
+ dsh plugin add leadsradar-dsh-plugin
90
+ ```
91
+
92
+ npm 包 [`leadsradar-dsh-plugin`](https://www.npmjs.com/package/leadsradar-dsh-plugin) 已发布。装完对 DeepSeek 说「检查探栗连接」，按提示在插件里批准配对。若你的 DSH 版本添加插件只认本地路径，克隆本仓库后直接添加 `dsh-plugin/` 文件夹即可。
93
+
94
+ **方式四 · 千问办公（STDIO 连接器）**
95
+
96
+ 左侧**连接器 → 添加 → 粘贴 JSON**（npx 形态无需下载文件）：
97
+
98
+ ```json
99
+ {
100
+ "mcpServers": {
101
+ "leadsradar": {
102
+ "command": "npx",
103
+ "args": ["-y", "leadsradar-agent"],
104
+ "env": { "LEADSRADAR_AGENT_HOST": "qwen-office" }
105
+ }
106
+ }
107
+ }
79
108
  ```
80
109
 
81
- 或手动配置：命令 `node`，参数为 `leadsradar-agent.mjs` 绝对路径，环境变量 `LEADSRADAR_AGENT_HOST` 填宿主标识。接入包零依赖单文件，无需 npm install。
110
+ 其他 STDIO MCP 宿主同理：命令 `node`，参数为 `leadsradar-agent.mjs` 绝对路径（或直接 `npx -y leadsradar-agent`），环境变量 `LEADSRADAR_AGENT_HOST` 填宿主标识。接入包零依赖单文件，无需 npm install。
82
111
 
83
112
  ### 第 3 步：装官方技能
84
113
 
85
- 把 `skills/` 下需要的 `SKILL.md` 内容加入宿主技能库（WorkBuddy 技能页 / 豆包智能体指令 / Codex 插件配置）。**建议从「随手调研」开始——装完当天就能用。**
114
+ 把 `skills/` 下需要的 `SKILL.md` 内容加入宿主技能库（WorkBuddy 技能页 / 豆包智能体指令 / 千问办公技能库）。**建议从「随手调研」开始——装完当天就能用。**
86
115
 
87
116
  ## 安全与隐私
88
117
 
@@ -102,7 +131,7 @@ codex plugin marketplace add https://github.com/Kaochicken/leadsradar-skills
102
131
 
103
132
  ```
104
133
  ├── leadsradar-agent.mjs # 接入包（零依赖单文件，esbuild 自包含）
105
- ├── skills/ # 四个官方技能
134
+ ├── skills/ # 五个官方技能
106
135
  ├── package.json
107
136
  └── README.md
108
137
  ```
package/README_en.md CHANGED
@@ -1,97 +1,86 @@
1
- # LeadsRadar Agent
2
-
3
- English | [中文](README.md)
4
-
5
- ![version](https://img.shields.io/badge/version-1.0.0-E63946) ![hosts](https://img.shields.io/badge/hosts-WorkBuddy%20%7C%20Doubao%20%7C%20DeepSeek-3B82F6) ![platform](https://img.shields.io/badge/platform-Xiaohongshu%20%7C%20Douyin-8A8A8C)
6
-
7
- > Turn your AI assistant into a remote pilot for the LeadsRadar lead-gen extension — **one sentence from your phone, the browser extension on your PC does the legwork.**
8
-
9
- ```
10
- Your phone (Doubao / WorkBuddy app)
11
- │ ① "Any customer leads in this post's comments?"
12
- ▼
13
- AI assistant on your PC (host, adapter from this repo)
14
- │ ② STDIO MCP calls LeadsRadar tools
15
- ▼
16
- LeadsRadar Chrome extension (all data collected inside your own browser)
17
- │ ③ Results flow back → AI turns them into plain language
18
- ▼
19
- Your phone (lead report / patrol digest / topic card)
20
- ```
21
-
22
- > **Not standalone**: requires the [LeadsRadar browser extension](https://leadsradar.cn), plus a one-time pairing approval in the extension. Everything runs on your machine — collected data never leaves your browser.
23
-
24
- ## Try saying
25
-
26
- - **"Check this post's comments for customer leads"** — paste a Xiaohongshu/Douyin link, get a four-tier lead report: 🟢 ready-to-buy, 🟠 interested, 🟡 in-need, ⚪ noise — including who to follow up first.
27
- - **"Patrol my benchmark accounts — anyone gone viral?"** — get a digest: who updated, who blew up (and why), whose posting rhythm shifted.
28
- - **"Extract the copy from this post and save it as a topic"** — get 3 title-hook variants + full script + a topic card.
29
- - **"Is there still room in the 'home-renovation leads' niche?"** — get a niche brief: competition level, top-player patterns, 3 gap topics.
30
-
31
- ## Official Skills
32
-
33
- Each skill is a `SKILL.md` you drop into your host's skill/instruction library:
34
-
35
- | Skill | One-liner | Status |
36
- |---|---|---|
37
- | **[Quick Research](skills/leadsradar-research/)** | Send a link / keyword / screenshot, get customer leads & niche insights instantly | ✅ |
38
- | **[Asset Butler](skills/leadsradar-assets/)** | Send a post link + one sentence — save topic, download media, extract copy | ✅ |
39
- | **[Benchmark Patrol](skills/leadsradar-patrol/)** | Scan benchmark accounts — who updated, who went viral | ✅ |
40
- | **[Data Q&A](skills/leadsradar-insights/)** | Just ask: topic library, posts, accounts, comments, research reports | ✅ |
41
-
42
- **Wake words**: address your AI with **"Lizi"（栗子）** (e.g. "栗子，存一下这个选题 / Lizi, save this topic") or start with **"探一下 / tan yi xia"** (e.g. "探一下：家装获客这个词还有机会吗") to invoke the skills — "探栗 / LeadsRadar" also works; clear intent triggers them even without a wake word.
43
-
44
- ## 3-minute setup
45
-
46
- 1. **Install the LeadsRadar extension** from [leadsradar.cn](https://leadsradar.cn) and sign in.
47
- 2. **Feed the adapter to your AI assistant**
48
- - **WorkBuddy / Doubao Work (recommended, fully automated)**: open the extension's *Settings → Agent takeover*, pick your host, click "one-click copy prompt", paste it to your AI. The only manual step: verify the device fingerprint in the extension and click *Approve*.
49
- - **Coding agents (Claude Code / Codex CLI / Cursor / Gemini CLI — any STDIO MCP host, manual)**:
50
- Get `leadsradar-agent.mjs` first (clone this repo, or click "one-click copy" for any host in the extension's *Settings → Agent takeover* — it auto-downloads to your Downloads folder), then configure:
51
-
52
- Claude Code (one command):
53
- ```bash
54
- claude mcp add leadsradar -e LEADSRADAR_AGENT_HOST=claude -- node /absolute/path/to/leadsradar-agent.mjs
55
- ```
56
-
57
- Cursor / generic (`mcp.json`):
58
- ```json
59
- {
60
- "mcpServers": {
61
- "leadsradar": {
62
- "command": "node",
63
- "args": ["/absolute/path/to/leadsradar-agent.mjs"],
64
- "env": { "LEADSRADAR_AGENT_HOST": "claude" }
65
- }
66
- }
67
- }
68
- ```
69
-
70
- Codex CLI (`~/.codex/config.toml`):
71
- ```toml
72
- [mcp_servers.leadsradar]
73
- command = "node"
74
- args = ["/absolute/path/to/leadsradar-agent.mjs"]
75
- env = { LEADSRADAR_AGENT_HOST = "claude" }
76
- ```
77
-
78
- Then say "check LeadsRadar connection" to your AI, and **verify the fingerprint + click Approve** in the extension's settings. Zero-dependency single file, no `npm install`.
79
- 3. **Install the skills** — add the `SKILL.md` files under `skills/` to your host's skill library. **Start with Quick Research** — usable the day you install it.
80
-
81
- ## Security & privacy
82
-
83
- - **Fully local**: the only network hop is `127.0.0.1`; no cloud relay.
84
- - **Pair-and-approve**: every AI device must be manually approved after fingerprint verification inside the extension.
85
- - **Rate limits**: lists 300/batch & 600/30min, comments 500/post, details 20/batch & 100/30min — enforced automatically to protect your platform accounts.
86
- - **No extension source**: this repo ships only the protocol adapter; the LeadsRadar extension core stays closed-source.
87
- - Never paste cookies, tokens, or device private keys into issues or logs.
88
-
89
- ## Community skills
90
-
91
- Beyond the official four, PR your own playbooks (Feishu sync, private-domain SOP, daily digest push…) as `SKILL.md` — merged ones get listed here with your name on them.
92
-
93
- ## Support
94
-
95
- - Website: [leadsradar.cn](https://leadsradar.cn)
96
- - Usage logs: extension Settings → *Execution details*
97
- - Issues welcome for bugs & skill improvements
1
+ # LeadsRadar Agent
2
+
3
+ English | [中文](README.md)
4
+
5
+ ![version](https://img.shields.io/badge/version-1.0.0-E63946) ![hosts](https://img.shields.io/badge/hosts-WorkBuddy%20%7C%20Doubao%20%7C%20Qwen%20Office%20%7C%20Trae%20%7C%20DeepSeek-3B82F6) ![platform](https://img.shields.io/badge/platform-Xiaohongshu%20%7C%20Douyin-8A8A8C)
6
+
7
+ > Turn your AI assistant into a remote pilot for the LeadsRadar lead-gen extension — **one sentence from your phone, the browser extension on your PC does the legwork.**
8
+
9
+ ```
10
+ Your phone (Doubao / WorkBuddy app)
11
+ │ ① "Any customer leads in this post's comments?"
12
+ ▼
13
+ AI assistant on your PC (host, adapter from this repo)
14
+ │ ② STDIO MCP calls LeadsRadar tools
15
+ ▼
16
+ LeadsRadar Chrome extension (all data collected inside your own browser)
17
+ │ ③ Results flow back → AI turns them into plain language
18
+ ▼
19
+ Your phone (lead report / patrol digest / topic card)
20
+ ```
21
+
22
+ > **Not standalone**: requires the [LeadsRadar browser extension](https://leadsradar.cn), plus a one-time pairing approval in the extension. Everything runs on your machine — collected data never leaves your browser.
23
+
24
+ ## Try saying
25
+
26
+ - **"Check this post's comments for customer leads"** — paste a Xiaohongshu/Douyin link, get a four-tier lead report: 🟢 ready-to-buy, 🟠 interested, 🟡 in-need, ⚪ noise — including who to follow up first.
27
+ - **"Patrol my benchmark accounts — anyone gone viral?"** — get a digest: who updated, who blew up (and why), whose posting rhythm shifted.
28
+ - **"Extract the copy from this post and save it as a topic"** — get 3 title-hook variants + full script + a topic card.
29
+ - **"Is there still room in the 'home-renovation leads' niche?"** — get a niche brief: competition level, top-player patterns, 3 gap topics.
30
+
31
+ ## Official Skills
32
+
33
+ Each skill is a `SKILL.md` you drop into your host's skill/instruction library:
34
+
35
+ | Skill | One-liner | Status |
36
+ |---|---|---|
37
+ | **[Radar · Intel Chestnut](skills/leadsradar-radar/)** | Send a link / keyword + "tan yi xia" — instant lead reports, niche opportunities & benchmark patrol | ✅ |
38
+ | **[Insights Chestnut](skills/leadsradar-insights/)** | Break down why a post went viral; look up & translate past research reports | ✅ |
39
+ | **[Creator Chestnut](skills/leadsradar-creator/)** | Send a post link + one sentence — save topic, download media, extract copy | ✅ |
40
+ | **[Closer Chestnut](skills/leadsradar-closer/)** | Mine customers from comments — intent grading, follow-up lists, ready-to-send replies | ✅ |
41
+ | **[Helper Chestnut](skills/leadsradar-helper/)** | Front desk for the "Lizi" wake word — check connection/login, report inventory, answer FAQs | ✅ |
42
+
43
+ **Wake words**: address your AI with **"Lizi"（栗子）** (e.g. "栗子，存一下这个选题 / Lizi, save this topic") or start with **"探一下 / tan yi xia"** (e.g. "探一下：家装获客这个词还有机会吗") to invoke the skills — "探栗 / LeadsRadar" also works; clear intent triggers them even without a wake word.
44
+
45
+ ## 3-minute setup
46
+
47
+ 1. **Install the LeadsRadar extension** from [leadsradar.cn](https://leadsradar.cn) and sign in.
48
+ 2. **Feed the adapter to your AI assistant**
49
+ - **WorkBuddy / Doubao Work (recommended, fully automated)**: open the extension's *Settings → Agent takeover*, pick your host, click "one-click copy prompt", paste it to your AI. The only manual step: verify the device fingerprint in the extension and click *Approve*.
50
+ - **Trae (one-click import)**: open the deep link below in your browser — Trae launches with the config pre-filled (uses [`leadsradar-agent`](https://www.npmjs.com/package/leadsradar-agent) from npm; mainland China builds use the `trae-cn://` prefix):
51
+ ```
52
+ trae://trae.ai-ide/mcp-import?type=stdio&name=leadsradar&config=eyJtY3BTZXJ2ZXJzIjp7ImxlYWRzcmFkYXIiOnsiY29tbWFuZCI6Im5weCIsImFyZ3MiOlsiLXkiLCJsZWFkc3JhZGFyLWFnZW50Il0sImVudiI6eyJMRUFEU1JBREFSX0FHRU5UX0hPU1QiOiJ0cmFlIn19fX0%3D
53
+ ```
54
+ - **DeepSeek (DSH plugin)**: `dsh plugin add leadsradar-dsh-plugin` — published on [npm](https://www.npmjs.com/package/leadsradar-dsh-plugin). Then say "check LeadsRadar connection" and approve the pairing in the extension.
55
+ - **Qwen Office (STDIO connector)**: left sidebar → *Connectors → Add* → paste this JSON:
56
+ ```json
57
+ {
58
+ "mcpServers": {
59
+ "leadsradar": {
60
+ "command": "npx",
61
+ "args": ["-y", "leadsradar-agent"],
62
+ "env": { "LEADSRADAR_AGENT_HOST": "qwen-office" }
63
+ }
64
+ }
65
+ }
66
+ ```
67
+ - **Any other STDIO MCP host (manual)**: command `node`, args = absolute path to `leadsradar-agent.mjs` (or just `npx -y leadsradar-agent`), env `LEADSRADAR_AGENT_HOST` = your host id. Then say "check LeadsRadar connection" to your AI, and **verify the fingerprint + click Approve** in the extension's settings. Zero-dependency single file, no `npm install`.
68
+ 3. **Install the skills** — add the `SKILL.md` files under `skills/` to your host's skill library. **Start with Quick Research** — usable the day you install it.
69
+
70
+ ## Security & privacy
71
+
72
+ - **Fully local**: the only network hop is `127.0.0.1`; no cloud relay.
73
+ - **Pair-and-approve**: every AI device must be manually approved after fingerprint verification inside the extension.
74
+ - **Rate limits**: lists 300/batch & 600/30min, comments 500/post, details 20/batch & 100/30min — enforced automatically to protect your platform accounts.
75
+ - **No extension source**: this repo ships only the protocol adapter; the LeadsRadar extension core stays closed-source.
76
+ - Never paste cookies, tokens, or device private keys into issues or logs.
77
+
78
+ ## Community skills
79
+
80
+ Beyond the official five, PR your own playbooks (Feishu sync, private-domain SOP, daily digest push…) as `SKILL.md` — merged ones get listed here with your name on them.
81
+
82
+ ## Support
83
+
84
+ - Website: [leadsradar.cn](https://leadsradar.cn)
85
+ - Usage logs: extension Settings → *Execution details*
86
+ - Issues welcome for bugs & skill improvements