reddit-automation - Agent Skills

Reddit Automation via Rube MCP

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

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)
Use fullname as parent_id when commenting

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
Find matching flair by text or category

Extract flair_id

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