leadsradar-agent 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,118 @@
-# Temporary Holding Version
+# 探栗 Agent（LeadsRadar Agent）
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[English](README_en.md) | 中文
+
+![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)
+
+> 把你的 AI 助手变成获客雷达的远程驾驶员——**手机上发一句话，电脑上的探栗插件替你跑腿**。
+
+```
+你的手机（豆包 / WorkBuddy App）
+   │  ① 随口一句「这条作品里有什么线索？」
+   ▼
+电脑上的 AI 助手（宿主，本仓库接入包）
+   │  ② STDIO MCP 调用探栗工具
+   ▼
+Chrome 探栗插件（数据全部在本机浏览器内采集）
+   │  ③ 结果原路返回 → AI 整理成人话
+   ▼
+你的手机（收到线索速报 / 巡逻摘要 / 选题卡）
+```
+
+> **它不能单独使用**：需要先安装[探栗浏览器插件](https://leadsradar.cn)并在插件里批准你的 AI 设备。全程本机运行，采集数据不离开浏览器。
+
+## 例如，你可以这样说
+
+装好后，在手机上对你的 AI 助手说：
+
+> **「帮我看看这条笔记评论区里有没有客户」**——甩一个小红书链接，收回一份四色线索速报：🟢 准备买的、🟠 有意向的、🟡 有需求的，连「先跟谁、怎么开口」都给你。
+
+> **「扫一遍我的对标账号，谁出爆款了？」**——收回巡逻摘要：谁更新了、谁爆了（爆在哪）、节奏有没有变。
+
+> **「这篇的文案提出来，顺便存个选题」**——收回标题钩子 3 变体 + 口播全文 + 选题卡。
+
+> **「家装获客这个词还有机会吗？」**——收回赛道速览：竞争度、头部套路、3 个空档选题。
+
+## 官方技能（Skills）
+
+每个技能是一个 `SKILL.md`，装进宿主的技能/指令库即生效：
+
+| 技能 | 一句话 | 状态 |
+|---|---|---|
+| **[随手调研](skills/leadsradar-research/)** | 发作品/账号/关键词/截图，立刻得到客户线索与赛道洞察 | ✅ 可用 |
+| **[素材管家](skills/leadsradar-assets/)** | 发作品说一句话——存选题、下无水印素材、提文案 | ✅ 可用 |
+| **[对标巡逻](skills/leadsradar-patrol/)** | 扫一遍对标和自己的号——谁更新了、谁爆了 | ✅ 可用 |
+| **[数据问答](skills/leadsradar-insights/)** | 张口就问：选题仓库、作品、账号、评论、研究报告 | ✅ 可用 |
+
+状态说明：四技能全量可用——数据问答已支持查本地缓存的四类 AI 研究报告（作品拆解/账号研究/赛道研究/账号复盘，附 web 直达链接）；监控/档案/日报类查询通道开发中，上线后技能自动点亮。
+
+**唤醒词**：对装好技能的 AI 说 **「栗子」**（称呼，如「栗子，存一下这个选题」）或 **「探一下」**（动作，如「探一下：家装获客这个词还有机会吗」）即可调用——「探栗」「线索雷达」也认；没有唤醒词但意图明确时同样会触发。
+
+## 3 分钟接入
+
+### 第 1 步：安装探栗插件
+
+[Chrome 应用商店](https://leadsradar.cn) / [官网 leadsradar.cn](https://leadsradar.cn) 安装并登录。
+
+### 第 2 步：把接入包装进你的 AI 助手
+
+**方式一 · WorkBuddy / 豆包工作（推荐，全自动）**
+
+1. 打开插件**设置页 → 智能体接管**，选择你的宿主
+2. 点**「一键复制 XX 提示词」**（接入包自动下载到本机）
+3. 粘贴给你的 AI，照它提示操作——你唯一要动手的是在插件里**核对指纹码后点「批准」**
+
+<details>
+<summary>豆包工作实际接入过程实录（2026-10 实测）</summary>
+
+1. AI 先跑 `where node` 取 node 绝对路径——若返回多条，**选不含 `.workbuddy` 的系统 node**（宿主受管运行时路径带版本哈希，宿主升级后失效）
+2. 进入豆包工作「**技能 → 连接器・伙伴 → 连接器 → 新建（本地电脑 / 自定义连接器）**」：服务器名称 `leadsradar`；传输类型下拉选**「STDIO / 本地命令」**（默认显示的「服务器 URL」是 HTTP 形态，选 STDIO 后表单切换为命令/参数/环境变量）；命令填 node 绝对路径；参数填 `leadsradar-agent.mjs` 绝对路径；环境变量 `LEADSRADAR_AGENT_HOST=doubao-work`；**保存并启用**
+3. **完全退出豆包工作再重新打开**（托盘图标也要退出）——豆包**没有「信任」步骤**，「保存并启用」后即生效
+4. 对它说「**检查探栗连接**」：若插件侧显示 step=1（浏览器没开/插件开关没开），按 AI 提示打开浏览器与插件开关；step=2 到插件设置页**核对指纹码后点「批准」**；step=3 即连接成功
+
+</details>
+
+**方式二 · Codex / Claude Desktop 等 STDIO MCP 宿主（手动）**
+
+```bash
+codex plugin marketplace add https://github.com/Kaochicken/leadsradar-skills
+```
+
+或手动配置：命令 `node`，参数为 `leadsradar-agent.mjs` 绝对路径，环境变量 `LEADSRADAR_AGENT_HOST` 填宿主标识。接入包零依赖单文件，无需 npm install。
+
+### 第 3 步：装官方技能
+
+把 `skills/` 下需要的 `SKILL.md` 内容加入宿主技能库（WorkBuddy 技能页 / 豆包智能体指令 / Codex 插件配置）。**建议从「随手调研」开始——装完当天就能用。**
+
+## 安全与隐私
+
+- **全程本机**：数据链路只有 `127.0.0.1`，不经任何云端中转
+- **配对批准制**：每台 AI 设备接入需在插件里核对设备指纹后人工批准，防来路不明的接管
+- **安全限额**：列表单批 300 / 30 分钟 600、评论 500、详情 20/100——超限自动拒绝，保护你的平台账号（AI 会在布置大批量任务前主动告知并建议拆批）
+- **不含插件源码**：本仓库只发布接入适配器（协议转发层），探栗插件核心全部闭源
+- 请勿在对话、Issue 或日志中提交 Cookie、Token、设备私钥
+
+## 使用边界
+
+- 探栗 Agent 必须配合探栗浏览器插件使用，不能替代插件
+- AI 只能使用你在插件中已批准的能力；涉及积分的深度报告以插件内确认为准
+- 遇到登录失效、平台风控提示时任务会暂停，请回浏览器处理
+
+## 目录结构
+
+```
+├── leadsradar-agent.mjs   # 接入包（零依赖单文件，esbuild 自包含）
+├── skills/                # 四个官方技能
+├── package.json
+└── README.md
+```
+
+## 社区技能
+
+官方技能之外，欢迎把你的玩法包（飞书同步、私域 SOP、日报推送…）写成 SKILL.md 提 PR——审核通过后挂进本表，署名归你。
+
+## 支持与反馈
+
+- 官网：[leadsradar.cn](https://leadsradar.cn)
+- 使用问题：插件设置页「执行明细」可查采集日志
+- 欢迎提 Issue 报错与技能改进建议

package/README_en.md

@@ -0,0 +1,97 @@
+# LeadsRadar Agent
+
+English | [中文](README.md)
+
+![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)
+
+> 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.**
+
+```
+Your phone (Doubao / WorkBuddy app)
+   │  ① "Any customer leads in this post's comments?"
+   ▼
+AI assistant on your PC (host, adapter from this repo)
+   │  ② STDIO MCP calls LeadsRadar tools
+   ▼
+LeadsRadar Chrome extension (all data collected inside your own browser)
+   │  ③ Results flow back → AI turns them into plain language
+   ▼
+Your phone (lead report / patrol digest / topic card)
+```
+
+> **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.
+
+## Try saying
+
+- **"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.
+- **"Patrol my benchmark accounts — anyone gone viral?"** — get a digest: who updated, who blew up (and why), whose posting rhythm shifted.
+- **"Extract the copy from this post and save it as a topic"** — get 3 title-hook variants + full script + a topic card.
+- **"Is there still room in the 'home-renovation leads' niche?"** — get a niche brief: competition level, top-player patterns, 3 gap topics.
+
+## Official Skills
+
+Each skill is a `SKILL.md` you drop into your host's skill/instruction library:
+
+| Skill | One-liner | Status |
+|---|---|---|
+| **[Quick Research](skills/leadsradar-research/)** | Send a link / keyword / screenshot, get customer leads & niche insights instantly | ✅ |
+| **[Asset Butler](skills/leadsradar-assets/)** | Send a post link + one sentence — save topic, download media, extract copy | ✅ |
+| **[Benchmark Patrol](skills/leadsradar-patrol/)** | Scan benchmark accounts — who updated, who went viral | ✅ |
+| **[Data Q&A](skills/leadsradar-insights/)** | Just ask: topic library, posts, accounts, comments, research reports | ✅ |
+
+**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.
+
+## 3-minute setup
+
+1. **Install the LeadsRadar extension** from [leadsradar.cn](https://leadsradar.cn) and sign in.
+2. **Feed the adapter to your AI assistant**
+   - **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*.
+   - **Coding agents (Claude Code / Codex CLI / Cursor / Gemini CLI — any STDIO MCP host, manual)**:
+     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:
+
+     Claude Code (one command):
+     ```bash
+     claude mcp add leadsradar -e LEADSRADAR_AGENT_HOST=claude -- node /absolute/path/to/leadsradar-agent.mjs
+     ```
+
+     Cursor / generic (`mcp.json`):
+     ```json
+     {
+       "mcpServers": {
+         "leadsradar": {
+           "command": "node",
+           "args": ["/absolute/path/to/leadsradar-agent.mjs"],
+           "env": { "LEADSRADAR_AGENT_HOST": "claude" }
+         }
+       }
+     }
+     ```
+
+     Codex CLI (`~/.codex/config.toml`):
+     ```toml
+     [mcp_servers.leadsradar]
+     command = "node"
+     args = ["/absolute/path/to/leadsradar-agent.mjs"]
+     env = { LEADSRADAR_AGENT_HOST = "claude" }
+     ```
+
+     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`.
+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.
+
+## Security & privacy
+
+- **Fully local**: the only network hop is `127.0.0.1`; no cloud relay.
+- **Pair-and-approve**: every AI device must be manually approved after fingerprint verification inside the extension.
+- **Rate limits**: lists 300/batch & 600/30min, comments 500/post, details 20/batch & 100/30min — enforced automatically to protect your platform accounts.
+- **No extension source**: this repo ships only the protocol adapter; the LeadsRadar extension core stays closed-source.
+- Never paste cookies, tokens, or device private keys into issues or logs.
+
+## Community skills
+
+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.
+
+## Support
+
+- Website: [leadsradar.cn](https://leadsradar.cn)
+- Usage logs: extension Settings → *Execution details*
+- Issues welcome for bugs & skill improvements