X (Twitter) MCP by InsightfulPipe

Insightful Pipe 提供的 X（Twitter）MCP 服务

将你的 X（前身为 Twitter）账户连接到 AI 助手，以发布帖子、回复和串帖，阅读时间线和提及内容、搜索帖子、发送私信并查看帖子分析数据。

这是 Insightful Pipe MCP 服务集合的一部分。X Organic MCP 服务可为 Claude、ChatGPT、Cursor 和其他 AI 助手提供对你的 X 账户执行 92 项操作的能力（59 项读取、23 项写入和 10 项破坏性操作）。该服务托管运行，无需安装，并通过你自己的 X 开发者应用运行：X 会按照按次付费费率，将每次 API 调用计入你的开发者账户。

对于付费推广活动，请改用 X Ads MCP 服务。它通过 X 登录进行连接，无需开发者应用。

MCP 服务 URL

https://x-organic.insightfulmcp.com/

什么是 X Organic MCP 服务？

一个将 X 账户连接到 AI 助手的远程模型上下文协议服务。你的助手可以：

• 发布带图片、GIF 或视频的帖子、回复和串帖，并添加替代文本和字幕
• 阅读你的主页时间线、任何账户的帖子及提及内容、回复、转帖和引用帖子
• 搜索最近 7 天的帖子；如果你的 X 套餐支持，也可以搜索完整存档，并统计匹配结果
• 一次读取最多 100 条帖子的互动分析数据，以及视频播放分析数据
• 阅读和发送私信
• 管理列表、屏蔽和拉黑，并起草和发布文章
• 查看你的 X 应用用量和剩余 API 额度

连接前：创建你自己的 X 开发者应用

X Organic 使用你的 X 开发者应用，因此每次调用的费用由 X 计入你的账户。

1. 登录 X Developer Console，创建一个 Project 和一个应用。
2. 在 Billing → Credits 中添加额度。
3. 在应用设置中，将 App permissions 设为 Read and write and Direct message，并添加 InsightfulPipe 中显示的 Callback URI。
4. 在 Keys & Tokens 下生成 Access Token 和 Access Token Secret。
5. 在 InsightfulPipe 中添加 X Organic 集成，选择 Read-only 或 Read & write，然后粘贴 Consumer Key、Secret Key、Access Token 和 Access Token Secret。此操作将连接拥有该应用的 X 账户。

安装

Claude

1. 复制 MCP 服务 URL：https://x-organic.insightfulmcp.com/
2. 打开 Claude connector settings（Customize > Connectors），点击 +，然后点击 Add custom connector
3. 粘贴 URL 并点击 Add
4. 点击 Connect；如果出现提示，请登录 InsightfulPipe。随后，Claude 会将此连接器列为已连接。

ChatGPT

通过 ChatGPT 的开发者模式添加自定义 MCP 服务。是否可用取决于你的 ChatGPT 套餐，工作区管理员可能需要先启用该功能。

1. 在 ChatGPT 设置中开启开发者模式
2. 为远程 MCP 服务创建一个新应用并粘贴 URL：https://x-organic.insightfulmcp.com/
3. 如果出现提示，请登录 InsightfulPipe。登录后即完成连接。

参阅 OpenAI 指南：ChatGPT 中的开发者模式和 MCP 应用

Claude Code

claude mcp add --transport http x-organic https://x-organic.insightfulmcp.com/

Cursor

将服务添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "x-organic": {
      "url": "https://x-organic.insightfulmcp.com/"
    }
  }
}

当 Cursor 显示 Needs authentication 时，点击 Connect；如果出现提示，请登录 InsightfulPipe。

可用操作

92 个操作：59 个读取操作、23 个写入操作和 10 个破坏性操作。

读取操作（59 个）

显示全部 59 个读取操作

操作	描述
get_api_usage	按天统计此 X 应用已使用的帖子读取量
get_blocked_users	已连接账号屏蔽的账号
get_bookmark_folder_posts	一个书签文件夹中保存的帖子
get_bookmark_folders	已连接账号的书签文件夹
get_bookmarks	已连接账号收藏的帖子
get_community	查找一个社区
get_credit_balance	X 开发者账号剩余的 API 额度（美元）
get_dm_conversation_events	一个对话中的消息事件
get_dm_event	一条私信事件
get_dm_events	已连接账号各个对话中的近期私信事件
get_dm_events_with_user	与某用户一对一对话中的消息事件
get_followed_lists	用户关注的列表
get_followers	用户的关注者
get_following	用户关注的账号
get_home_timeline	已连接账号的主页时间线，按最新排序
get_liked_posts	用户点过赞的帖子
get_liking_users	列出给某条帖子点赞的用户
get_list	查找一个列表
get_list_followers	关注某个列表的账号
get_list_members	某个列表的成员
get_list_memberships	用户所属的列表
get_list_posts	列表成员发布的近期帖子
get_me	已连接的 X 账号，包括其订阅等级
get_media	按媒体密钥查找一项媒体
get_media_analytics	某个时间范围内最多 100 项媒体的播放分析数据
get_media_by_keys	按媒体密钥查找最多 100 项媒体
get_media_upload_status	已上传视频的处理状态
get_muted_users	已连接账号隐藏的账号
get_news_story	阅读一条新闻报道
get_owned_lists	用户拥有的列表
get_personalized_trends	为已连接账号个性化推荐的趋势
get_pinned_lists	已连接账号置顶的列表
get_post	按 ID 阅读一条帖子
get_post_analytics	某个时间范围内最多 100 条帖子的互动分析数据
get_post_counts_all	在 X 套餐允许的范围内，统计完整归档中符合查询条件的帖子数量
get_post_counts_recent	统计过去 7 天内符合查询条件的帖子数量
get_posts	按 ID 阅读最多 100 条帖子
get_quote_posts	列出引用某条帖子的帖子
get_reposted_by	列出转发某条帖子的用户
get_reposts	列出某条帖子的转发记录
get_reposts_of_me	转发已连接账号帖子的记录
get_space	查找一个 Space
get_space_posts	在 Space 中分享的帖子
get_spaces	按 ID 查找最多 100 个 Space
get_spaces_by_creators	最多 100 位用户主持的直播或已安排的 Space
get_trends_by_location	按 Yahoo WOEID 查询某个地点的趋势话题（1 表示全球）
get_user	按 ID 查找一个用户
get_user_affiliates	与经过验证的组织有关联的账号
get_user_by_username	按用户名查找一个用户
get_user_mentions	列出提及某个用户的帖子，按最新排序
get_user_posts	列出用户发布的帖子，按最新排序
get_users	按 ID 查找最多 100 位用户
get_users_by_usernames	按用户名查找最多 100 位用户
search_all_posts	在 X 套餐允许的范围内，搜索完整帖子归档
search_communities	按关键词搜索社区
search_news	搜索 X 的新闻报道
search_recent_posts	搜索过去 7 天内的帖子
search_spaces	按标题搜索 Space
search_users	按关键词搜索用户

### 写入操作（23）

显示全部 23 项写入操作

操作	描述
add_list_member	将用户添加到列表
add_media_subtitles	将已上传的字幕文件附加到已上传的视频
block_user	屏蔽用户
create_article_draft	创建长篇 Article 草稿。发布前不会公开任何内容，需调用 publish_article
create_dm_group	发送第一条消息，开始群组对话
create_list	创建由已连接账户拥有的列表
create_post	在已连接的 X 账户上发布帖子、回复或串文
dm_block_user	阻止用户向你发送私信
dm_unblock_user	允许用户再次向你发送私信
edit_post	编辑近期帖子。X 仅允许符合条件的账户在编辑期限内编辑帖子
follow_list	关注列表
hide_reply	隐藏对已连接账户参与的对话的回复
mute_user	静音用户
pin_list	固定列表
publish_article	公开发布 Article 草稿
repost_post	转发来自已连接账户的帖子
send_dm	向一位用户发送私信
send_dm_to_conversation	向现有对话发送私信
set_media_alt_text	发布前为已上传的媒体添加替代文本
unhide_reply	显示已隐藏的回复
update_list	重命名列表、更改其描述，或将其设为私密或公开
upload_media	上传一张图片、一个 GIF 或一个字幕文件，并返回其媒体 ID
upload_video	分段上传视频，并返回其媒体 ID

破坏性操作（10 项，默认关闭）

显示全部 10 项破坏性操作

操作	描述
delete_dm_event	删除已连接账户发送的消息
delete_list	删除由已连接账户拥有的列表
delete_media_subtitles	从已上传的视频中移除一种字幕语言
delete_post	删除已连接账户发布的帖子
remove_list_member	从列表中移除用户
unblock_user	取消屏蔽用户
undo_repost	撤销已连接账户进行的转发
unfollow_list	取消关注列表
unmute_user	取消静音用户
unpin_list	取消固定列表

控制 AI 的操作权限

• 为每个已连接账户单独开启或关闭操作，让 Agent 只能看到你允许的操作。
• 以只读或读写模式连接。 只读连接只能启用读取操作。
• 破坏性操作默认关闭。 删除帖子和消息、撤销转发及其他破坏性操作均处于禁用状态，直到管理员启用。
• 帖子和消息会立即发布。 发布内容和发送私信属于常规写入操作，因此对于不应发布内容的账户，请关闭这些操作。
• 不会产生意外开销。 结果每次返回 10 条，不会自动翻页；每项写入操作只会发送一次，绝不会自动重试。

使用示例

"Which of my posts from the last 30 days got the most engagement?"

"Show this week's mentions and draft replies for me to approve"

"Publish this thread of four posts with the image attached to the first one"

"How many posts mentioned our launch in the last 7 days?"

"How much API credit is left on my X app?"

不支持的操作

• 无法点赞帖子、关注用户或创建引用帖子，因为 X 已从自助式 API 计划中移除了这些功能。读取点赞、关注者和引用帖子仍然可用。
• 书签仅支持读取。
• 全档案搜索和档案计数取决于你的 X 计划。
• 付费推广由 X Ads MCP 服务提供支持。

定价

X Organic MCP 服务包含在所有 InsightfulPipe 计划中，并与其他所有 MCP 服务及 CLI 一同提供。计划价格从每月 $29.99 起。X API 调用费用由你自己的开发者账户承担。当前计划请参阅 insightfulpipe.com/pricing。

探索 Insightful Pipe 的更多 MCP 服务

访问 insightfulpipe.com/mcp-servers，查看营销和分析类 MCP 服务的完整集合。

社交媒体 MCP 服务

• X Ads MCP：X（Twitter）广告
• Instagram MCP：Instagram 帖子、Reels 和评论
• LinkedIn Pages MCP：公司主页分析数据和帖子
• Facebook Pages MCP：主页洞察数据和帖子

查看所有 MCP 服务 →

支持

• 服务页面：insightfulpipe.com/mcp-servers/x-organic
• 文档：insightfulpipe.com/docs
• 电子邮件：[email protected]

---

Insightful Pipe：通过 MCP 服务提供 AI 驱动的营销分析。探索所有集成 →

许可证

MIT 许可证 - 详情请参阅 LICENSE。