关于 reddit-search
reddit-search 是用于公开 Reddit 研究的技能,面向需要从帖子、评论、社区或公开个人资料获取市场证据的人。它以有界的小样本开始,并按目标选择对应路线。
主要功能
- 01关键词与搜索 URL 探索
- 02帖子评论研究
- 03子版块内容与元数据收集
- 04公开个人资料活动查询
- 05保留原始记录与来源链接
适用场景
- 01发现与主题相关的 Reddit 帖子
- 02分析选定讨论串中的评论
- 03研究公开子版块或个人资料活动
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ postplusai/ postplus-skills --skill reddit-search安装后在 Claude Code 中输入/reddit-search确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/community.mdpost-comments.mdprofile.mdresult-shapes.mdsearch.mdshared-contract.md详细介绍
Reddit 搜索
将此技能用于范围受限的公开 Reddit 调研。
体验规则
- 使用用户的业务语言,而非采集术语。
- 最多提问一次,且只有当答案会改变执行路线或积分上限时才提问。
- 从最小的有效样本开始,并仅在审核后扩展。
- 不在对话中提及实现、交付和网络控制。
- 遇到硬性命令、契约、身份验证或私有界面故障时,立即停止。若受支持的运行已完成,但证据为空、稀疏、嘈杂或偏离主题,则在得出证据已穷尽的结论前,应用下方的质量规则。
路线索引
执行前,只阅读匹配的路线参考。仅在转换已完成的记录时,才阅读结果格式详情;无需在预检时阅读。
| 用户需求 | 路线参考 | 默认首轮范围 |
|---|---|---|
| 关键词帖子、社区或 Reddit 搜索 URL | references/search.md | 20 条帖子或 10 个社区 |
| 关键词评论证据 | references/search.md;仅在选定讨论串后阅读 references/post-comments.md | 20 条发现用帖子,然后最多查看 3 个相关讨论串 |
| 指定帖子 URL 下的评论 | references/post-comments.md | 1 条帖子,最多 50 条评论 |
| 引导式痛点或产品观点深度调研 | references/search.md;仅在选定讨论串后阅读 references/post-comments.md | 20 条发现用帖子,然后查看 3 个建议的讨论串 |
| 子版块搜索、信息流、元数据或深度采集 | references/community.md | 20 条信息流帖子;深度范围另行设限 |
| 明确指定的公开 Reddit 用户资料及其活动 | references/profile.md | 20 条帖子和 20 条评论 |
| 转换结果时需要超出下方摘要范围的字段 | references/result-shapes.md | 保留原始结果文件 |
首个问题
如果用户已提供关键词、URL、子版块或用户资料,且适用安全默认值,则不要提问。否则,只询问信息量最高的问题:
| 缺少的决策 | 提问内容 |
|---|---|
| 未指定调研目标 | 你想让我调研哪个 Reddit 主题、URL、子版块或公开用户资料? |
| 深度子版块请求未设范围 | 深度采集应限制在什么日期范围或最多多少条帖子? |
| 有多个耗费较大的方向需要选择 | 你希望我先执行哪项:发现、讨论串深度调研、子版块调研,还是公开用户资料调研? |
绝不要询问凭据、架构字段、实现方式、交付设置或重试策略。
运行协议
- 选择一条路线,并遵循其参考。
- 运行范围最窄且能满足首轮需求的语义路线。
- 将 JSON 结果作为持久证据保存在
.postplus/下。 - 检查记录类型及相关性。如果证据没有用,则应用下方的质量规则;不要重复完全相同的请求,也不要超出已批准的 PostPlus 积分上限。
- 在结果文件中保留完整原始记录;仅规范化面向用户的证据。只有在需要进一步解释字段时,才阅读
references/result-shapes.md。 - 报告调研范围、各结果类型的数量、有代表性的证据、限制以及一项有用的后续行动。不要暗示范围受限的调研已穷尽所有信息。
多个关键词属于彼此独立、可分别归因的请求。它们可以并行运行,但在呈现之前,各自的结果集必须保持独立。
公开命令边界
- 就绪检查:
postplus doctor --skill reddit-search。 - 仅在需要时,通过
postplus research run <route> --help检查路由标志。 - 选择路由:
reddit-search用于关键词发现、公开搜索 URL、社区搜索和普通 subreddit 信息流;reddit-post-comments用于一个或多个选定帖子的讨论串;reddit-subreddit-posts用于有界的深度 subreddit 采集;reddit-user-activity用于明确指定的公开个人资料。
- 运行
postplus research run <route> --<query/url/subreddit/handle flags> --limit <n> --wait --output <result.json>。 - 仅使用所选路由显示的语义标志。
- 如果运行返回了已保存的异步检查点,请使用
postplus research run --resume-from <result.json>恢复,而不要启动重复运行。 - 请求的任务会使用现有 PostPlus 额度;使用前请检查当前价格和余额。 仅估算的请求不会执行。若额度不足,请停止;不要充值、购买订阅,也不要重复执行结果不确定的付费操作。
范围边界
支持:公开关键词发现、公开搜索 URL、公开帖子讨论串、公开 subreddit 内容和元数据,以及明确请求的公开个人资料动态。
不支持:登录或访问账户、发帖或发送消息、恢复私密/已删除内容、推断真实身份、丰富私有数据、自动化情感分析、下载媒体、向外部发送内容,以及调整网络配置。
命令选择
| 需求 | 路由 | 标志 |
|---|---|---|
| 关键词/搜索 URL/信息流发现 | reddit-search | 重复使用 --query 或 --url,并指定排序/时间范围/上限 |
| 选定讨论串的评论 | reddit-post-comments | 重复使用 --url,并指定上限 |
| 深度 subreddit 检索 | reddit-subreddit-posts | 重复使用 --subreddit,可选 --posted-after,并指定上限 |
| 指定的公开个人资料 | reddit-user-activity | 重复使用 --handle,并指定帖子上限、评论上限 |
只有在平台范围或证据解读仍不明确时,才查阅 平台契约;它不是预检步骤。
证据质量
- 得出结论前先对记录分类:发现到的帖子用于识别讨论串;评论中的主张需要实际评论作为依据。
- 对关键词评论研究,先发现帖子,再检查最多三个相关讨论串;如果发现效果不佳,应先更换查询词,再扩大范围。
- 成功但结果不足时,最多进行两轮调整后的后续检索,且不得超出已批准的范围和预算;不要重复完全相同的请求,也不要隐瞒失败或待处理的操作。
- 结果充分、达到上限,或进一步检索无济于事时,应停止。报告有用证据及不确定性;保留原始结果和来源链接。
使用 dataType + id 进行去重;保留评论的父级 ID 和深度。缺失值表示未知,不是零。
完整的机器可读字段位于 postplus research schema --route <route> --json;
仅在处理需要时查阅,不要在每次请求前都查阅。
postplus research run reddit-search \
--query "example topic" \
--wait \
--output ./result.json
遵循 CLI 提供的结构化结果和报告的后续操作;不要根据自由文本消息推断如何恢复。 如果用户已明确批准且批准范围和最高费用涵盖当前请求,可沿用该批准;否则,在确认报价前必须先取得批准。不得仅凭任务本身推断用户授权了支出。 通过返回的检查点或操作恢复同一项操作;绝不要重新提交结果不确定的工作、重复已耗尽的恢复尝试,或切换提供商以绕过失败。