investment-community-radar

技能简介

investment-community-radar 是一款专注于个人投资社区热点挖掘的自动化脚本工具。它从 Reddit 八个投资子版块、V2EX 指定节点以及 Hacker News 三大平台抓取高互动内容，按热度阈值筛选出「热点新闻」与「长尾故事」两类材料，并生成带原帖链接的中文阅读清单。

该工具以 Cursor Agent Skill 形态交付，调用时只需在技能目录下运行一条命令，即可获得结构化的投资社区情报。适合行为金融研究、公众号素材收集、跨社区投资故事检索等场景。

核心能力

investment-community-radar 提供以下核心功能：

1. 三平台覆盖：Reddit（8个子版块）、V2EX（invest/stock/bitcoin 等节点）、Hacker News（front/ask/show）同步监控。
2. 双轨筛选机制：区分「热点新闻」（近期高互动帖）与「长尾故事」（历史持久影响力帖），互不遗漏。
3. 中文材料清单：自动将 Reddit 和 HN 的英文标题、摘要翻译为中文，无需手动整理即可阅读。
4. P95 阈值动态调整：Reddit 各板块采用全时段评论数 P95 阈值，过滤噪音，保留真正的高影响力内容。
5. 失败透明记录：数据抓取失败时将平台状态写入覆盖缺口，不静默跳过，保证报告可信度。
6. 多格式输出：同时输出结构化 JSON（供程序读取）和 Markdown 报告（供人工阅读）。
7. 可配置过滤规则：通过 config.json 可调整各平台的评论数阈值、回溯窗口、翻译开关等参数。

安装配置

本技能的安装与配置步骤如下：

1. 环境要求：Python 3.10 及以上版本，无需数据库或特殊依赖。
2. 克隆仓库：

   git clone https://github.com/sayshirak/investment-community-radar
   cd investment-community-radar

3. 安装依赖：

   pip install -r requirements.txt

   依赖包括 requests、beautifulsoup4、lxml，均为标准库级别。

4. 初始化配置：编辑 config.json 中的 translation.enabled 开关（控制是否启用英译中），以及各平台的数据源节点路径。

使用步骤

本技能的标准使用流程分为四个步骤：

1. 探活检测（使用前推荐）：

   python scripts/run_radar.py status

   验证各平台连通性，确保网络或代理配置正确，再进行数据抓取。

2. 抓取数据：

   python scripts/run_radar.py collect

   仅抓取数据，结果写入 output/latest/hotspots.json。

3. 生成报告：

   python scripts/run_radar.py report

   将最新 JSON 渲染为 output/latest/weekly_hotspots.md 中文阅读报告。

4. 一键全量执行：

   python scripts/run_radar.py all

   等同于 collect + report，生成完整报告后打印至终端。

支持按平台单独运行，例如：

python scripts/run_radar.py all --only reddit
python scripts/run_radar.py all --only v2ex
python scripts/run_radar.py all --only hackernews

适用场景

本技能适用于以下典型场景：

1. 行为金融研究：收集 Reddit WallStreetBets 等社区的个人投资者故事，用于研究市场情绪与投资行为模式。
2. 内容创作素材：为公众号、简报等渠道挖掘真实投资经历与市场故事作为创作素材。
3. 跨社区舆情分析：同时监控中外投资社区，发现同一事件在不同市场的讨论热度差异。
4. 投资选题调研：从海量讨论中筛选具有代表性的高回复帖，快速定位值得深入研究的话题。

适用人群

本技能主要面向以下用户群体：

• 内容创作者：需要持续追踪投资社区热点的公众号作者、自媒体人。
• 金融研究员：关注个人投资者行为和社区舆情的分析师、研究员。
• 市场观察者：希望从真实用户讨论中获取市场洞察的个人投资者。
• AI 应用开发者：将社区情报数据整合到更大 AI 工作流中的开发者。

工作原理

investment-community-radar 的数据处理链路如下：

1. 列表抓取：各平台分别抓取帖子列表，Reddit 使用官方公开 JSON 接口，HN 使用 Algolia 搜索 API，V2EX 解析公开 HTML。
2. 阈值筛选：按平台规则（评论数、发帖时间窗口）双轨筛选候选帖，去重后进入候选池。
3. 内容丰富：对 Reddit/HN 候选帖补充中文标题和摘要（调用免密翻译端点），V2EX 直接保留原帖信息。
4. 报告生成：按平台、类型（recent/long_tail）、评论数排序，渲染为 Markdown 报告。
5. 失败记录：任一平台抓取失败时，将失败信息写入覆盖缺口，不得用旧数据或推测内容补齐。

官方链接

GitHub 仓库：https://github.com/sayshirak/investment-community-radar