Twitter Automation Agent Skill

Twitter/X Automation via Rube MCP

Automate Twitter/X operations through Composio's Twitter toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/twitter

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Twitter connection via RUBE_MANAGE_CONNECTIONS with toolkit twitter
• 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 twitter
• If connection is not ACTIVE, follow the returned auth link to complete Twitter OAuth
• Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Create and Manage Posts

When to use: User wants to create, delete, or look up tweets/posts

Tool sequence:

• TWITTER_USER_LOOKUP_ME - Get authenticated user info [Prerequisite]
• TWITTER_UPLOAD_MEDIA / TWITTER_UPLOAD_LARGE_MEDIA - Upload media [Optional]
• TWITTER_CREATION_OF_A_POST - Create a new post [Required]
• TWITTER_POST_LOOKUP_BY_POST_ID - Look up a specific post [Optional]
• TWITTER_POST_DELETE_BY_POST_ID - Delete a post [Optional]

Key parameters:

• text: Post text content (max 280 weighted characters)
• media__media_ids: Array of media ID strings for attachments
• reply__in_reply_to_tweet_id: Tweet ID to reply to
• quote_tweet_id: Tweet ID to quote
• id: Post ID for lookup/delete

Pitfalls:

• Post text is limited to 280 weighted characters; some characters count as more than one
• Posting is NOT idempotent; retrying on timeout will create duplicate posts
• Media IDs must be numeric strings, not integers
• UPLOAD_LARGE_MEDIA is for videos/GIFs; UPLOAD_MEDIA for images
• Always call USER_LOOKUP_ME first to get the authenticated user's ID

2. Search Posts

When to use: User wants to find tweets matching specific criteria

Tool sequence:

• TWITTER_RECENT_SEARCH - Search recent tweets (last 7 days) [Required]
• TWITTER_FULL_ARCHIVE_SEARCH - Search full archive (Academic access) [Optional]
• TWITTER_RECENT_SEARCH_COUNTS - Get tweet count matching query [Optional]

Key parameters:

• query: Search query using Twitter search operators
• max_results: Results per page (10-100)
• next_token: Pagination token
• start_time/end_time: ISO 8601 time range
• tweet__fields: Comma-separated fields to include
• expansions: Related objects to expand

Pitfalls:

• RECENT_SEARCH covers only the last 7 days; use FULL_ARCHIVE_SEARCH for older tweets
• FULL_ARCHIVE_SEARCH requires Academic Research or Enterprise access
• Query operators: from:username, to:username, is:retweet, has:media, -is:retweet
• Empty results return meta.result_count: 0 with no data field
• Rate limits vary by endpoint and access level; check response headers

3. Look Up Users

When to use: User wants to find or inspect Twitter user profiles

Tool sequence:

• TWITTER_USER_LOOKUP_ME - Get authenticated user [Optional]
• TWITTER_USER_LOOKUP_BY_USERNAME - Look up by username [Optional]
• TWITTER_USER_LOOKUP_BY_ID - Look up by user ID [Optional]
• TWITTER_USER_LOOKUP_BY_IDS - Batch look up multiple users [Optional]

Key parameters:

• username: Twitter handle without @ prefix
• id: Numeric user ID string
• ids: Comma-separated user IDs for batch lookup
• user__fields: Fields to return (description, public_metrics, etc.)

Pitfalls:

• Usernames are case-insensitive but must not include the @ prefix
• User IDs are numeric strings, not integers
• Suspended or deleted accounts return errors, not empty results
• LOOKUP_BY_IDS accepts max 100 IDs per request

4. Manage Bookmarks

When to use: User wants to save, view, or remove bookmarked tweets

Tool sequence:

• TWITTER_USER_LOOKUP_ME - Get authenticated user ID [Prerequisite]
• TWITTER_BOOKMARKS_BY_USER - List bookmarked posts [Required]
• TWITTER_ADD_POST_TO_BOOKMARKS - Bookmark a post [Optional]
• TWITTER_REMOVE_A_BOOKMARKED_POST - Remove bookmark [Optional]

Key parameters:

• id: User ID (from USER_LOOKUP_ME) for listing bookmarks
• tweet_id: Tweet ID to bookmark or unbookmark
• max_results: Results per page
• pagination_token: Token for next page

Pitfalls:

• Bookmarks require the authenticated user's ID, not username
• Bookmarks are private; only the authenticated user can see their own
• Pagination uses pagination_token, not next_token

5. Manage Lists

When to use: User wants to view or manage Twitter lists

Tool sequence:

• TWITTER_USER_LOOKUP_ME - Get authenticated user ID [Prerequisite]
• TWITTER_GET_A_USER_S_OWNED_LISTS - List owned lists [Optional]
• TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS - List memberships [Optional]
• TWITTER_GET_A_USER_S_PINNED_LISTS - Get pinned lists [Optional]
• TWITTER_GET_USER_S_FOLLOWED_LISTS - Get followed lists [Optional]
• TWITTER_LIST_LOOKUP_BY_LIST_ID - Get list details [Optional]

Key parameters:

• id: User ID for listing owned/member/followed lists
• list_id: List ID for specific list lookup
• max_results: Results per page (1-100)

Pitfalls:

• List IDs and User IDs are numeric strings
• Lists endpoints require the user's numeric ID, not username

6. Interact with Posts

When to use: User wants to like, unlike, or view liked posts

Tool sequence:

• TWITTER_USER_LOOKUP_ME - Get authenticated user ID [Prerequisite]
• TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID - Get liked posts [Optional]
• TWITTER_UNLIKE_POST - Unlike a post [Optional]

Key parameters:

• id: User ID for listing liked posts
• tweet_id: Tweet ID to unlike

Pitfalls:

• Like/unlike endpoints require user ID from USER_LOOKUP_ME
• Liked posts pagination may be slow for users with many likes

Common Patterns

Search Query Syntax

Operators:

• from:username - Posts by user
• to:username - Replies to user
• @username - Mentions user
• #hashtag - Contains hashtag
• "exact phrase" - Exact match
• has:media - Contains media
• has:links - Contains links
• is:retweet / -is:retweet - Include/exclude retweets
• is:reply / -is:reply - Include/exclude replies
• lang:en - Language filter

Combinators:

• Space for AND
• OR for either condition
• - prefix for NOT
• Parentheses for grouping

Media Upload Flow

1. Upload media with TWITTER_UPLOAD_MEDIA (images) or TWITTER_UPLOAD_LARGE_MEDIA (video/GIF)
2. Get media_id from response
3. Pass media_id as string in media__media_ids array to TWITTER_CREATION_OF_A_POST

Known Pitfalls

Character Limits:

• Standard posts: 280 weighted characters
• Some Unicode characters count as more than 1
• URLs are shortened and count as fixed length (23 characters)

Rate Limits:

• Vary significantly by access tier (Free, Basic, Pro, Enterprise)
• Free tier: very limited (e.g., 1,500 posts/month)
• Check x-rate-limit-remaining header in responses

Idempotency:

• Post creation is NOT idempotent; duplicate posts will be created on retry
• Implement deduplication logic for automated posting

Quick Reference

| Task | Tool Slug | Key Params |

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

| Create post | TWITTER_CREATION_OF_A_POST | text |

| Delete post | TWITTER_POST_DELETE_BY_POST_ID | id |

| Look up post | TWITTER_POST_LOOKUP_BY_POST_ID | id |

| Recent search | TWITTER_RECENT_SEARCH | query |

| Archive search | TWITTER_FULL_ARCHIVE_SEARCH | query |

| Search counts | TWITTER_RECENT_SEARCH_COUNTS | query |

| My profile | TWITTER_USER_LOOKUP_ME | (none) |

| User by name | TWITTER_USER_LOOKUP_BY_USERNAME | username |

| User by ID | TWITTER_USER_LOOKUP_BY_ID | id |

| Users by IDs | TWITTER_USER_LOOKUP_BY_IDS | ids |

| Upload media | TWITTER_UPLOAD_MEDIA | media |

| Upload video | TWITTER_UPLOAD_LARGE_MEDIA | media |

| List bookmarks | TWITTER_BOOKMARKS_BY_USER | id |

| Add bookmark | TWITTER_ADD_POST_TO_BOOKMARKS | tweet_id |

| Remove bookmark | TWITTER_REMOVE_A_BOOKMARKED_POST | tweet_id |

| Unlike post | TWITTER_UNLIKE_POST | tweet_id |

| Liked posts | TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID | id |

| Owned lists | TWITTER_GET_A_USER_S_OWNED_LISTS | id |

| List memberships | TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS | id |

| Pinned lists | TWITTER_GET_A_USER_S_PINNED_LISTS | id |

| Followed lists | TWITTER_GET_USER_S_FOLLOWED_LISTS | id |

| List details | TWITTER_LIST_LOOKUP_BY_LIST_ID | list_id |

*Powered by Composio*