Reddit Automation

1---
2name: reddit-automation
3description: "Automate Reddit tasks via Rube MCP (Composio): search subreddits, create posts, manage comments, and browse top content. Always search tools first for current schemas."
4requires:
5  mcp: [rube]
6---
7 
8# Reddit Automation via Rube MCP
9 
10Automate Reddit operations through Composio's Reddit toolkit via Rube MCP.
11 
12## Prerequisites
13 
14- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
15- Active Reddit connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `reddit`
16- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas
17 
18## Setup
19 
20**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
21 
22 
231. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
242. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `reddit`
253. If connection is not ACTIVE, follow the returned auth link to complete Reddit OAuth
264. Confirm connection status shows ACTIVE before running any workflows
27 
28## Core Workflows
29 
30### 1. Search Reddit
31 
32**When to use**: User wants to find posts across subreddits
33 
34**Tool sequence**:
351. `REDDIT_SEARCH_ACROSS_SUBREDDITS` - Search for posts matching a query [Required]
36 
37**Key parameters**:
38- `query`: Search terms
39- `subreddit`: Limit search to a specific subreddit (optional)
40- `sort`: Sort results by 'relevance', 'hot', 'top', 'new', 'comments'
41- `time_filter`: Time range ('hour', 'day', 'week', 'month', 'year', 'all')
42- `limit`: Number of results to return
43 
44**Pitfalls**:
45- Search results may not include very recent posts due to indexing delay
46- The `time_filter` parameter only works with certain sort options
47- Results are paginated; use after/before tokens for additional pages
48- NSFW content may be filtered based on account settings
49 
50### 2. Create Posts
51 
52**When to use**: User wants to submit a new post to a subreddit
53 
54**Tool sequence**:
551. `REDDIT_LIST_SUBREDDIT_POST_FLAIRS` - Get available post flairs [Optional]
562. `REDDIT_CREATE_REDDIT_POST` - Submit the post [Required]
57 
58**Key parameters**:
59- `subreddit`: Target subreddit name (without 'r/' prefix)
60- `title`: Post title
61- `text`: Post body text (for text posts)
62- `url`: Link URL (for link posts)
63- `flair_id`: Flair ID from the subreddit's flair list
64 
65**Pitfalls**:
66- Some subreddits require flair; use LIST_SUBREDDIT_POST_FLAIRS first
67- Subreddit posting rules vary widely; karma/age restrictions may apply
68- Text and URL are mutually exclusive; a post is either text or link
69- Rate limits apply; avoid rapid successive post creation
70- The subreddit name should not include 'r/' prefix
71 
72### 3. Manage Comments
73 
74**When to use**: User wants to comment on posts or manage existing comments
75 
76**Tool sequence**:
771. `REDDIT_RETRIEVE_POST_COMMENTS` - Get comments on a post [Optional]
782. `REDDIT_POST_REDDIT_COMMENT` - Add a comment to a post or reply to a comment [Required]
793. `REDDIT_EDIT_REDDIT_COMMENT_OR_POST` - Edit an existing comment [Optional]
804. `REDDIT_DELETE_REDDIT_COMMENT` - Delete a comment [Optional]
81 
82**Key parameters**:
83- `post_id`: ID of the post (for retrieving or commenting on)
84- `parent_id`: Full name of the parent (e.g., 't3_abc123' for post, 't1_xyz789' for comment)
85- `body`: Comment text content
86- `thing_id`: Full name of the item to edit or delete
87 
88**Pitfalls**:
89- Reddit uses 'fullname' format: 't1_' prefix for comments, 't3_' for posts
90- Editing replaces the entire comment body; include all desired content
91- Deleted comments show as '[deleted]' but the tree structure remains
92- Comment depth limits may apply in some subreddits
93 
94### 4. Browse Subreddit Content
95 
96**When to use**: User wants to view top or trending content from a subreddit
97 
98**Tool sequence**:
991. `REDDIT_GET_R_TOP` - Get top posts from a subreddit [Required]
1002. `REDDIT_GET` - Get posts from a subreddit endpoint [Alternative]
1013. `REDDIT_RETRIEVE_REDDIT_POST` - Get full details for a specific post [Optional]
102 
103**Key parameters**:
104- `subreddit`: Subreddit name
105- `time_filter`: Time range for top posts ('hour', 'day', 'week', 'month', 'year', 'all')
106- `limit`: Number of posts to retrieve
107- `post_id`: Specific post ID for full details
108 
109**Pitfalls**:
110- Top posts with time_filter='all' returns all-time top content
111- Post details include the body text but comments require a separate call
112- Some posts may be removed or hidden based on subreddit rules
113- NSFW posts are included unless filtered at the account level
114 
115### 5. Manage Posts
116 
117**When to use**: User wants to edit or delete their own posts
118 
119**Tool sequence**:
1201. `REDDIT_EDIT_REDDIT_COMMENT_OR_POST` - Edit a post's text content [Optional]
1212. `REDDIT_DELETE_REDDIT_POST` - Delete a post [Optional]
1223. `REDDIT_GET_USER_FLAIR` - Get user's flair in a subreddit [Optional]
123 
124**Key parameters**:
125- `thing_id`: Full name of the post (e.g., 't3_abc123')
126- `body`: New text content (for editing)
127- `subreddit`: Subreddit name (for flair)
128 
129**Pitfalls**:
130- Only text posts can have their body edited; link posts cannot be modified
131- Post titles cannot be edited after submission
132- Deletion is permanent; deleted posts show as '[deleted]'
133- User flair is per-subreddit and may be restricted
134 
135## Common Patterns
136 
137### Reddit Fullname Format
138 
139**Prefixes**:
140```
141t1_ = Comment (e.g., 't1_abc123')
142t2_ = Account (e.g., 't2_xyz789')
143t3_ = Post/Link (e.g., 't3_def456')
144t4_ = Message
145t5_ = Subreddit
146```
147 
148**Usage**:
149```
1501. Retrieve a post to get its fullname (t3_XXXXX)
1512. Use fullname as parent_id when commenting
1523. Use fullname as thing_id when editing/deleting
153```
154 
155### Pagination
156 
157- Reddit uses cursor-based pagination with 'after' and 'before' tokens
158- Set `limit` for items per page (max 100)
159- Check response for `after` token
160- Pass `after` value in subsequent requests to get next page
161 
162### Flair Resolution
163 
164```
1651. Call REDDIT_LIST_SUBREDDIT_POST_FLAIRS with subreddit name
1662. Find matching flair by text or category
1673. Extract flair_id
1684. Include flair_id when creating the post
169```
170 
171## Known Pitfalls
172 
173**Rate Limits**:
174- Reddit enforces rate limits per account and per OAuth app
175- Posting is limited to approximately 1 post per 10 minutes for new accounts
176- Commenting has similar but less restrictive limits
177- 429 errors should trigger exponential backoff
178 
179**Content Rules**:
180- Each subreddit has its own posting rules and requirements
181- Some subreddits are restricted or private
182- Karma requirements may prevent posting in certain subreddits
183- Auto-moderator rules may remove posts that match certain patterns
184 
185**ID Formats**:
186- Always use fullname format (with prefix) for parent_id and thing_id
187- Raw IDs without prefix will cause 'Invalid ID' errors
188- Post IDs from search results may need 't3_' prefix added
189 
190**Text Formatting**:
191- Reddit uses Markdown for post and comment formatting
192- Code blocks, tables, and headers are supported
193- Links use `[text](url)` format
194- Mention users with `u/username`, subreddits with `r/subreddit`
195 
196## Quick Reference
197 
198| Task | Tool Slug | Key Params |
199|------|-----------|------------|
200| Search Reddit | REDDIT_SEARCH_ACROSS_SUBREDDITS | query, subreddit, sort, time_filter |
201| Create post | REDDIT_CREATE_REDDIT_POST | subreddit, title, text/url |
202| Get post comments | REDDIT_RETRIEVE_POST_COMMENTS | post_id |
203| Add comment | REDDIT_POST_REDDIT_COMMENT | parent_id, body |
204| Edit comment/post | REDDIT_EDIT_REDDIT_COMMENT_OR_POST | thing_id, body |
205| Delete comment | REDDIT_DELETE_REDDIT_COMMENT | thing_id |
206| Delete post | REDDIT_DELETE_REDDIT_POST | thing_id |
207| Get top posts | REDDIT_GET_R_TOP | subreddit, time_filter, limit |
208| Browse subreddit | REDDIT_GET | subreddit |
209| Get post details | REDDIT_RETRIEVE_REDDIT_POST | post_id |
210| Get specific comment | REDDIT_RETRIEVE_SPECIFIC_COMMENT | comment_id |
211| List post flairs | REDDIT_LIST_SUBREDDIT_POST_FLAIRS | subreddit |
212| Get user flair | REDDIT_GET_USER_FLAIR | subreddit |
213