reddit-search

Original：🇺🇸 English

Translated

Route and run bounded public Reddit post search that turns a keyword into normalized post records — title, post URL, community, score, comment count, and created time — for audience voice, pain-point mining, and topic research.

5installs

Sourcepostplusai/postplus-skills

Added on2026-08-13

NPX Install

npx skill4agent add postplusai/postplus-skills reddit-search

SKILL.md Content

View Translation Comparison →

Reddit Search

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.

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.

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

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.

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.

Public Command Boundary

Build the raw request object

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

(

searchSort

is

relevance

,

hot

,

top

,

new

, or

comments

;

searchTime

is

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