sop-market-research SKILL.md skillA
sop-market-research from heqiangdiao-wq/ai-cross-border-ecommerce-agent-toolkit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add heqiangdiao-wq/ai-cross-border-ecommerce-agent-toolkit/sop-market-research@v0.4.0Pins v0.4.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- heqiangdiao-wq/ai-cross-border-ecommerce-agent-toolkit
- Path
Agents/01_Market_Research_Agent/SKILL.md- Versions recorded
- 1
- Latest version
- v0.4.0, committed Oct 16, 2026
- Size
- 3,381 bytes
- Repository stars
- 1,034
- License
- MIT
跨境电商市场调研 Skill（Shopee BR / Mercado Livre）。把虾多拉等工具导出的类目 CSV 洗成标准数据，算市场容量、品牌/卖家集中度（CR3/CR10/HHI）、价格带分箱与波谷检测、配置交叉表，并解读"这个类目值不值得进"。当用户要"看类目 / 市场分析 / 价格带 / 竞品集中度 / 选品前置调研"时使用。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 01 · Market Research Skill（市场调研）
**分工边界：数字由脚本算，"意味着什么、下一步做什么"由你（Agent）解读。**
不要自己重算指标——报告里的数字是脚本算的确定性结果；怀疑数字有问题就输出
`[METRIC_SUSPECT]`，让使用者检查脚本参数。
## 最小输入
```text
1. 类目商品数据 CSV/Excel（虾多拉等工具导出：商品名/价格/月销量/月销售额/卖家/品牌…）
2. 类目名称 + 平台
3. （可选）配置维度字段名，如 功率,承重
```
## 三条底线
1. **不编造数据** —— 输入里没有的字段不许猜，缺关键列就报 `[INPUT_MISSING]` 并列出可用列
2. **不替代选品决策** —— 输出的是分析结论与下一步建议，最终决策必须由人做
3. **数字必须可溯源** —— 解读中引用的每个数字都要能在脚本报报告里指到出处
## 工作流
```text
[Step 1] 跑 shaduola_parser.py 洗数据（脏格式 → 标准化 JSON）
支持 R$ 1.234,56 / 1,234 / 1.2万 / 4个月 / 月销售额缺失按 价格×销量 补算
[Step 2] 跑 market_metrics.py 出指标报告（容量 / CR3·CR10·HHI / 价格带波谷 / 配置交叉表）
[Step 3] 按 prompts/02_market_analysis.md 解读：
→ 这个类目值不值得进（容量、集中度、价格带下界 vs 成本可行价）
→ 主流配置是什么、哪里有机会配置
→ 结论喂给 02 Product Strategy
```
## 命令速查
```bash
# ① 洗数据（CSV/Excel 都吃；--profile 只看列识别不产出）
python scripts/shaduola_parser.py 类目导出.csv -o data.normalized.json
# ② 算指标（--config-fields 按类目改）
python scripts/market_metrics.py data.normalized.json \
--bins 10 --config-fields "功率,承重,容量" --format md -o report
# ③ 没有真实数据时，先生成带脏数据的样本验证环境
python scripts/make_sample.py
```
## 解读时的判断阈值（SOP 内置，写进你的分析）
- 品牌 CR3 高但**前三名全是白牌** → 买家不认品牌，新店仍有空间
…Read the whole file at its exact version.
How to install
mdr add heqiangdiao-wq/ai-cross-border-ecommerce-agent-toolkit/sop-market-research@sha256:75b492cfc7ea942dThe line at the top of this page pins the label v0.4.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_4ztppcoap4kvia2a)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 16, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3381 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
heqiangdiao-wq/ai-cross-border-ecommerce-agent-toolkit · 1,034 stars · license MIT · pushed 2026-10-18 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_4ztppcoap4kvia2a GET https://markdownregistry.com/api/v1/resolve?ref=heqiangdiao-wq/ai-cross-border-ecommerce-agent-toolkit/sop-market-research GET https://markdownregistry.com/api/v1/blob/75b492cfc7ea942d4d31afd3692f87d5fbd72a90d16a9daebca21209b58cb49f
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from heqiangdiao-wq/ai-cross-border-ecommerce-agent-toolkit
Every file in heqiangdiao-wq/ai-cross-border-ecommerce-agent-toolkit