reddit-icp-monitor

用途

Reddit ICP Monitor 用于监控 Reddit 子版块，发现正在描述你所解决问题的用户。它会根据你的理想客户画像（ICP）对帖子相关性进行评分，并为每个高匹配度帖子起草有帮助、非垃圾性质的回复。

主要能力

• 在指定子版块中按痛点短语搜索帖子
• 使用 Gemini 对帖子与 ICP 的相关性进行 1-5 分评分
• 为评分 4 或 5 的帖子起草回复（每次最多 5 条）
• 支持公开 Reddit JSON 端点（无需认证，10 RPM）或 OAuth（60 RPM）
• 自动去重、记录零结果子版块
• 将报告保存到 docs/reddit-intel/ 目录

使用方式

环境准备

需要 GEMINI_API_KEY（必填，从 aistudio.google.com 获取）。Reddit 凭据可选：未设置时使用公开端点（10 RPM），设置 REDDIT_CLIENT_ID 等后使用 OAuth（60 RPM）。

步骤

1. 设置检查：验证 GEMINI_API_KEY 是否存在，检查 Reddit 凭据。
2. 加载 ICP：读取 docs/icp.md，提取产品描述、痛点短语、反关键词、子版块列表。若文件不存在，需回答 3 个问题（产品做什么、ICP 在哪些子版块发帖、哪些痛点短语触发匹配），然后保存到 docs/icp.md。
3. 搜索 Reddit：对每个子版块与痛点短语组合执行搜索，默认时间窗口为最近 7 天（t=week），可指定 day 或 month。收集、去重帖子，报告候选总数。
4. 用 Gemini 评分：将候选帖子和 ICP 上下文发送给 Gemini，按 1-5 分评分，仅保留 4 分及以上帖子。
5. 用 Gemini 起草回复：为每个高分帖子起草回复，最多 5 条。回复需直接回应问题、分享具体经验、不提及产品名（除非帖子明确要求工具推荐）、2-5 句、无营销语言。
6. 自检：检查回复中无产品名（模式 1/2）、无禁用词、句数合规、URL 真实、模式 3 提及至少一个替代方案等。
7. 输出与保存：生成报告并保存到 docs/reddit-intel/YYYY-MM-DD.md。

关键规则

• 绝不虚构帖子 URL、标题或内容，所有帖子必须来自 Reddit 搜索结果。
• 无结果的部分标记为 "No matches found."。
• 回复不得提及产品名，除非帖子明确要求工具推荐。
• 禁用词包括：game-changer、best-in-class、streamline、transform、revolutionize、leverage、seamless、robust、comprehensive、innovative。

适用场景

• 市场调研：了解目标用户在 Reddit 上的真实痛点和讨论。
• 潜在客户发现：识别正在寻求解决方案的用户。
• 社区参与：以从业者身份提供有帮助的回复，建立信任。

限制

• 需要 GEMINI_API_KEY，否则无法运行。
• 公开端点限速 10 RPM，OAuth 限速 60 RPM。
• 每次会话最多起草 5 条回复。
• 依赖 docs/icp.md 文件或用户提供的 ICP 信息。
• 评分和回复质量取决于 Gemini 模型输出。