mcpField
R
reddit-search

reddit-search

github.com/postplusai营销与增长27373 次安装1 天前更新
代码仓库

关于 reddit-search

reddit-search 是用于公开 Reddit 研究的技能,面向需要从帖子、评论、社区或公开个人资料获取市场证据的人。它以有界的小样本开始,并按目标选择对应路线。

主要功能

  1. 01关键词与搜索 URL 探索
  2. 02帖子评论研究
  3. 03子版块内容与元数据收集
  4. 04公开个人资料活动查询
  5. 05保留原始记录与来源链接

适用场景

  1. 01发现与主题相关的 Reddit 帖子
  2. 02分析选定讨论串中的评论
  3. 03研究公开子版块或个人资料活动

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/postplusai/postplus-skills --skill reddit-search

安装后在 Claude Code 中输入/reddit-search确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
community.md
post-comments.md
profile.md
result-shapes.md
search.md
shared-contract.md

详细介绍

Reddit 搜索

将此技能用于范围受限的公开 Reddit 调研。

体验规则

  1. 使用用户的业务语言,而非采集术语。
  2. 最多提问一次,且只有当答案会改变执行路线或积分上限时才提问。
  3. 从最小的有效样本开始,并仅在审核后扩展。
  4. 不在对话中提及实现、交付和网络控制。
  5. 遇到硬性命令、契约、身份验证或私有界面故障时,立即停止。若受支持的运行已完成,但证据为空、稀疏、嘈杂或偏离主题,则在得出证据已穷尽的结论前,应用下方的质量规则。

路线索引

执行前,只阅读匹配的路线参考。仅在转换已完成的记录时,才阅读结果格式详情;无需在预检时阅读。

用户需求路线参考默认首轮范围
关键词帖子、社区或 Reddit 搜索 URLreferences/search.md20 条帖子或 10 个社区
关键词评论证据references/search.md;仅在选定讨论串后阅读 references/post-comments.md20 条发现用帖子,然后最多查看 3 个相关讨论串
指定帖子 URL 下的评论references/post-comments.md1 条帖子,最多 50 条评论
引导式痛点或产品观点深度调研references/search.md;仅在选定讨论串后阅读 references/post-comments.md20 条发现用帖子,然后查看 3 个建议的讨论串
子版块搜索、信息流、元数据或深度采集references/community.md20 条信息流帖子;深度范围另行设限
明确指定的公开 Reddit 用户资料及其活动references/profile.md20 条帖子和 20 条评论
转换结果时需要超出下方摘要范围的字段references/result-shapes.md保留原始结果文件

首个问题

如果用户已提供关键词、URL、子版块或用户资料,且适用安全默认值,则不要提问。否则,只询问信息量最高的问题:

缺少的决策提问内容
未指定调研目标你想让我调研哪个 Reddit 主题、URL、子版块或公开用户资料?
深度子版块请求未设范围深度采集应限制在什么日期范围或最多多少条帖子?
有多个耗费较大的方向需要选择你希望我先执行哪项:发现、讨论串深度调研、子版块调研,还是公开用户资料调研?

绝不要询问凭据、架构字段、实现方式、交付设置或重试策略。

运行协议

  1. 选择一条路线,并遵循其参考。
  2. 运行范围最窄且能满足首轮需求的语义路线。
  3. 将 JSON 结果作为持久证据保存在 .postplus/ 下。
  4. 检查记录类型及相关性。如果证据没有用,则应用下方的质量规则;不要重复完全相同的请求,也不要超出已批准的 PostPlus 积分上限。
  5. 在结果文件中保留完整原始记录;仅规范化面向用户的证据。只有在需要进一步解释字段时,才阅读 references/result-shapes.md。
  6. 报告调研范围、各结果类型的数量、有代表性的证据、限制以及一项有用的后续行动。不要暗示范围受限的调研已穷尽所有信息。

多个关键词属于彼此独立、可分别归因的请求。它们可以并行运行,但在呈现之前,各自的结果集必须保持独立。

公开命令边界

  • 就绪检查: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,并指定帖子上限、评论上限

只有在平台范围或证据解读仍不明确时,才查阅 平台契约;它不是预检步骤。

证据质量

  1. 得出结论前先对记录分类:发现到的帖子用于识别讨论串;评论中的主张需要实际评论作为依据。
  2. 对关键词评论研究,先发现帖子,再检查最多三个相关讨论串;如果发现效果不佳,应先更换查询词,再扩大范围。
  3. 成功但结果不足时,最多进行两轮调整后的后续检索,且不得超出已批准的范围和预算;不要重复完全相同的请求,也不要隐瞒失败或待处理的操作。
  4. 结果充分、达到上限,或进一步检索无济于事时,应停止。报告有用证据及不确定性;保留原始结果和来源链接。

使用 dataType + id 进行去重;保留评论的父级 ID 和深度。缺失值表示未知,不是零。 完整的机器可读字段位于 postplus research schema --route <route> --json; 仅在处理需要时查阅,不要在每次请求前都查阅。

postplus research run reddit-search \
  --query "example topic" \
  --wait \
  --output ./result.json

遵循 CLI 提供的结构化结果和报告的后续操作;不要根据自由文本消息推断如何恢复。 如果用户已明确批准且批准范围和最高费用涵盖当前请求,可沿用该批准;否则,在确认报价前必须先取得批准。不得仅凭任务本身推断用户授权了支出。 通过返回的检查点或操作恢复同一项操作;绝不要重新提交结果不确定的工作、重复已耗尽的恢复尝试,或切换提供商以绕过失败。

评论

支持 Markdown