新手上手指南 · 用你的店铺跑一次完整选品分析

你不需要打开终端

这份手册假设你只跟WorkBuddy 说话，它替你执行所有命令。 看到 python3 scripts/... 那种片段时，那是给「想自己跑」的人看的备用说明， 你可以直接跳过。

正确的用法：

text

帮我分析 DE 站的瑜伽垫，用示例数据先演示一遍

或（已授权店铺时）：

text

帮我分析 DE 站的瑜伽垫，用我的店铺

WorkBuddy 会自己跑完翻译、数据采集、判定卡，然后把结论用人话讲给你听。 如果它把命令贴给你而不是自己去跑，直接回一句：「请你自己执行，不要把命令给我」。

全程约 5 分钟 · 消耗：0 算力（店铺腿）+ 6 算力（市场热度）· 0 积分 本指南每一步都是实跑验证过的，输出都是真实数据。

你要得到什么

一张判定卡，回答一个问题：这个方向现在能不能进？

它会告诉你：

• 这个方向是涨 / 平 / 降
• 结论凭什么得出的（依据口径）
• 有多少数据点支撑
• 这个结论有多可信（置信度）

第 0 步：装上工具（一次性，2 分钟）

只要拖一个文件、说一句话，剩下的交给 WorkBuddy。

第 0 步 · 一 · 把压缩包拖进来（唯一要动手的操作）

🔴 第① 件（也是唯一一件）：把 选品与市场趋势预测分析技能包.zip 拖进对话框

拖到下面这个输入框里就行：

┌──────────────────────────────────────────────┐
│  把 zip 文件拖到这里                📎  ↑     │
│  ┌────────────────────────────────────────┐  │
│  │ 帮我解压并安装附件中的所有技能             │  │
│  └────────────────────────────────────────┘  │
└──────────────────────────────────────────────┘

说完这句话，剩下的 WorkBuddy 自己完成 —— 解压、放进技能目录、检查是否可用， 全程不用你再动手。

💡 不确定拖对了没？看输入框里有没有出现这个文件的缩略图或文件名。没出现就再拖一次。

第 0 步 · 二 · 看它回你什么

WorkBuddy 会明确告诉你结果。照着对应处理：

✅ 装成功了

它会说类似「已安装 9 个技能」。你回一句：

帮我检查一下选品分析的环境是否就绪

看到各项打勾，就继续第 1 步。

❌ 装失败了

不要重装，先看它说的是哪一类问题：

兜底话术（任何问题都可以先说这句）：

帮我检查一下技能装上没有，没装的话把 zip 里的技能重新装一遍

第 0 步 · 三 · 确认能用

🔴 你要做的：对 WorkBuddy 说一句

帮我检查一下选品分析的环境是否就绪

🟡 你会看到的两种结果：

你会看到（全绿即正常）：

python>=3.8✓ 当前 3.13.12
网关凭据               ✓ 已配置
网关连通               ✓ HTTP 401（有响应即通）
依赖技能               ✓ 必需技能齐备；可选缺失: 无
linkfoxskill CLI       ✓ 在 PATH

如果某项是 ✗：

cd ~/.workbuddy/skills/market-trend-judge
python3 scripts/check_env.py

这一步不花钱、不耗算力，纯粹确认「机器上该有的都有了」。

第 1 步：授权你的店铺（一次性，约 3 分钟）

为什么要授权？

让系统能读你自己店铺的真实销量 —— 这是免费、不耗算力的数据，比任何第三方估算都准。

🔴 你要做 4 件事

① 告诉我店铺名，还有你用哪个 LinkFox 账号

⚠️ 店铺是挂在「账号」下的，不是挂在「这台电脑」上的。 如果你和同事共用一台电脑，这一点尤其重要 —— 用错账号会看到别人的店铺，甚至拿别人的数据做自己的判断。

不确定自己在用哪个账号？直接说「我不知道」，我帮你查。

② 我生成授权链接后，你在浏览器里打开它

🟡 授权页面上不需要你勾选任何权限范围 —— 权限是系统自动配好的， 看到页面直接点确认就行。

③ 在你平时登录这个店铺的那台电脑、那个网络下打开

🔴 这条关系到你的店铺安全，不能换地方。

亚马逊会判断「这次登录是不是在常用环境」。 换设备、换网络（比如用酒店 WiFi、别人的电脑、手机流量）打开， 可能被判定为异常关联，严重时会影响店铺经营。

④ 回来跟我说一声「好了」

我查一次状态，确认真的授权成功了再往下走。

⚪ 我会自动做的（你不用管）

• 生成授权链接，并把上面的安全提醒一起发给你
• 你说「好了」之后，我查授权状态
• 确认成功后，把店铺名和店铺 ID 记下来，后面每一步都会自动带上

# ① 生成授权链接（店铺名必填，为空会直接报错）
python3 ../linkfox-amazon-store-auth/scripts/authorize_url.py \
  '{"region": "NA", "sellerName": "你的店铺名"}'

# ④ 查授权状态
python3 ../linkfox-amazon-store-auth/scripts/authorized_stores.py

如果你的店铺已经授权过

说一声「查一下我有哪些店铺」，我直接列给你 —— 看到店铺名和状态就不用重复授权了。

查一下就会列出你已授权的店铺（比如「演示店铺」）。 以后直接说「分析我的店铺」就行，不用记 ID。

第 2 步：跑一次完整分析

🔴 你要做 1 件事

对 WorkBuddy 说这一句：

帮我分析 DE 站的瑜伽垫，用示例数据先演示一遍

说完就不用管了。我会自己跑完翻译、采集、出判定卡，然后用人话给你结论。

首次建议先用「示例数据」跑一遍 —— 不花钱、不耗算力，几秒钟出结果， 先看清楚这张卡片长什么样，再换真实数据。

我需要你告诉我的

你已经授权过店铺的话，这句话里不用带店铺名，我会用你授权的那个。

🟡 你会看到画面长这样

以下是你说「帮我分析 DE 站的宠物自动喂食器，用我的店铺」之后，屏幕上会逐段出现的内容 （2026-10-13 实跑原文，非示意）。屏幕上会依次出现三段，标题形如 [1/3]、[2/3]。

[0/3] 关键词翻译

  你输入：宠物自动喂食器（中文）
  目标站点：DE
  翻译结果：宠物自动喂食器 → Futterautomat Katze
  来源：缓存（24h 内同站点同词）
  备选：Futterautomat Hund / automatischer Futterspender / Smart Futterautomat
  → 已用 Futterautomat Katze 查询

首次跑某个词时会显示「依据：ABA 真实搜索频率」并给出候选差距倍数； 24 小时内再跑同一个词会命中缓存，显示「来源：缓存」—— 这是好事，说明这个译词已经校验过，直接复用，不用重新查、也不用再花算力。

[1/3] 你的店铺真实销量（免费，不耗算力）

  店铺  A1DEMO0000X
  报告  GET_SALES_AND_TRAFFIC_REPORT（MONTH 聚合，2025-10-01 ~ 2026-10-11）
  ⏳ 提交销量报告请求（Amazon 限速 0.0222 req/s，约 45 秒/请求）
  ✓ 已获取 13 个月度销量数据
月份              订购       发货       销售额(€)
2026-05-01       1363     1341    12,861.69
2026-06-01       2128     2113    19,994.88
2026-07-01       3769     3727    35,742.02
2026-08-01       4926     4853    46,518.37
2026-09-01       5608     5317    50,374.21
2026-10-01       3289     2766    28,662.73
  → 累计 23,440 件 · 月均 1,803 件

⚠ 这一段要等约 45 秒，亚马逊对报表接口有限速（每秒最多 0.02 次请求）。 这是正常等待，不是卡住了。

⚠ 当月数据不完整。比如这里 10 月只统计到 10-11，件数看着比 9 月少， 不是真的下滑。方向判定用的是末端 3 点均值，不会被这个带偏， 但你自己看原始数据时要注意。

[2/3] 市场热度（6 算力）

  关键词  Futterautomat Katze（站点语言）
  ✓ 已获取 82 个月度点
  方向判定（末端 3 点 vs 全序列 ±10%）
     全段均值 66.83 · 近 3 点均值 77.33  比值 1.16
     → 升 growing（置信度 高，样本 12 点）
  ⚠ Google Trends 是 0–100 相对热度，不是绝对搜索量

判定卡（你的结论）

这张表有五点要会读：

「已下调：另有来源低」值得留意 —— 它意味着这个词的市场走向和你店里的实际动销 没完全同步。可能是你卖的是同类但不同款式，或者这不是你店里的主力品。 这种信号比方向本身更有信息量。

「高 / 中 / 低」到底怎么算出来的

不是随便给的，看两件事：有多少个月的数据、这些月之间稳不稳定。

三种「看起来有数据、其实不能用」

这三种都会被判成未采集——因为它们会伪装成正常结论，最危险：

记住：看到「未采集」不用觉得失败。系统认出这三种情况，比给你一个假的「平稳」诚实得多。

译词什么时候系统不替你决定

系统会用亚马逊的真实搜索频率比几个候选译词：

• 差距够大（最热门的那个比次热门多 3 倍以上）→ 自动选，判定卡上会写明差距倍数
• 差距不到 3 倍 → 不替你决定，把候选列出来让你选
• 该站点没有这项数据（如英国站）→ 标「未校验」，不阻断

同一个变体家族只算一次钱

亚马逊上同一款商品可能有多个颜色 / 尺寸 / 容量，卖家后台把它们算作一个家族。

系统按家族去重：同一个家族只查一次、只算一次钱，不会因为你列了 3 个变体就收 3 次费用。

为什么翻译不确定时会停下来问，而不是猜一个词？ 猜错词会查出一堆不相干的数据，浪费算力还误导判断。 宁可让你确认一次，也不给一个错的结论。

🔴 如果出了意外

cd ~/.workbuddy/skills/market-trend-judge

# 示例数据（不花钱）
python3 scripts/orchestrate.py \
  --keyword "瑜伽垫" --site DE \
  --demo --auto \
  --out-dir ~/选品结果

# 真实数据（需已授权店铺）
python3 scripts/orchestrate.py \
  --keyword "瑜伽垫" \
  --site DE \
  --store A1DEMO0000X \
  --auto \
  --out-dir ~/选品结果

第 3 步：看懂屏幕上的每一屏

下面按实际顺序逐段说明。[0/3] 关键词翻译屏在第 2 步已展示，这里从入口屏开始。

入口屏

──────────────────────────────────────────────────────────────────
  LinkFox 选品 · 闭环分析
──────────────────────────────────────────────────────────────────
  站点  DE（Amazon.amazon.de）
  对象  宠物自动喂食器（中文 → 会自动翻译成站点语言）
  店铺  演示店铺（示例用A1DEMO0000X）
──────────────────────────────────────────────────────────────────
  将执行：
   第1轮  店铺真实销量（0 算力）+ 市场热度（6 算力）→ 方向判定
   第2轮  仅当结论不清晰才付费精修（2 积分/ASIN）
   第3轮  仅当候选 <5 个才扩候选（搜索积分 ≤3 次/场）
──────────────────────────────────────────────────────────────────

这里的关键：屏幕一开头就把「会花多少、什么条件下才花钱」摊开给你了。

• 第 1 轮 6 算力是固定支出，其余两轮默认不触发
• 如果第 2、3 轮要花钱，屏幕上会出现「决策闸」问你，不点头就不花
• 你让 WorkBuddy 帮你跑时它会自动确认；如果你自己在终端跑，会问一次「同意开始？」，直接回车即可

[1/3] 你的店铺真实销量（0 算力）

[1/3] 店铺真实销量
  店铺  A1DEMO0000X
  报告  GET_SALES_AND_TRAFFIC_REPORT（MONTH 聚合，2025-10-01 ~ 2026-10-11）
  ⏳ 提交销量报告请求（Amazon 限速 0.0222 req/s，约 45 秒/请求）
  ✓ 报告已创建 reportId=395308020739
  ✓ 已获取 13 个月度销量数据
月份          订购     发货    销售额(€)
2026-08-01    4926    4853    46,518.37
2026-09-01    5608    5317    50,374.21
2026-10-01    3286    2766    28,637.26
  → 累计 23,437 件 · 月均 1,803 件

等45 秒是正常的——亚马逊官方限速（约 45 秒一个请求），不是卡住了。

要看的：

• 最后一个月的 订购 是你店铺的真实销量
• 如果前几个月是 0，说明店铺是新开的（看爬坡趋势更有意义）

[2/3] 市场热度（6 算力）

[2/3] 市场热度 + 方向判定
  关键词  Yogatasche（站点语言）
  范围    近 6 年（Google Trends 需>5 年才有原生月点）
  ✓ 已获取 82 个月度点
  方向判定（末端 3 点 vs 全序列 ±10%，工作台口径）
     全段均值 46.51 · 近 3 点均值 42.66  比值 0.92
     → 平 stable（置信度 高，样本 12 点）
  ⚠ Google Trends 是 0–100 相对热度，不是绝对搜索量

⚠️ 这行警告很重要：Google Trends 的数字是"相对热度"（0–100），不是搜索量。 比如"比去年热"，不代表"有 50 次搜索"。

决策闸（决定要不要花钱）

  当前判定：方向=平 · 置信度=高 · 依据=市场热度(12点)

   □ 结论清晰 → 到此结束，不花积分
   □ 想看单品级 → 付费精修 2 积分/ASIN
   □ 候选太少 → 扩类目候选（搜索积分 ≤3 次/场）

  你要 [1/2/3]（回车=1）：

三个选项的意思：

建议：第一次用直接回车（选 1）。等你觉得"这个结论不够细"时再用 2。

判定卡（你的结论）

# 判定卡 · DE · Yogatasche

| 候选商品 | 方向 | 依据口径 | 样本点数 | 置信度 | 最终决定 |
|---|---|---|---|---|---|
| Yogatasche｜闭环合并 | 平 | 市场热度 + 店铺真实｜店铺真实 A1DEMO0000X；市场热度 12点 | 市场热度 12 / 店铺真实 13 | 高（已下调：另有来源低） |  |

逐列怎么读：

关于"已下调"：这是系统在告诉你——"我本来很有信心，但其中一个数据源不够稳，所以我保守地把结论降级了"。 这比给个"高"然后让你误以为板上钉钉要好。

第 4 步：交卡前自检

判定卡下面有5 条自检项，这是给你的人工核查清单：

1. 方向有没有超出 ±10% 阈值依据（末端 3 点均值 vs 全序列均值）？
2. 依据口径写没写清（市场热度 / 店铺真实 / 第三方家族 / 未采集）？
3. 样本点数够不够（<6 的行应为「未采集」）？
4. 置信度低的行，最终决定是否已相应保守？
5. 同变体族的行有没有合并成一条（避免重复付费）？

你只需要人工确认第 4 和第 5 条：

常见问题

Q1: 为什么每次要等 45 秒？

不是卡住，是亚马逊官方限速（约每 45 秒允许一个报告请求）。

你会看到这行：

⏳ 提交销量报告请求（Amazon 限速 0.0222 req/s，约 45 秒/请求）

这段时间系统在等亚马逊生成报告——大店铺可能需要几分钟。这期间你可以切走做别的事。

频繁重跑会触发限流（429限流中，请降低频率）。遇到限流请耐心等几分钟—— 脚本已内置自动退避重试（等 45 秒、90 秒、135 秒）。

Q2: 提示"未取到销量数据"或"报告请求异常"

几种情况，都不影响其他环节——系统会跳过店铺腿，只显示市场热度的结论。

判定卡会如实只显示实际拿到的依据：

市场热度 + 店铺真实   ← 两路都有
市场热度             ← 只有一路（店铺腿失败，不会假装有）

Q3: 关键词到底该填中文还是当地语言？

两种都行。 中文会被自动翻译成站点语言主词；已经知道当地语言词，直接填更快（省一次翻译）。

支持的站点与自动翻译目标语言：

UK 站例外：ABA 搜索数据不含英国站，UK 的译词无法用真实搜索频率校验， 系统会标注 ⚠ 未校验。查询本身正常，不影响使用。

Q4: 分析别的站点怎么办？

说站点名就行，例如：

帮我分析美国站的 Yoga Mat，用我的店铺

我会自动带上这个站点需要的参数。如果是还没授权过的站点， 我会告诉你需要先授权——你到 Amazon 后台找到对应的店铺 ID 给我就行。

# 美国站比德国站多两个参数：授权区域与站点ID
python3 scripts/orchestrate.py \
  --keyword "Yoga Mat" \
  --site US \
  --store A1DEMO0000X \
  --auth-region NA \
  --marketplace-id ATVPDKIKX0DER \
  --auto \
  --out-dir ~/选品结果

完整对照表（23 个站点）

全部取自 Amazon 官方文档 [Store Identifiers](https://developer-docs.amazon.com/sp-api/docs/store-identifiers)（2026-10-12 查证）。 Region 必须与 marketplaceId 匹配（NA=美加墨巴 / EU=欧洲中东印非 / FE=远东澳）。 传错不会报"参数错"，而是返回看不懂的响应——看起来像坏了，其实只是选错区。

不想记这些 ID？让系统告诉你

python3 ../linkfox-amazon-store-auth/scripts/authorized_stores.py

更直接的办法：某个 marketplaceId 不确定时，直接用 SP-API 问：

python3 -c "
import sys; sys.path.insert(0, '../linkfox-amazon-store-report/scripts')
import get_report as G, json
r = G.developer_proxy_call('EU', '/sellers/v1/marketplaceParticipations', 'GET', '你的sellerId')
for m in json.loads(r['body'])['payload']:
    mk = m.get('marketplace', {})
    if m.get('participation', {}).get('isParticipating'):
        print(mk['countryCode'], mk['id'], mk['name'])
"

输出的是你这个店铺真实参与的站点，比背表子靠谱。

别填国家代码（填 DE 会被服务端拒绝）——这是 Amazon 的内部 ID，不是常识代码。

Q5: 为什么我的判定卡上有几行是「未采集」？

三种情况：有效月份少于 6、整条数据都是 0、整条一模一样。 第三种最需要注意 —— 第三方数据源在拿固定数值凑数， 它其实没拿到你的品，但输出看起来像一条正常曲线。

这不是数据差，是系统在保护你。 换成别的工具， 你可能会看到一条「平稳」的假曲线，然后据此做了个错误的判断。

Q6: 想加更多候选商品（而不是只看一个关键词）

回决策闸选 3，会引导你交互式选类目：

Amazon.de 类目选择（序号进入 · b 回退 · q 退出）
第 1 级 · 23 个大类
  1. 厨房、家居和生活  在售 453,652 ›
  2. 时装              在售 215,199 ›
请选择 [序号]（s=搜索　b=返回上级　q=退出）：

• 输入序号进入下一层
• 输入 b 回上一层
• 输入 s 可以搜关键词跳级
• 输入 q 退出

选好后系统会跑选品漏斗，并有护栏检查：

[类目护栏] 命中率 100%（51/51 有类目证据） → passed

护栏未通过（rejected）时系统会停下，避免拿"类目外的商品"给你出结论。

一句话总结流程

授权店铺（一次性） → 填3 个参数 → 回车 → 等 45 秒 → 读判定卡 → 人工填「最终决定」
     ↑                                                                          ↓
   免算力                    ↑6 算力 0 积分                          进 / 留观 / 剔除

下一步可以做什么