ecom

本地优先 · JD.com MVP · MIT

把电商调研，
交给 Agent

驱动你看得见的 Chrome / CDP，像正常浏览一样完成商品采集与同行价格对比，一条命令生成结构化 Excel 调研报告。

查看 GitHub 快速开始
RUN / 01 $ ecom collect jd "机械键盘" --limit 20
MARKET SNAPSHOTJD · 机械键盘 · 20 RESULTS
XLS
机械键盘 · 竞品价格研究2026-08-26 10:24 · 自动生成
采集完成
PRODUCT INTELLIGENCE20 个商品
商品价格评价
京造 K3 三模机械键盘¥29910万+
ROG 游侠 RX¥7495万+
Keychron V1 Max¥5982万+
达尔优 A98 Pro¥42910万+
雷蛇 黑寡妇蜘蛛 V4¥8991万+
价格分布 / CNY ¥199–899 样本区间
5
7
4
3
1

机会区间：¥300–499 竞争最集中，评价量中位数高于其他档位。

商品明细调研汇总20 ROWS · 2 SHEETS
● ● ●$ ecom report excel jd-20260826-103500-a1b2REPORT READY
PLATFORM ROADMAP京东 · 已支持淘宝 · planned拼多多 · plannedAmazon · planned
1–50串行商品 / 批次
5档价格分布
2张 Excel 工作表
186项测试通过

01 / CORE CAPABILITIES

研究工具，
不只是爬虫。

把采集、对比与交付连成一个可重复、可检查、可被 Agent 调用的本地工作流。

01 — BROWSER

真实 Chrome / CDP

连接本机可见浏览器，通过页面输入、点击和滚动完成研究，过程透明且可人工接管。

VISIBLE SESSION ↗
02 — RESEARCH

自动商品调研

从关键词搜索冻结商品队列，采集标题、价格、品牌、店铺、促销、评价与规格。

STRUCTURED DATA ↗
03 — COMPARE

同行比价

自动整理最低价、中位价、平均价、最高价、价格分布、品牌与店铺排行。

MARKET SIGNAL ↗
04 — REPORT

Excel 调研报告

一键输出调研概览与商品明细，图表、缩略图、精确金额和原始商品链接同时交付。

DECISION READY ↗
05 — RESUME

断点恢复

登录、验证、访问限制或中断时写入检查点；恢复时不重搜、不重排、不重复已完成商品。

FROZEN QUEUE ↗
06 — AGENT

JSON / Agent 友好

stdout 只输出单行结果，进度与诊断进入 stderr，脚本和 AI Agent 无需清洗日志。

STABLE ENVELOPE ↗

02 / WORKFLOW

从一个关键词，
到一份可用报告。

每一步都有明确输入、可见过程和可恢复产物。

  1. 01
    KEYWORD

    输入调研关键词

    选择平台、关键词与 1–50 个商品上限。

    "机械键盘"
  2. 02
    VISIBLE BROWSER

    连接本机 Chrome

    复用独立 Profile，由用户亲自登录并随时观察。

    CDP :53471
  3. 03
    COLLECT

    串行采集与校验

    逐字输入、分段滚动、随机停顿，记录搜索与详情。

    16 / 20
  4. 04
    RECOVER

    随时暂停与恢复

    遇登录或验证即停止，处理后从冻结队列继续。

    resume
  5. 05
    DELIVER

    生成 Excel 报告

    用户确认后，将有效批次转换为双工作表研究报告。

    report.xlsx

03 / EXCEL EVIDENCE

从网页信息，
到决策材料。

不是简单导出表格。报告保留样本状态、统计口径与原始链接，让选品、采购、定价和竞品分析都有据可查。

  • 最低价、中位价、平均价、最高价与有效样本数
  • 五档价格分布、品牌/店铺 Top 10 与自营比例
  • 主图、标题、价格、规格、库存配送与商品链接
  • 公式注入防护、图片失败隔离、校验后原子发布
阅读 Excel 报告文档
E-commerce CLI 生成的真实 Excel 调研概览截图
01真实报告 · 调研概览
E-commerce CLI 生成的真实 Excel 商品明细截图
02真实报告 · 商品明细

04 / SAFETY BOUNDARY

安全来自边界，
不是“隐身”。

项目不依赖隐身补丁或指纹伪装，而是让自动化保持低频、可见、串行、可中断，并把认证状态留在你的本机。

重要说明

CDP 和人类式节奏不代表不可检测，也不能保证不触发平台验证。请遵守目标网站条款、robots 规则和当地法律，只采集你有权访问的数据。

DO / 允许的设计
  • 可见 Chrome 与本机 CDP
  • 独立 Profile、人工登录
  • 逐字输入、分段滚动、随机停顿
  • 串行详情采集、周期性长休息
  • 遇验证写入检查点并停止
  • 批次不复制浏览器认证材料
DON'T / 不提供
  • 无头模式或隐身补丁
  • 验证码与安全验证绕过
  • 浏览器指纹伪装
  • Cookie、账号或请求头导出
  • 私有 API 批量调用
  • 高频或并发商品采集

05 / ADAPTER ROADMAP

从京东开始，
走向更多市场。

每个平台都通过隔离的站点适配器接入。状态透明，不把计划写成能力。

06 / QUICK START

五分钟，
开始第一份调研。

需要 Windows、Node.js 22.12.0+ 和 Google Chrome。Excel 报告另需可选的 OfficeCLI 1.0.139+。

查看完整文档
PowerShell
# 从 npm 一键安装
npm install --global e-commerce-cli

# 检查环境并登录京东
ecom doctor
ecom login jd

# 采集、查看状态、生成报告
ecom collect jd "机械键盘" --limit 20
ecom status <batch-id>
ecom report excel <batch-id>

07 / FAQ

开始之前，
你可能想知道。

E-commerce CLI 是什么？

E-commerce CLI 是一个本地电商调研命令行工具，通过可见 Chrome 和 CDP 收集商品信息、比较同类商品价格，并生成结构化数据与 Excel 报告。

为什么使用可见 Chrome？

可见浏览器让登录、页面交互和异常状态都能被用户观察与接管，同时项目只执行低频、串行的页面输入、点击和滚动。

使用 CDP 就不会被平台检测吗？

不会。CDP 和人类式节奏不代表不可检测，也不能保证不触发平台验证；项目遇到登录、验证或访问限制时会暂停并等待人工处理。

浏览器和调研数据存在哪里？

独立浏览器 Profile 和批次数据都保存在本机。批次目录不复制 Cookie、Local Storage、请求头、账号名或 Profile 文件。

生成 Excel 是否需要安装 Microsoft Office？

不需要。Excel 报告是可选能力，需要 OfficeCLI 1.0.139 或更高版本，但不要求安装 Microsoft Office，也不影响基础采集。

目前支持哪些电商平台？

当前 MVP 仅支持京东。淘宝、天猫、拼多多、当当和海外电商平台均属于 Roadmap，尚未提供可用适配器。

如何与脚本或 AI Agent 集成？

主要命令支持单行 JSON 输出，stdout 只承载结果 envelope，进度与诊断写入 stderr，便于脚本和 Agent 稳定解析。

如何贡献新的平台适配器？

可在 GitHub 提交 Issue 或 Pull Request。新增适配器应保留可见浏览器、低频串行、遇验证停止、不复制认证数据和脱敏测试夹具等原则。

OPEN SOURCE / LOCAL FIRST

把重复调研，
变成可复用的工作流。

从一个京东关键词开始，得到结构化商品数据、价格洞察和一份能直接交付的 Excel 报告。

在 GitHub 查看源码 提出需求