reddit-api

SKILL.md

Reddit Search

Search 100M+ Reddit posts and comments without a Reddit API key.

Find discussions, discover subreddits, look up users, and export results — all through Xpoz MCP. No Reddit API credentials needed, no rate limit headaches, no OAuth setup with Reddit.


âš¡ Setup

👉 Follow xpoz-setup — handles auth automatically. User just clicks "Authorize" once.


Setup

Run xpoz-setup skill. Verify: mcporter call xpoz.checkAccessKeyStatus

What You Can Search

Tool What It Does
getRedditPostsByKeywords Search posts by topic
getRedditCommentsByKeywords Search comments (where deep expertise lives)
getRedditUsersByKeywords Find users discussing a topic
getRedditSubredditsByKeywords Discover relevant communities
getRedditPostsByAuthor Get a user's post history
getRedditUser Look up a specific profile
searchRedditUsers Find users by name

Quick Examples

Search Posts

mcporter call xpoz.getRedditPostsByKeywords \
  query="self hosting AND docker" \
  startDate=2026-01-01 \
  limit=100

# Always poll for results:
mcporter call xpoz.checkOperationStatus operationId=op_abc123

Search Comments

Comments often contain the deepest expertise — practitioners sharing real experience:

mcporter call xpoz.getRedditCommentsByKeywords \
  query="kubernetes networking troubleshoot" \
  fields='["id","text","authorUsername","subredditName","score","createdAtDate"]'

Find Subreddits

mcporter call xpoz.getRedditSubredditsByKeywords \
  query="machine learning" \
  limit=30

Look Up a User

mcporter call xpoz.getRedditUser \
  identifier=spez \
  identifierType=username

Boolean Queries

  • AND, OR, NOT (uppercase)
  • "exact phrase" for precise matching
  • () for grouping
mcporter call xpoz.getRedditPostsByKeywords \
  query="(python OR rust) AND \"web scraping\" NOT selenium"

CSV Export

Every search returns a dataDumpExportOperationId. Poll it to get a download URL with the full dataset (up to 64K rows):

mcporter call xpoz.checkOperationStatus operationId=op_datadump_xyz
# → result.url = S3 download link

Why Not Use the Reddit API Directly?

Reddit API Xpoz Reddit Search
Auth OAuth + client ID + secret One-click Xpoz auth
Rate limits 100 requests/min Handled automatically
Search quality Reddit's search is notoriously poor Full-text indexed, boolean operators
Comments No keyword search for comments ✅ Full comment search
Export Manual pagination One-click CSV (64K rows)
Historical Limited Back to 2019

Related Skills


Website: xpoz.ai • Free tier available • No Reddit API key needed

Built for ClawHub • 2026

Weekly Installs
2
Repository
openclaw/skills
GitHub Stars
3.8K
First Seen
Feb 19, 2026
Installed on
amp2
openclaw2
opencode2
kimi-cli2
codex2
github-copilot2