reddit-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Reddit Search

Reddit搜索

Use this skill when the user wants public Reddit post evidence — audience voice, pain points, product opinions, community discussion links — starting from a keyword.

Apply

references/shared-contract.md

first, then

references/search.md

for the keyword discovery workflow.

当用户需要基于关键词获取公开Reddit帖子相关证据——包括受众声音、痛点、产品评价、社区讨论链接时，使用此技能。

先应用

references/shared-contract.md

，再应用

references/search.md

来执行关键词发现工作流。

Job

任务

Turn one keyword into a bounded set of Reddit posts. Return each result normalized to

{ title, post_url, community, score, comments_count, created_at, snippet }

, deduplicated by post URL. Run the smallest first pass that can answer the request, then stop and report scope, count, strongest results, and next action.

将单个关键词转换为一组受限的Reddit帖子。返回的每个结果需标准化为

{ title, post_url, community, score, comments_count, created_at, snippet }

格式，并根据帖子URL去重。先运行能满足请求的最小范围首轮搜索，然后停止并报告搜索范围、结果数量、最相关结果以及后续操作建议。

Reference Index

参考索引

User asks for	Apply
Any Reddit post search from a keyword	`references/shared-contract.md` , then `references/search.md`
Broader pass: more results, another sort, a different time range, or a second keyword	`references/search.md`
Comment scrapes, subreddit feeds, profile scrapes, post-URL scrapes	Not supported on the current public surface. Say so and stop
Non-Reddit sources	Hand off; run only the Reddit lane here

用户需求	应用文档
基于关键词的任意Reddit帖子搜索	`references/shared-contract.md` ，随后 `references/search.md`
更广泛的搜索：更多结果、其他排序方式、不同时间范围或第二个关键词	`references/search.md`
评论抓取、子版块订阅源抓取、个人主页抓取、单帖子URL抓取	当前公开功能不支持此操作，请告知用户并停止执行
非Reddit来源的搜索	转交其他处理流程；此技能仅处理Reddit相关搜索

First Question

首个问题

Ask one question only when the answer changes the route, first-pass scope, or output shape.

Missing	Ask
Keyword	`What keyword should I search Reddit for?`
Too broad	`Which one keyword matters most for the first pass?`
Recency intent	`Should results cover all time, or only the last year?`

Do not ask the user for credentials, implementation choice, collection keys, schema fields, hidden filters, or retry strategy.

仅当答案会改变搜索路径、首轮搜索范围或输出格式时，才询问一个问题。

缺失信息	询问内容
关键词	`要在Reddit上搜索哪个关键词？`
需求过于宽泛	`首轮搜索最核心的关键词是哪一个？`
时效性需求	`结果应覆盖所有时间范围，还是仅过去一年？`

请勿向用户索要凭证、实现方案选择、收集密钥、schema字段、隐藏过滤器或重试策略。

Run Discipline

执行规范

Apply
```
references/shared-contract.md
```
.
Apply
```
references/search.md
```
.
Run the narrowest collection that can answer the first pass; start at 20 posts.

Normalize output to

{ title, post_url, community, score, comments_count, created_at, snippet }

and deduplicate by post URL.

Stop after the first pass and report scope, count, strongest results, limits, and next action.

The result record shape for the collection key is documented in the

postplus-shared

reference

dataset-item-schemas.md

; consult it before writing result-processing code, and probe a single record only to verify.

Do not present a bounded first pass as the full Reddit catalog. Do not add hosted envelopes, hidden implementation fields, unsupported filters, or compatibility fallbacks to the request.

应用
```
references/shared-contract.md
```
。
应用
```
references/search.md
```
。
运行能满足首轮请求的最窄范围搜索；初始搜索20条帖子。

将输出标准化为

{ title, post_url, community, score, comments_count, created_at, snippet }

格式，并根据帖子URL去重。

首轮搜索结束后停止，报告搜索范围、结果数量、最相关结果、限制条件以及后续操作建议。

收集结果的记录格式在

postplus-shared

参考文档

dataset-item-schemas.md

中有说明；编写结果处理代码前请查阅该文档，仅需探查单条记录以验证格式。

请勿将受限的首轮搜索结果表述为完整的Reddit目录。请勿向请求中添加托管信封、隐藏实现字段、不支持的过滤器或兼容回退机制。

Public Command Boundary

公开命令边界

Build the raw request object

{ "searchTerms": ["..."], "searchSort": "relevance", "searchTime": "year", "maxPostsCount": 20 }

(

searchSort

relevance

hot

top

new

, or

comments

;

searchTime

all

hour

day

week

month

, or

year

) and run the collect verb directly.

Readiness diagnostics:
```
postplus doctor --skill reddit-search
```
.
If the owned CLI command fails, report the exact error and stop. Do not bypass the failure with metadata-only answers, readiness probing, local payload rewrites, fallback services, or unpublished tools.
Use
```
postplus research schema --collection-key reddit-search --json
```
only when constructing or repairing an unknown request shape.

Hosted collection:

postplus research collect reddit-search --request <input.json> --output <result.json>

where the request file is the raw collection input object, not a hosted envelope and not

{ "schemaVersion": 1, "input": ... }

Resume a pending collection:
```
postplus research collect --run-handle <runHandle> --output <result.json>
```
(waits in-command up to 45s per invocation; rerun while pending).
Keep the first pass bounded; expand only after inspecting the first result.
If the CLI returns a quote-confirmation challenge, run
```
postplus quote confirm --json --challenge-file <challenge.json>
```
and retry with the returned token.

bash

postplus research collect reddit-search --request request.json --output result.json

构建原始请求对象

{ "searchTerms": ["..."], "searchSort": "relevance", "searchTime": "year", "maxPostsCount": 20 }

(

searchSort

可选值为

relevance

hot

top

new

, 或

comments

;

searchTime

可选值为

all

hour

day

week

month

, 或

year

)，然后直接执行收集命令。

就绪性诊断：
```
postplus doctor --skill reddit-search
```
。
如果自有CLI命令执行失败，报告具体错误并停止。请勿通过仅返回元数据、就绪性探测、本地负载重写、回退服务或未发布工具来绕过失败。

仅在构建或修复未知请求格式时，使用

postplus research schema --collection-key reddit-search --json

。

托管收集命令：

postplus research collect reddit-search --request <input.json> --output <result.json>

其中请求文件为原始收集输入对象，而非托管信封或

{ "schemaVersion": 1, "input": ... }

格式。

恢复待处理的收集任务：
```
postplus research collect --run-handle <runHandle> --output <result.json>
```
（每次调用在命令中最多等待45秒；任务待处理时可重新运行）。
首轮搜索保持受限范围；仅在查看首轮结果后再扩大范围。
如果CLI返回报价确认挑战，执行
```
postplus quote confirm --json --challenge-file <challenge.json>
```
并使用返回的令牌重试。

bash

postplus research collect reddit-search --request request.json --output result.json