Skip to content

XPOZpublic/xpoz-clawhub-skills / reddit-api

reddit-api

Verified

Reddit Search: search posts, comments, users, and subreddits across Xpoz's indexed Reddit archive. Find discussions, track topics, discover communities, and analyze engagement. No Reddit API key needed; works through Xpoz MCP with natural language queries.

FileKindSize
SKILL.mdskill md4.0 KB
---
name: reddit-api
description: "Reddit Search: search posts, comments, users, and subreddits across Xpoz's indexed Reddit archive. Find discussions, track topics, discover communities, and analyze engagement. No Reddit API key needed; works through Xpoz MCP with natural language queries."
homepage: https://xpoz.ai
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["mcporter"], "skills": ["xpoz-setup"], "network": ["mcp.xpoz.ai"], "credentials": "Xpoz account (free tier) β€” auth via xpoz-setup skill" },
        "install": [{"id": "node", "kind": "node", "package": "mcporter", "bins": ["mcporter"], "label": "Install mcporter (npm)"}],
      },
  }
tags:
  - reddit
  - reddit-search
  - reddit-api
  - subreddit
  - reddit-comments
  - reddit-posts
  - community
  - discussion
  - social-media
  - mcp
  - xpoz
  - research
---

# Reddit Search

**Search Reddit posts and comments at scale 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`](https://clawhub.ai/skills/xpoz-setup)** β€” handles auth automatically. User just clicks "Authorize" once.

---

## 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

```bash
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:

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

### Find Subreddits

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

### Look Up a User

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

---

## Boolean Queries

- `AND`, `OR`, `NOT` (uppercase)
- `"exact phrase"` for precise matching
- `()` for grouping

```bash
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):

```bash
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](https://clawhub.ai/skills/xpoz-social-search)** β€” Cross-platform search (Twitter + Instagram + Reddit)
- **[expert-finder](https://clawhub.ai/skills/expert-finder)** β€” Find domain experts from social data
- **[social-sentiment](https://clawhub.ai/skills/social-sentiment)** β€” Brand sentiment analysis

---

**Website:** [xpoz.ai](https://xpoz.ai) β€’ **Free tier available** β€’ No Reddit API key needed

Built for ClawHub β€’ 2026
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β€” repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β€” or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself β€” your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall