| name | pullpush-reddit |
| description | Search Reddit historical data using the PullPush MCP tools (search_comments and search_submissions). Use this skill whenever the user wants to search Reddit, find Reddit posts or comments, look up what people said on Reddit about a topic, research Reddit discussions, find a user's Reddit history, or analyze Reddit sentiment. Also trigger when the user mentions subreddits, Reddit threads, or wants to find opinions/discussions from Reddit — even if they don't say "PullPush" explicitly. |
PullPush Reddit Search
Search Reddit's historical data through PullPush.io. This gives you access to Reddit comments and submissions, including content that may no longer be available through Reddit's official API.
Tools Available
You have two MCP tools:
mcp__pullpush__search_comments — Search Reddit commentsmcp__pullpush__search_submissions — Search Reddit posts/submissions
Both tools connect to the PullPush.io API, which is free and requires no authentication.
Search Strategy
Start broad, then narrow. Begin with a simple keyword query, then add filters based on what you find. Don't over-constrain on the first search — you might miss relevant results.
Choose the right tool for the question:
- "What are people saying about X?" → search_comments (opinions live in comments)
- "What posts exist about X?" → search_submissions (find the threads themselves)
- For thorough research, search both — submissions give you the topics, comments give you the discussion
Combine filters effectively:
- Topic + subreddit:
q: "rust async" + subreddit: "programming"
- Time-bounded:
after: "90d" for recent, after: "2023-01-01" for specific periods
- High-quality content:
score: ">50" or sort_type: "score" to surface popular content
- Prolific users:
author: "username" to see someone's posting history
Parameter Reference
search_comments
| Parameter | Type | Description |
|---|
| q | string | Search query across all fields |
| subreddit | string | Subreddit name (no r/ prefix) |
| author | string | Username filter |
| after | string | After date — epoch timestamp or relative: '30d', '1y' |
| before | string | Before date — same formats as after |
| sort | 'asc' | 'desc' | Sort order (default: desc) |
| sort_type | 'created_utc' | 'score' | Sort field (default: created_utc) |
| size | number | Results count, 1-100 (default: 100) |
search_submissions
All comment parameters plus:
| Parameter | Type | Description |
|---|
| title | string | Search titles only |
| selftext | string | Search post body only |
| sort_type | + 'num_comments' | Can also sort by comment count |
| score | string | Score filter: '>100', '<50', or exact |
| num_comments | string | Comment count filter: '>10', '<5', or exact |
| over_18 | boolean | NSFW filter (true=only, false=exclude) |
| is_video | boolean | Video post filter |
| locked | boolean | Locked post filter |
| stickied | boolean | Stickied post filter |
| spoiler | boolean | Spoiler post filter |
Date Formats
The after and before parameters accept:
- Relative dates:
'30d' (30 days ago), '1y' (1 year ago), '6h' (6 hours ago)
- Epoch timestamps:
'1672531200' (Jan 1 2023)
Relative dates are usually more intuitive. Use them by default.
Tips
- Default size differs: comments default to 100 results, submissions to 25. Set
size explicitly if you need more or fewer.
- selftext is truncated: Post body text in results is limited to 500 characters. If you need full text, note this limitation to the user.
- No authentication needed: PullPush.io is free and open. No API keys required.
- Historical data: This covers Reddit's history — it can find posts and comments that have been deleted from Reddit itself.
- Combine multiple searches: For research tasks, run several searches with different queries or filters to build a complete picture. Don't rely on a single search.
- Present results clearly: Summarize findings with key quotes, links (via permalink), and patterns you notice. Don't just dump raw JSON.
