用途
Map Your Market 是一个市场调研与定位框架构建工具。它接收产品描述、品类关键词或竞品名称的任意组合，从多个公开数据源中采集真实的用户痛点信号，并将这些信号整理成可用于定位和营销的框架。
主要能力
- 数据采集：从 Reddit 公开 JSON、Hacker News Algolia API、GitHub Issues API、G2 品类页面抓取和 Google Trends（非官方端点）搜索痛点信号。
- 痛点打分与聚类：先本地按 pain_score 公式打分，排序后只把得分最高的 60 条信号交给 AI 做聚类，形成 5-7 个痛点主题。
- ICP 画像：利用 subreddit、flair、HN 作者简介、GitHub 组织类型等元数据提取理想客户画像信号。
- 市场规模信号综合：基于 G2 厂商数量、Trends 走势、HN 与 Reddit 信号量给出方向性判断，不估算金额。
- 定位框架生成：产出定位角度、落地页标题、冷邮件主题行、ICP 卡片和市场地图。
使用方式
- 环境检查：打印 GITHUB_TOKEN 状态与各数据源限流信息。未设置 token 时 GitHub 搜索按未认证 60 次/小时运行，仍可完成标准运行；重复使用可在 github.com/settings/tokens 添加 token（公开仓库无需 scope）。
- 解析输入：从对话中收集 category（必填）、competitors（可选）、product_context（可选），写入 /tmp/mym-input.json。若只给产品描述则自行提取 2-3 个品类关键词；若只给竞品名称则通过查询竞品推断品类。
- 运行脚本：检查 scripts/fetch.py 是否存在，存在则运行并输出到 /tmp/mym-raw.json，最多等待约 4 分钟（Reddit + HN 搜索约 90 秒）。若总信号少于 10 条则停止，提示品类过窄或关键词需调整。
- AI 痛点聚类：打印得分最高的 60 条信号供分析，产出主题名称（使用市场自身语言）、聚合分数、逐字引用、来源与 subreddit 分布，写入 /tmp/mym-clusters.json。
- ICP 画像：打印 ICP 信号与 subreddit 分布，合成 ICP 画像并写入 clusters 文件的 icp 键。
- 市场规模综合：打印市场信号，仅用方向性语言（competitive/growing、early、saturated），不使用美元金额。
- 定位框架：取前 3 个痛点聚类作为主要定位角度，生成定位陈述、3 条落地页标题、3 条冷邮件主题行。禁用词：powerful、robust、seamless、innovative、game-changing、streamline、leverage、transform、revolutionize。
- 自检与保存：检查无 em dash、无禁用词、无硬性市场规模估算、信号数一致，通过后将报告保存到 docs/market-maps/{slug}-{date}.md 与 .json，清理临时文件并向用户展示 .md 全文。
适用场景
适用于需要在公开社区中寻找真实痛点信号、并据此构建产品定位、ICP 定义和营销信息的场景，尤其适合开发工具、B2B 分析、可观测性等有 Reddit/HN/GitHub 讨论基础的市场。
限制与常见错误
- 不得编造痛点或市场规模数字；每条痛点引用必须逐字来自原始数据。
- 不能按帖子数量而非 pain_score 打分；高赞帖权重高于大量低赞帖。
- 不能对所有品类使用相同的 subreddit；必须先自动检测相关 subreddit。
- 不能把全部原始信号未打分就发给 AI；应先本地打分，只发前 60 条。
- 不能跳过从帖子元数据提取 ICP。
- vendor 数量不等于市场规模：“G2 上有 47 个厂商”意味着竞争激烈，而非市场大。
- 所有信号应作为方向性指标呈现，而非硬性数字。