How do I install the Reddit API skill?

Run npx skillmds@latest add modbender/reddit-api in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Reddit API safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Reddit API?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Reddit API free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Reddit API?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Reddit API by modbender — Agent Skill

Name: Reddit API
Rating: 4.5 (4 reviews)
Author: modbender

Reddit API

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.

modbender Updated Sep 9, 2026 12 repo stars

File contents

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

---name: reddit-apidescription: 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.--- # 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 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

Frequently asked questions