SkillHub

reddit-api

v1.2.0

Reddit Search — Search posts, comments, users, and subreddits across 100M+ indexed Reddit entries. Find discussions, track topics, discover communities, and analyze engagement. No Reddit API key needed — works through Xpoz MCP with natural language queries.

Sourced from ClawHub, Authored by atyachin

Installation

Please help me install the skill `reddit-api` from SkillHub official store. npx skills add atyachin/reddit-api

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

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
  • xpoz-social-search — Cross-platform search (Twitter + Instagram + Reddit)
  • expert-finder — Find domain experts from social data
  • social-sentiment — Brand sentiment analysis

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

Built for ClawHub • 2026