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`](https://clawhub.ai/skills/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

```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 ru...