reddit-api

What This Skill Does

The reddit-api skill for OpenClaw is a powerful interface designed to perform full-text searches across over 100 million indexed Reddit entries. Unlike the standard Reddit API, which often restricts searching capabilities and requires complex OAuth configurations, this skill leverages the Xpoz MCP framework to provide seamless access to posts, comments, users, and subreddit data. It allows users to execute complex boolean queries, perform historical research back to 2019, and export large datasets directly to CSV, making it an essential tool for community analysis and sentiment tracking.

Installation

To begin using the Reddit Search capabilities, follow these two simple steps:

1. Run the command clawhub install openclaw/skills/skills/atyachin/reddit-api in your terminal.
2. Execute the xpoz-setup skill to handle the necessary authentication. Once the user clicks "Authorize" in the prompted interface, verify the connection by running mcporter call xpoz.checkAccessKeyStatus.

Use Cases

• Market Research: Identify trending topics by searching specific keywords across thousands of comments to understand user sentiment.
• Technical Troubleshooting: Find solutions to niche coding or infrastructure problems by searching through deep technical discussions in subreddits like r/kubernetes or r/python.
• Community Discovery: Locate highly active and relevant communities for specific niches or projects using the subreddit discovery tools.
• Engagement Analysis: Export large-scale datasets (up to 64,000 rows) of post history for analysis or report generation.

Example Prompts

1. "Search for the latest Reddit comments from the last month that discuss 'rust lang' and 'webAssembly' to find out what developers are struggling with."
2. "Find the top 20 subreddits related to sustainable energy, then export the most recent post history for the top 5 contributors in those groups."
3. "List all recent posts about 'OpenAI o1 model' that mention 'hallucinations' so I can summarize the current community consensus."

Tips & Limitations

• Boolean Logic: Utilize the power of AND, OR, NOT, and parentheses for complex filtering to narrow down your search results effectively.
• Asynchronous Processing: Since large searches can take time, always remember to poll the dataDumpExportOperationId provided by the system to retrieve your final CSV download link.
• Data Depth: Remember that comment search is often more valuable than post search, as that is where technical expertise and nuance typically reside. The search index currently covers data back to 2019, which is significantly more than what is available via standard official endpoints.