Sorsa API MCP 服务器

把推特(X)实时数据变成 40 个原生工具,供 Claude、Cursor 和任意 MCP 客户端调用。一条命令装好,全程只读,无需推特开发者账号。

$npx -y sorsa-mcp

概览

它是什么

MCP(Model Context Protocol)是一套开放标准,让 AI 客户端以统一的方式调用外部工具。 Sorsa API MCP 服务器 就是其中推特(X)那一块:把 Sorsa API 的只读数据接口包起来,让任何兼容 MCP 的客户端都获得搜索推文、读取用户资料、粉丝、回复、提及、热搜等能力。你用自然语言提问,模型自己挑对应的工具去调用。设计上就是只读:不发帖、不登录、不做抓取。


工具

你的 AI 会拿到哪些工具

服务器暴露 40 个工具,每个接口各对应一个,只返回推特公开数据。模型会为每次请求挑出合适的那个。下表列出最常用的一批。

工具返回什么典型用途
search_tweets支持完整操作符集的高级推文搜索(from:、since:、lang:、min_faves:)。话题监测、搭建数据集
search_users匹配关键词或短语的账号。受众和线索发现
get_user_info按用户名或 ID 取完整资料:简介、粉丝数、认证状态。账号查询与信息补充
get_followers某账号的粉丝及其元数据,分页返回。受众与关系网分析
get_following某个用户关注的账号。兴趣图谱梳理
get_user_tweets某个用户时间线上的近期推文。动态追踪与摘要
get_tweet_info按链接或 ID 取某条推文的完整数据,含作者。get_tweet_info_bulk 一次可覆盖 100 条推文。为推文补齐指标
get_tweet_comments某条推文下面的回复串。对话分析
get_tweet_quotes某条推文的引用推文。传播与话语分析
get_retweeters转发过某条推文的账号。扩散与触达
search_mentions提及某账号的推文,可按点赞、回复和日期筛选。品牌与口碑监测
get_trends按 WOEID 取某个地区的热搜话题。趋势发现与时效内容
check_follow, check_retweet, check_quoted, check_comment, check_community_member核验某个用户是否关注、转发、评论、引用或加入了社区。活动与抽奖验证

此外还有列表、社区、Sorsa Score 和实用工具,一共 40 个。全部接口见 文档


配置

安装并连接

服务器通过 npx 在本地运行,不用克隆也不用编译。把对应客户端的配置加进去,填上 Sorsa 密钥,然后重启。

在终端里敲一条命令即可,不用往配置文件里粘任何东西。

claude mcp add --transport stdio --env SORSA_API_KEY=YOUR_API_KEY sorsa -- npx -y sorsa-mcp

所有客户端用的都是同一段标准配置,只要填上 Sorsa 密钥,加完之后重启客户端就行。


认证

获取 API 密钥

服务器用你自己的 Sorsa 密钥认证,密钥通过上面配置里的 SORSA_API_KEY 环境变量传入。登录、复制密钥、粘贴进去,然后重启客户端。前 100 次请求免费:无需绑卡,永不过期。

1

登录 Sorsa API 并打开控制台。

2

复制你的 API 密钥。

3

填进 SORSA_API_KEY,然后重启客户端。


实际用起来

一次请求长什么样

服务器接好之后,你不用再直接调接口。你用自然语言提问,客户端挑好工具、发出调用,再把结果读回来。

1

你在 Claude 或 Cursor 里用自然语言提问: "看看 @naval 的资料。"

2

客户端挑好工具并发起调用。

工具调用
{
  "name": "get_user_info",
  "arguments": { "username": "naval" }
}
3

服务器返回实时数据。

响应
{
  "username": "naval",
  "display_name": "Naval",
  "followers_count": 2600000,
  "followings_count": 800,
  "verified": true,
  "created_at": "2007-04-09T17:51:23Z"
}
4

客户端用自然语言、表格或者你要求的任何形式作答。你这边不用写胶水代码,也不用处理速率限制。

所有工具都是同一个套路。"美国现在有什么热搜" 会走 get_trends,"@sama 最近关于 AI 的推文" 会走 search_tweets,"@user 转发过这条吗" 会走 check_retweet。


为什么是 Sorsa API

为什么背后这套接口是 Sorsa API

服务器好不好用,取决于背后那套接口。

无需开发者账号

不用 X 审批,不用应用审核,只要一个密钥。

按请求固定计费

所有接口、所有套餐都是 1 次请求等于 1 次调用,智能体循环跑起来成本可预估。

所有套餐统一 20 次/秒

规模上来了,你的客户端也不会被限速。

只读且安全

工具可以读取推特公开数据,但绝不发帖、删除或关注。


常见问题

常见问题

这是一个 MCP 服务器,为 Claude、Cursor 和任意 MCP 客户端提供访问推特(X)实时数据的只读工具:搜索、用户资料、粉丝、推文、提及、热搜和验证。装一次,你的 AI 就会自己调用这些工具。

任何兼容 MCP 的客户端都可以:Claude Desktop、Claude Code、Cursor、装了 GitHub Copilot 的 VS Code、Windsurf 等等。每个客户端的配置都是同一段标准写法。

服务器在 GitHub 上开源,背后调用的是 Sorsa API,所以你带上自己的 Sorsa 密钥,只为工具实际发出的请求付费。前 100 次请求免费:无需绑卡,永不过期。

需要。服务器从 SORSA_API_KEY 环境变量读取密钥。在控制台里创建密钥只要几分钟。

不会。所有工具都是只读的。服务器读取推特公开数据,但从不发帖、回复、点赞、关注或发私信,这让自主运行的智能体保持安全。

官方推特接口需要开发者账号,把访问权限锁在昂贵的套餐后面,而且不是为 MCP 设计的。Sorsa API 不要开发者账号,按请求固定计费,并以原生 MCP 工具的形式交付。

不用。配置通过 npx 启动服务器,会自动拉取最新版本。你只需要设置密钥,然后重启客户端。

把 Sorsa API 的文档地址粘进你的大模型,就能替你写好集成代码。可以看 用 AI 开发

给你的 AI 客户端接上推特实时数据

装好服务器,填上密钥,下一条消息里 Claude 或 Cursor 就能搜推文、读资料、看粉丝和热搜。前 100 次请求免费:无需绑卡,永不过期。