Claude Code 读取 Twitter/X 数据：一行命令完成配置

#Claude Code 能自己读取 Twitter 吗？

不能。Claude Code 没有自带的 X 工具，它的 WebFetch 工具也打不开 x.com：2026 年 11 月 2 日，我们让 Claude Code 2.1.314 去获取一个 X 资料页、一条帖子和一个搜索页，每个请求都返回了“HTTP 402 Payment Required”，没有任何页面内容。

就算是未登录的浏览器，能在 X 上看到的也很少：资料页只显示简介和计数，搜索则会跳到登录页。所以 X 数据必须通过你添加的工具送到 Claude Code，适合的有两类：

• MCP 服务器通过模型上下文协议（MCP）（在新标签页打开），给 Claude Code 提供“搜索帖子”“获取资料”之类的工具。你用日常语言提问，Claude 选择工具并读取返回的 JSON，全程都在会话里完成。
• 技能给 Claude Code 的是写好的使用经验，而不是工具：一个描述 API 的 SKILL.md 文件，让 Claude 自己编写并运行请求，通常会留下一个你可以保存的脚本。

这两条路都得从某处拿到数据。官方 X API 托管的 MCP 服务器和大多数社区服务器，都跑在你自己的 X 开发者应用上，使用 OAuth 和预付额度，每条帖子 $0.005、每份资料 $0.010，每月最多读取 300 万条帖子（见 X 的价格页（在新标签页打开））。用你的 X 用户名或 Cookie 登录的服务器，虽然省了开发者应用，却把你的账号置于风险之中。数据 API 密钥则两者都不需要。我们的 AI 智能体用的 Twitter API指南对比了适用于任意智能体的这几条路线；本文则讲如何在 Claude Code 里配置它们。

#一行命令，把 X 数据接入 Claude Code

要在 Claude Code 里读取 X，通过 MCP 服务器使用 Sorsa API，一款 Twitter（X）API 与爬虫：终端里的一行命令，就让 Claude 拥有 40 个只读工具，共用一个密钥，不需要 X 开发者账号，推文每 1,000 条 $0.014 起，所有套餐都是 20 次请求/秒。

Sorsa API 把每次工具调用算作一次请求，而一次调用可以带回一整批 100 条帖子。Claude Code 通过 npx 启动服务器，所以需要安装 Node.js 18 或更高版本；node -v 会打印你的版本。

1. 拿到密钥。 注册 Sorsa API，在控制台的 API 密钥页面复制你的密钥。新账号自带 100 次不花钱的请求，不要求绑卡，也不会随时间过期。

2. 添加服务器。 把 YOUR_API_KEY 换成你复制的密钥，然后在终端里运行下面的命令，注意不要在 Claude Code 会话内运行。-s user 会让 X 工具在每个项目里都可用。

   claude mcp add sorsa -s user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

3. 检查连接。 claude mcp get sorsa 应该打印“Scope: User config”和“Connected”。在会话里，/mcp 会列出 sorsa 及其工具。

4. 问第一个问题。 试试“How many Sorsa API requests do I have left?”。Claude 会用 get_key_usage_info 来回答，这是对 GET /key-usage-info（在新标签页打开） 的免费查询，不消耗请求。回复里出现一个数字，就证明整条链路已经打通；密钥输错了，则会返回 401 “invalid api key”。

5. 交给它真正的任务。 粘贴下面三个提示词之一，看 Claude 如何挑选工具。

须知

命令里的顺序不要改：先是名称，然后是 -e，再是 --。如果像 claude mcp add --env SORSA_API_KEY=... sorsa 这样把密钥放在前面，Claude Code 会报错“Invalid environment variable format: sorsa”：这个参数接受一组键值对，会把名称当成又一对来吞掉。

双横线会把这一行剩下的部分交给 npx，所以加在最末尾的 -e 也会被交给 npx。这样服务器启动时环境是空的，没有密钥。

还要配置别的应用？Sorsa MCP 服务器页面列出了 Cursor、Codex 和 VS Code 对应的命令，而我们的 Twitter MCP 服务器指南则对比了各类 X 服务器，包括每次工具调用的成本。

#选择谁能用 X 工具：你自己、一个项目，还是你的团队

Claude Code 把每个 MCP 服务器放在三种作用域之一，作用域决定谁能用上 X 工具：你自己在某一个项目里、你自己在所有项目里，或者克隆这个仓库的所有人。

• Local（本地），不写 -s 时的默认值：服务器只在你添加它的那个项目里加载。Claude Code 把它存在 ~/.claude.json 里，归在该项目的路径下。
• User（用户），用 -s user：服务器在你电脑上的每个项目里加载，且只有你自己可见，同样存在 ~/.claude.json 里。
• Project（项目），用 -s project：Claude Code 把服务器写入仓库根目录的 .mcp.json，克隆仓库的人都会得到它。

选好作用域，复制命令：

claude mcp add sorsa -s user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp

claude mcp add sorsa -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp

claude mcp add-json sorsa -s project '{"type":"stdio","command":"npx","args":["-y","sorsa-mcp"],"env":{"SORSA_API_KEY":"${SORSA_API_KEY}"}}'

对团队来说，提交这个文件，但别把密钥放进去。Claude Code 会展开 .mcp.json 里的 ${VAR} 引用，所以文件里只写变量名，每个人把自己的密钥放在自己的 shell 里：

{
  "mcpServers": {
    "sorsa": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "sorsa-mcp"],
      "env": { "SORSA_API_KEY": "${SORSA_API_KEY}" }
    }
  }
}

这个文件是我们 11 月 2 日用 claude mcp add-json 写出来的。在队友批准之前，claude mcp list 会把这个服务器显示为“Pending approval (run claude to approve)”，他们第一次启动交互会话时会问一次。如果这个变量没有设置，列表会警告“Missing environment variables: SORSA_API_KEY”，所以缺少密钥不会悄无声息地失败。想对已批准或已拒绝的服务器重新询问，运行 claude mcp reset-project-choices。Anthropic 的 Claude Code MCP 指南（在新标签页打开）记录了每一种作用域。

#让 Claude Code 写代码时，再加上智能体技能

当任务应该以一段脱离 Claude 也能运行的代码收尾时，就安装 Sorsa API 的智能体技能：导出脚本、夜间任务、数据管道。MCP 服务器负责在会话里回答问题；技能则把 API 的使用规则交给 Claude Code（每项任务该用哪个接口、通过 next_cursor 翻页、最多 100 个 ID 一批），这样它写出的代码从一开始就遵循这些规则。

npx skills add Sorsa-io/sorsa-x-api-skill -g -a claude-code -y

这条命令会把 sorsa-x-api 技能复制到 ~/.claude/skills/，每个 Claude Code 会话都能在那里找到它；我们在 11 月 2 日运行过。在任务匹配之前，Claude Code 只读取技能的简短描述，匹配后才打开完整的 SKILL.md，正如 Anthropic 的技能文档（在新标签页打开）所述。技能的代码从 SORSA_API_KEY 读取你的密钥，所以把它放进 ~/.claude/settings.json 的 env 块里，Claude Code 会把它应用到每个会话以及它运行的命令上：

{
  "env": { "SORSA_API_KEY": "YOUR_API_KEY" }
}

然后要结果时，要一个文件，而不是一段回答。“Write a Python script that saves every post mentioning our product from the last 30 days to mentions.csv”会让 Claude Code 在 POST /search-tweets（在新标签页打开） 上写一个循环，沿着 next_cursor 一直读到底，运行它，并把脚本留着，下个月接着用。

两条路线把工作分得很清楚：

• 在会话里得到一个答案

  用

  MCP 服务器

  原因

  Claude 自己调用工具并读取结果

• 一个文件，或一个留着用的脚本

  用

  智能体技能

  原因

  代码脱离 Claude 也能运行，批量数据也不会塞进对话里

• 两者都要

  用

  两者都用，共用一个密钥

  原因

  无论哪种，每次调用都只算一次请求

大多数人先从 MCP 服务器开始，等第一次想要文件而不是答案时，再加上技能。

#三个现成的提示词，以及一次运行要花多少钱

下面每个提示词都写明了任务、规模和输出，这样 Claude Code 就会按已知的次数调用已知的工具。换成你的主题或用户名，粘贴到会话里即可。

研究本周的一个话题

Search X for posts about [your topic] from the last 7 days with
at least 20 likes. Read the top 100, group them into 3 to 5
themes, and give me a brief with the best 2 posts per theme,
linked.

Claude 会运行五次 search_tweets，沿着 next_cursor 翻页，每次约 20 条帖子。这 100 条帖子在 Sorsa API 上 $0.007 起，按官方 X API 每条帖子 $0.005 的费率则是 $0.50。

汇总你关注的账号

For each of these accounts, read their posts from the last 7
days: [paste up to 10 handles]. Summarize what each one
announced or argued, flag anything about pricing or launches,
and end with a 5-line overview.

Claude 对每个账号调用一次 get_user_tweets，也就是运行 POST /user-tweets（在新标签页打开），每次取 20 条帖子。约 200 条帖子，Sorsa API 上 $0.014 起，按官方 X API 的费率则是 $1.00。

审查一份账号名单

Here are up to 100 X handles: [paste]. Get all the profiles in
one batch, then make a table with followers, following, posts,
join date and bio, sorted by followers. Flag accounts younger
than one year and save the table as accounts.csv.

Claude 调用 get_user_info_batch，它运行 GET /info-batch（在新标签页打开），一次返回全部 100 份资料，在 Sorsa API 上 $0.0014 起。官方 X API 每份资料 $0.010，这份名单就是 $1.00。

2026 年 11 月 22 日起，官方 X API 这一边的费用还会增加：X 会开始对随帖子一起返回的作者按每个用户 $0.010 计费（见 X 的通知（在新标签页打开））。那时，一次返回 20 条帖子、来自 20 个不同作者的搜索，成本会从 $0.10 变成 $0.30。而在 Sorsa API 上，每条帖子都在同一次请求里带着作者的完整资料。

三个提示词加在一起共用 16 次请求，所以 100 次免费请求可以运行它们六遍，然后你再选套餐。如果每天都运行研究类提示词，或者把它指向一个热门话题，Claude 每多读一条帖子，差距就拉大一点：

#别让 X 的结果撑爆 Claude 的上下文

X 的结果是很长的 JSON，所以要让 Claude Code 只取你需要的帖子，批量任务则交给脚本。当一个 MCP 工具的结果超过 1 万个 token 时，Claude Code 会发出警告，默认在 2.5 万处截断。

• 指定一个数量。 “点赞最多的 50 条帖子”能让每次调用保持很小；“关于 X 的一切”则会让 Claude 不停翻页，把上下文塞满原始帖子。
• 了解每条帖子带了什么。 每条帖子都附带作者的完整资料，这有助于 Claude 判断来源，但也会占空间。让 Claude 在保存结果时只保留它需要的字段。
• 为单个会话调高上限：当某一个大结果比上下文的空间更重要时，用 MAX_MCP_OUTPUT_TOKENS=50000 claude 启动。
• 把成千上万行交给技能。 一份粉丝列表或一个月的提及，应该交给写出 CSV 的脚本；只有 Claude 对这个文件的摘要会进入对话。

工具本身占用的空间很小。Sorsa API 的服务器用约 2.3 万个字符描述它的 40 个工具，接近 5,800 个 token；而开启工具搜索（默认开启）时，Claude Code 在任务需要之前只看得到工具名称。

#让 Claude Code 不用询问就能执行 X 任务

因为 Sorsa API 的每个工具都只读，所以你可以让 Claude Code 每次调用它们时不必再弹出提示：一个糊涂或陷入循环的会话，最多也就是消耗请求。在项目的 .claude/settings.json 里加一条允许规则，或者加到 ~/.claude/settings.json 里，对所有项目生效：

{
  "permissions": { "allow": ["mcp__sorsa__*"] }
}

Claude Code 只接受紧跟在服务器名称之后的通配符，所以 mcp__sorsa__* 只会批准 Sorsa API 的工具，别的都不会（见权限规则（在新标签页打开））。

同一条规则还能支持无人值守的运行。Claude Code 的无头模式（在新标签页打开），claude -p，运行一个提示词就退出，所以定时任务或 CI 计划可以写出每天的 X 摘要：

claude -p "Search X for posts about [your topic] from the last 24 hours
and write a 10-line digest to digest.md" \
  --allowedTools "mcp__sorsa__*,Write"

11 月 2 日，我们用一个编造的密钥运行了一次这样的无头调用：Sorsa API 工具没有弹出任何批准提示就运行了，Sorsa API 返回了 401 “invalid api key”，这说明从 Claude Code 到 API 的整条链路是通的。花费也有上限：一个密钥最高不超过 20 次请求/秒，而按量付费的额外请求，会在你为计费周期设定的额度处停止，除非你调高，否则是 $100。

须知

把帖子里的内容当作要读的材料，绝不要当作命令。X 上有些帖子就是专门写来诱导 AI 智能体的；而在只读的 X 工具下，这样的帖子最多也就是多花一次请求。在无头运行中，只允许任务需要的工具，并且不要把 Bash 放进 --allowedTools。

#今天就把 Claude Code 接上 X

Claude Code 获取不了 x.com，但一行命令就能给它 X 数据：会话里提问用 Sorsa API 的 MCP 服务器，留着用的脚本用它的智能体技能，两者共用一个只读密钥。推文每 1,000 条 $0.014 起，而官方 X API 收 $5.00，整个过程从不涉及 X 登录或开发者应用。先用那 100 次免费请求开始，足够把上面三个提示词运行六轮，更多提示词请看用 AI 构建。

#常见问题