SuperAPI AI 工具集

twitter-automation

营销与增长

查看项目

更新于 10-15 13:34

技能介绍

Twitter/X Automation via Rube MCP 通过 Composio 的 Twitter 工具包经 Rube MCP 自动化 Twitter/X 操作。

【前置条件】 Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);需通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit twitter 建立有效的 Twitter 连接;每次操作前必须先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

【设置方式】 在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥。确认 RUBE_SEARCH_TOOLS 有响应以验证 Rube MCP 可用;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit twitter;若连接非 ACTIVE,按返回的授权链接完成 Twitter OAuth;确认连接状态为 ACTIVE 后再运行工作流。

【核心工作流】

  1. 创建和管理帖子:用于创建、删除或查找帖子。工具序列为 TWITTER_USER_LOOKUP_ME(前置获取认证用户信息)、TWITTER_UPLOAD_MEDIA 或 TWITTER_UPLOAD_LARGE_MEDIA(可选上传媒体)、TWITTER_CREATION_OF_A_POST(必需创建帖子)、TWITTER_POST_LOOKUP_BY_POST_ID(可选查找)、TWITTER_POST_DELETE_BY_POST_ID(可选删除)。关键参数包括 text(最多 280 加权字符)、media__media_ids、reply__in_reply_to_tweet_id、quote_tweet_id、id。注意帖子文本上限 280 加权字符,部分字符计为多个;发布非幂等,超时重试会产生重复帖子;媒体 ID 必须是数字字符串而非整数;UPLOAD_LARGE_MEDIA 用于视频/GIF,UPLOAD_MEDIA 用于图片;始终先调用 USER_LOOKUP_ME 获取认证用户 ID。

  2. 搜索帖子:用于查找符合特定条件的帖子。工具序列为 TWITTER_RECENT_SEARCH(近 7 天)、TWITTER_FULL_ARCHIVE_SEARCH(全档案,需学术权限)、TWITTER_RECENT_SEARCH_COUNTS。关键参数包括 query、max_results(10-100)、next_token、start_time/end_time(ISO 8601)、tweet__fields、expansions。注意 RECENT_SEARCH 仅覆盖近 7 天,更早帖子需 FULL_ARCHIVE_SEARCH,后者需 Academic Research 或 Enterprise 权限;支持 from:、to:、is:retweet、has:media、-is:retweet 等操作符;空结果返回 meta.result_count: 0 且无 data 字段;速率限制因端点和访问层级而异,需查看响应头。

  3. 查询用户:用于查找或查看 Twitter 用户资料。工具包括 TWITTER_USER_LOOKUP_ME、TWITTER_USER_LOOKUP_BY_USERNAME、TWITTER_USER_LOOKUP_BY_ID、TWITTER_USER_LOOKUP_BY_IDS(批量)。关键参数包括 username(不含 @)、id、ids(逗号分隔)、user__fields。注意用户名大小写不敏感但不能带 @;用户 ID 为数字字符串;被暂停或删除的账号返回错误而非空结果;LOOKUP_BY_IDS 每请求最多 100 个 ID。

  4. 管理书签:用于保存、查看或移除书签。工具序列为 TWITTER_USER_LOOKUP_ME(前置)、TWITTER_BOOKMARKS_BY_USER、TWITTER_ADD_POST_TO_BOOKMARKS、TWITTER_REMOVE_A_BOOKMARKED_POST。关键参数包括 id(用户 ID)、tweet_id、max_results、pagination_token。注意书签需认证用户的 ID 而非用户名;书签私有仅本人可见;分页使用 pagination_token 而非 next_token。

  5. 管理列表:用于查看或管理 Twitter 列表。工具包括 TWITTER_GET_A_USER_S_OWNED_LISTS、TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS、TWITTER_GET_A_USER_S_PINNED_LISTS、TWITTER_GET_USER_S_FOLLOWED_LISTS、TWITTER_LIST_LOOKUP_BY_LIST_ID。关键参数包括 id、list_id、max_results(1-100)。注意列表 ID 和用户 ID 均为数字字符串;列表端点需用户数字 ID 而非用户名。

  6. 与帖子互动:用于点赞、取消点赞或查看已点赞帖子。工具序列为 TWITTER_USER_LOOKUP_ME(前置)、TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID、TWITTER_UNLIKE_POST。关键参数包括 id、tweet_id。注意点赞/取消点赞端点需来自 USER_LOOKUP_ME 的用户 ID;点赞数多的用户分页可能较慢。

【搜索查询语法】 操作符包括 from:username、to:username、@username、#hashtag、"exact phrase"、has:media、has:links、is:retweet/-is:retweet、is:reply/-is:reply、lang:en。组合符:空格表示 AND,OR 表示任一条件,- 前缀表示 NOT,括号用于分组。

【媒体上传流程】

  1. 用 TWITTER_UPLOAD_MEDIA(图片)或 TWITTER_UPLOAD_LARGE_MEDIA(视频/GIF)上传媒体;2. 从响应获取 media_id;3. 将 media_id 作为字符串放入 media__media_ids 数组传给 TWITTER_CREATION_OF_A_POST。

【已知限制】 字符限制:标准帖子 280 加权字符,部分 Unicode 字符计为多于 1,URL 被缩短并计为固定长度(23 字符)。速率限制:因访问层级(Free、Basic、Pro、Enterprise)差异显著,Free 层级非常有限(如每月 1,500 条帖子),需检查响应中的 x-rate-limit-remaining 头。幂等性:帖子创建非幂等,重试会产生重复帖子,自动发布需实现去重逻辑。

【快速参考】 创建帖子 TWITTER_CREATION_OF_A_POST(text);删除帖子 TWITTER_POST_DELETE_BY_POST_ID(id);查找帖子 TWITTER_POST_LOOKUP_BY_POST_ID(id);近期搜索 TWITTER_RECENT_SEARCH(query);档案搜索 TWITTER_FULL_ARCHIVE_SEARCH(query);搜索计数 TWITTER_RECENT_SEARCH_COUNTS(query);我的资料 TWITTER_USER_LOOKUP_ME;按用户名查用户 TWITTER_USER_LOOKUP_BY_USERNAME(username);按 ID 查用户 TWITTER_USER_LOOKUP_BY_ID(id);批量查用户 TWITTER_USER_LOOKUP_BY_IDS(ids);上传媒体 TWITTER_UPLOAD_MEDIA(media);上传视频 TWITTER_UPLOAD_LARGE_MEDIA(media);列出书签 TWITTER_BOOKMARKS_BY_USER(id);添加书签 TWITTER_ADD_POST_TO_BOOKMARKS(tweet_id);移除书签 TWITTER_REMOVE_A_BOOKMARKED_POST(tweet_id);取消点赞 TWITTER_UNLIKE_POST(tweet_id);已点赞帖子 TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID(id);拥有的列表 TWITTER_GET_A_USER_S_OWNED_LISTS(id);列表成员 TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS(id);置顶列表 TWITTER_GET_A_USER_S_PINNED_LISTS(id);关注的列表 TWITTER_GET_USER_S_FOLLOWED_LISTS(id);列表详情 TWITTER_LIST_LOOKUP_BY_LIST_ID(list_id)。