Reddit Automation Skill for Cursor

Reddit Automation via Rube MCP

Automate Reddit operations through Composio's Reddit toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/reddit

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Reddit connection via RUBE_MANAGE_CONNECTIONS with toolkit reddit
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

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.

• Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
• Call RUBE_MANAGE_CONNECTIONS with toolkit reddit
• If connection is not ACTIVE, follow the returned auth link to complete Reddit OAuth
• Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Search Reddit

When to use: User wants to find posts across subreddits

Tool sequence:

• REDDIT_SEARCH_ACROSS_SUBREDDITS - Search for posts matching a query [Required]

Key parameters:

• query: Search terms
• subreddit: Limit search to a specific subreddit (optional)
• sort: Sort results by 'relevance', 'hot', 'top', 'new', 'comments'
• time_filter: Time range ('hour', 'day', 'week', 'month', 'year', 'all')
• limit: Number of results to return

Pitfalls:

• Search results may not include very recent posts due to indexing delay
• The time_filter parameter only works with certain sort options
• Results are paginated; use after/before tokens for additional pages
• NSFW content may be filtered based on account settings

2. Create Posts

When to use: User wants to submit a new post to a subreddit

Tool sequence:

• REDDIT_LIST_SUBREDDIT_POST_FLAIRS - Get available post flairs [Optional]
• REDDIT_CREATE_REDDIT_POST - Submit the post [Required]

Key parameters:

• subreddit: Target subreddit name (without 'r/' prefix)
• title: Post title
• text: Post body text (for text posts)
• url: Link URL (for link posts)
• flair_id: Flair ID from the subreddit's flair list

Pitfalls:

• Some subreddits require flair; use LIST_SUBREDDIT_POST_FLAIRS first
• Subreddit posting rules vary widely; karma/age restrictions may apply
• Text and URL are mutually exclusive; a post is either text or link
• Rate limits apply; avoid rapid successive post creation
• The subreddit name should not include 'r/' prefix

3. Manage Comments

When to use: User wants to comment on posts or manage existing comments

Tool sequence:

• REDDIT_RETRIEVE_POST_COMMENTS - Get comments on a post [Optional]
• REDDIT_POST_REDDIT_COMMENT - Add a comment to a post or reply to a comment [Required]
• REDDIT_EDIT_REDDIT_COMMENT_OR_POST - Edit an existing comment [Optional]
• REDDIT_DELETE_REDDIT_COMMENT - Delete a comment [Optional]

Key parameters:

• post_id: ID of the post (for retrieving or commenting on)
• parent_id: Full name of the parent (e.g., 't3_abc123' for post, 't1_xyz789' for comment)
• body: Comment text content
• thing_id: Full name of the item to edit or delete

Pitfalls:

• Reddit uses 'fullname' format: 't1_' prefix for comments, 't3_' for posts
• Editing replaces the entire comment body; include all desired content
• Deleted comments show as '[deleted]' but the tree structure remains
• Comment depth limits may apply in some subreddits

4. Browse Subreddit Content

When to use: User wants to view top or trending content from a subreddit

Tool sequence:

• REDDIT_GET_R_TOP - Get top posts from a subreddit [Required]
• REDDIT_GET - Get posts from a subreddit endpoint [Alternative]
• REDDIT_RETRIEVE_REDDIT_POST - Get full details for a specific post [Optional]

Key parameters:

• subreddit: Subreddit name
• time_filter: Time range for top posts ('hour', 'day', 'week', 'month', 'year', 'all')
• limit: Number of posts to retrieve
• post_id: Specific post ID for full details

Pitfalls:

• Top posts with time_filter='all' returns all-time top content
• Post details include the body text but comments require a separate call
• Some posts may be removed or hidden based on subreddit rules
• NSFW posts are included unless filtered at the account level

5. Manage Posts

When to use: User wants to edit or delete their own posts

Tool sequence:

• REDDIT_EDIT_REDDIT_COMMENT_OR_POST - Edit a post's text content [Optional]
• REDDIT_DELETE_REDDIT_POST - Delete a post [Optional]
• REDDIT_GET_USER_FLAIR - Get user's flair in a subreddit [Optional]

Key parameters:

• thing_id: Full name of the post (e.g., 't3_abc123')
• body: New text content (for editing)
• subreddit: Subreddit name (for flair)

Pitfalls:

• Only text posts can have their body edited; link posts cannot be modified
• Post titles cannot be edited after submission
• Deletion is permanent; deleted posts show as '[deleted]'
• User flair is per-subreddit and may be restricted

Common Patterns

Reddit Fullname Format

Prefixes:

t1_ = Comment (e.g., 't1_abc123')
t2_ = Account (e.g., 't2_xyz789')
t3_ = Post/Link (e.g., 't3_def456')
t4_ = Message
t5_ = Subreddit

Usage:

1. Retrieve a post to get its fullname (t3_XXXXX)
2. Use fullname as parent_id when commenting
3. Use fullname as thing_id when editing/deleting

Pagination

• Reddit uses cursor-based pagination with 'after' and 'before' tokens
• Set limit for items per page (max 100)
• Check response for after token
• Pass after value in subsequent requests to get next page

Flair Resolution

1. Call REDDIT_LIST_SUBREDDIT_POST_FLAIRS with subreddit name
2. Find matching flair by text or category
3. Extract flair_id
4. Include flair_id when creating the post

Known Pitfalls

Rate Limits:

• Reddit enforces rate limits per account and per OAuth app
• Posting is limited to approximately 1 post per 10 minutes for new accounts
• Commenting has similar but less restrictive limits
• 429 errors should trigger exponential backoff

Content Rules:

• Each subreddit has its own posting rules and requirements
• Some subreddits are restricted or private
• Karma requirements may prevent posting in certain subreddits
• Auto-moderator rules may remove posts that match certain patterns

ID Formats:

• Always use fullname format (with prefix) for parent_id and thing_id
• Raw IDs without prefix will cause 'Invalid ID' errors
• Post IDs from search results may need 't3_' prefix added

Text Formatting:

• Reddit uses Markdown for post and comment formatting
• Code blocks, tables, and headers are supported
• Links use text format
• Mention users with u/username, subreddits with r/subreddit

Quick Reference

| Task | Tool Slug | Key Params |

|------|-----------|------------|

| Search Reddit | REDDIT_SEARCH_ACROSS_SUBREDDITS | query, subreddit, sort, time_filter |

| Create post | REDDIT_CREATE_REDDIT_POST | subreddit, title, text/url |

| Get post comments | REDDIT_RETRIEVE_POST_COMMENTS | post_id |

| Add comment | REDDIT_POST_REDDIT_COMMENT | parent_id, body |

| Edit comment/post | REDDIT_EDIT_REDDIT_COMMENT_OR_POST | thing_id, body |

| Delete comment | REDDIT_DELETE_REDDIT_COMMENT | thing_id |

| Delete post | REDDIT_DELETE_REDDIT_POST | thing_id |

| Get top posts | REDDIT_GET_R_TOP | subreddit, time_filter, limit |

| Browse subreddit | REDDIT_GET | subreddit |

| Get post details | REDDIT_RETRIEVE_REDDIT_POST | post_id |

| Get specific comment | REDDIT_RETRIEVE_SPECIFIC_COMMENT | comment_id |

| List post flairs | REDDIT_LIST_SUBREDDIT_POST_FLAIRS | subreddit |

| Get user flair | REDDIT_GET_USER_FLAIR | subreddit |

*Powered by Composio*