Skills reddit-api

Name: reddit-api
Author: openclaw

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.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/atyachin/reddit-api" ~/.claude/skills/openclaw-skills-reddit-api && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/atyachin/reddit-api" ~/.openclaw/skills/openclaw-skills-reddit-api && rm -rf "$T"

manifest: skills/atyachin/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

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