convez.ai
SkillDados & AnalyticsIntermediário
banjunjun2

Gerador de Relatórios de Pesquisa de Mercado para E-commerce Transfronteiriço

banjunjun2/market-research-report

Padroniza pesquisas de mercado transfronteiriço com confirmação pré-execução + HTML estilo Apple

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill do Claude Code que padroniza pesquisas de mercado de categorias de e-commerce transfronteiriço em três etapas: confirmação estruturada multidimensional por perguntas-chave, captura opcional de dados em tempo real (via MCP/CLI) e geração de relatório HTML em estilo Apple industrial. Consolida aprendizados de pesquisas reais em múltiplos países e plataformas (Amazon, Shopee, TikTok).

Instalação

$npx convez-ai banjunjun2/market-research-report

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Pesquisa de mercado estruturada para novos nichos em e-commerce transfronteiriço
  • Análise de categorias em múltiplas plataformas (Amazon, Shopee, TikTok) e regiões
  • Geração de relatórios com auditoria de fontes de dados e declaração de critérios de cálculo

Veredito

Ferramenta sólida para pesquisa de mercado em e-commerce, com forte foco em reproducibilidade e auditoria de dados (zero fabricação). O fluxo de confirmação pré-execução evita retrabalho. Limitação: valor real emerge quando integrado com APIs de dados reais (Sorftime MCP); sem elas, depende de entrada manual do usuário.

README

A tradução para o português deste README ainda está na fila.

market-research-report · 跨境电商品类市场调研报告 Skill

一个 Claude Code Skill,把一次专业的跨境品类调研标准化为:问题驱动的逐维度确认 → (可选)真实数据抓取 → 固定风格的苹果工业风 HTML 报告。

沉淀自美容美发工具品类的多国调研实战(Amazon 七国 / 东南亚 Shopee·TikTok 四国 / 单市场多品类横评),适用于任何跨境品类(家居 / 3C / 宠物 / 户外…)。


它解决什么问题

调研报告最大的坑是写完才发现范围/口径不一致,返工比重写还慢。这个 Skill 把"事前确认"和"事后呈现"固化下来:

  1. 🧭 问题驱动的逐维度确认(核心) — 用结构化提问带你一项项锁定:品类范围、排除清单、目标平台、Top N 深度、时间口径、增速口径、价格段阈值、逐章结构。产出一份《立项前提 Plan》,你拍板"开始执行"才动手。不依赖任何数据接口,人人可用。
  2. 🎨 固定风格的 HTML 报告 — 统一的苹果工业风结构化网页:毛玻璃导航、指标卡、数据表、tab 切换、价格段堆叠条、洞察盒、六项口径声明条。样式不靠每次发挥,直接套模板。
  3. 🔌 可选的实时抓数 — 若检测到你装了数据接口(Sorftime MCP/CLI 等),会在提问中多问一题让你选"接口实时抓取 / 自己提供数据"。没装就自动跳过,流程不变。

真实性红线:全程零编造。拿不到的数据一律标 — 并附注说明,绝不臆造数字或评论。


工作机制:两种模式自动切换

没装数据接口(默认)装了 Sorftime / 其他接口
确认流程✅ 完整可用✅ 完整可用 + 多一题"数据来源"
数据来源你提供 / 粘贴 / 复用已有可选实时抓取真实在售数据
HTML 报告✅ 固定风格输出✅ 固定风格输出

开工时 Skill 先探测有没有可用接口,只影响要不要多问"抓数"那一题,其余完全一致。探测到接口也永远让你选,不会默认替你开抓。


安装

Skill 放在 Claude Code 的 skills 目录即可被识别。

方式一 · 克隆到全局 skills 目录

# macOS / Linux
git clone https://github.com/banjunjun2/market-research-report.git \
  ~/.claude/skills/market-research-report

# Windows (PowerShell)
git clone https://github.com/banjunjun2/market-research-report.git `
  $env:USERPROFILE\.claude\skills\market-research-report

方式二 · 放进某个项目的 .claude/skills/(只对该项目生效)

git clone https://github.com/banjunjun2/market-research-report.git \
  ./.claude/skills/market-research-report

装好后在 Claude Code 里说"帮我做个 XX 品类市场调研报告"或 /market-research-report 即可触发。

(可选)启用实时抓数

只有想让 Skill 自动抓真实数据时才需要,二选一:

  • Sorftime MCP:在 Claude Code 配置 sorftime MCP server(工具名形如 mcp__sorftime__*)。
  • sorftime-cli:安装 sorftime-cli skill (Amazon 端点更完整)。

不装这些 不影响 确认流程和 HTML 报告。


用法示例

你:帮我做一份阿联酋美容个护电器的市场调研报告
Claude:(探测接口)→ 开场摸底 5 问 → 第1轮范围与平台 → 第2轮数据口径
       → 第3轮章节细节 → 产出《立项前提 Plan》
你:开始执行
Claude:(可选抓数)→ 套用 Apple 工业风模板 → 输出 HTML 报告 → 交付自检

目录结构

market-research-report/
├── SKILL.md                      # 总入口:工作流 + 能力探测 + 铁律
├── README.md                     # 本文件
├── references/
│   ├── kickoff-standard.md       # 立项规范全文(真实性红线、口径统一,必读)
│   ├── kickoff-checklist.md      # 分轮确认决策清单(提问流程底稿)
│   ├── report-structure.md       # 三种报告范式章节结构 + 组件清单
│   └── data-collection-sop.md    # 【可选】抓数 SOP:CLI/MCP 通道、防限流、配额、站点码
├── assets/
│   └── report-template.html      # Apple 工业风 HTML 骨架 + 组件库(固定风格,可直接套)
└── scripts/                      # 【可选】纯 MCP curl 抓取脚手架
    ├── fetch.sh                  # 单次抓取(SSE 落盘)
    ├── parse_sse.py              # SSE → JSON
    ├── run_jobs.sh               # 批量串行(2.5s 间隔 + 断点续跑)
    └── normalize.py              # 跨平台字段归一化(统一 schema)

设计原则(为什么这么做)

  • 先确认再动手 — 范围/口径开工锁死,避免连锁返工。
  • 口径全报告统一 — 大盘 / 价格段 / 市占率 / Top SKU 用同一套范围与口径,每张表附注写明六项。
  • 范围靠排除清单定义 — 列出易混入近邻品类 + 理由 + 代表 SKU,用可审计的分类器而非黑箱。
  • 零编造 — 缺失标 —,估算必备注,评论逐字真实引用。
  • 风格固定 — HTML 样式不每次发挥,统一苹果工业风模板,保证一致性与品牌感。

License

MIT。报告设计系统与方法论可自由用于商业调研;请保留来源致谢。

Ver o original no GitHub

Bom para

Relacionados