面向 AI 智能体和编码工具的 Twitter/X API（2026）

Q: AI 智能体能不用开发者账号访问 Twitter/X 数据吗？

能。Sorsa 这类托管 Twitter/X 数据 API 只需要 ApiKey 请求头里的一个 API 密钥，不需要 X 开发者账号、OAuth 流程或应用审核。智能体用一个密钥认证，就能为用户资料、推文、搜索和粉丝调用只读接口。注册即送 100 次免费请求，无需绑卡，所以一个智能体注册后几分钟内就能拉取实时数据。

作者：Sorsa 编辑部

更新于 2026 年 7 月 11 日：加入官方 X 托管 MCP 服务器（2026 年 6 月 30 日上线），并对照 2026 年 4 月 20 日的变化刷新 X API 按量付费读取费率。

核心要点： AI 智能体和编码工具有三种方式获取公开 X/Twitter 数据：一个向聊天客户端暴露只读工具的 MCP 服务器、一个教编码工具认识接口的 Agent 技能，以及一个从生成代码里调用的 REST API。只读访问让自主智能体远离用户账号，而按请求计费避免了按资源的成本。

多数关于“面向 AI 智能体的 Twitter API”的指南，都默认智能体要发帖：看信息流、拟一条回复、发布。那是一类场景，归官方 X API。更大、增长更快的一类是读取：一个搜索对话、拉取一份用户资料、检查谁关注谁，或为模型采集推文去总结的智能体。读取正是托管的只读数据层胜过“把自主智能体接进一个有写权限账号”的地方。

这正是 Sorsa API 为 AI 构建者填补的缺口，一个为读密集型访问打造的 Twitter/X API 替代方案，暴露 40 个只读接口，覆盖用户资料、推文、搜索、粉丝、列表、社区和验证接口，用 ApiKey 请求头里的单个 API 密钥（无 OAuth、无应用审核）、每 1,000 条推文 $0.02 起的按请求计费，以及所有套餐统一 20 次/秒。注册即送 100 次免费请求：无需绑卡，覆盖全部 40 个接口，足够在付费之前把一个智能体接到真实数据。

本指南覆盖四件事：三条连接路径、只读如何改变智能体的安全考量、这些部件如何对应到实际工具，以及智能体规模上的数据成本。相关工具涵盖 Claude Desktop、Cursor、Claude Code、Codex、Windsurf 和各类 vibe-coding 构建器。

为什么 AI 智能体和编码工具需要 Twitter/X API {#why}

AI 智能体和编码工具需要 Twitter/X API，因为语言模型自己没有对平台的实时访问：训练数据是冻结的，而 X 封禁未认证的抓取。API 把“人们在怎么谈这件事”变成一个模型能发出的结构化调用，拿回干净的 JSON、在上面推理，而不必让模型编答案。

这个需求并不小众。在 Stack Overflow 覆盖超过 4.9 万名开发者的 2025 年开发者调查里，84% 的受访者正在或计划在其开发流程中使用 AI 工具，高于 2024 年的 76%，而 51% 的专业开发者每天使用 AI 工具。这些工具越来越多地伸向自身上下文之外去取真实数据，而公开的社交对话是最被需要的来源之一。

实践中会出现两类读取方。第一类是运行时的智能体：一个监测智能体、一个研究助手、一个需要查公开账号的客服机器人。第二类是构建时的编码工具本身，Cursor 或 Claude Code 在这里编写集成代码，需要知道接口、认证和响应结构才能把调用写对。下面三条路径两者都服务。

把 Twitter/X 数据连到 AI 工具的三种方式 {#three-ways}

给 AI 工具接入 Twitter/X 数据有三种方式：给聊天客户端的 MCP 服务器、给编码工具的 Agent 技能，以及从生成代码里直接调用的 REST API。三者不是竞争关系，而是适合不同的工具，同一个 API 密钥在三者上都能用。

选项 1：给聊天客户端的 MCP 服务器

MCP 服务器是聊天式客户端最快的路径。模型上下文协议（Model Context Protocol）是 Anthropic 在 2024 年底引入的开放标准，让 AI 应用以统一的方式调用外部工具。一个 MCP 服务器暴露一组工具；客户端说这个协议；模型为每个请求挑对的工具。Sorsa MCP 服务器封装了这些只读接口，所以任何兼容 MCP 的客户端都能拿到搜索推文、读取用户资料、粉丝、回复、提及和热搜趋势的原生工具。

服务器通过 npx 本地运行，不用克隆或构建任何东西。把它指向你的密钥、重启客户端：

json

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

同一段配置在 Claude Desktop、Cursor、带 GitHub Copilot 的 VS Code、Windsurf，以及任何其他 MCP 客户端里都能用。服务器为每个接口暴露一个工具（共 40 个），全部只读。MCP 服务器源码在 GitHub 上，MIT 许可。逐客户端的完整详解见专门的 Twitter MCP 服务器指南；本节是简版。

选项 2：给编码工具的 Agent 技能

对于构建并运行工作流的编码智能体，Agent 技能比聊天工具更合适。开放的 SKILL.md 格式里的技能，是一个智能体读取以学会某项能力的指令文件夹：如何认证、哪个接口对应哪个目标，以及如何分页和批量。和模型在聊天时调用的 MCP 服务器不同，技能教编码智能体自己编写正确的 API 代码、再在一个真实项目里跑起来。

面向 Sorsa API 的开放 SKILL.md 技能与任何读取该格式的智能体配合：Claude Code、Cursor、Codex CLI 等。手动安装就是复制到智能体的技能目录：

bash

git clone https://github.com/Sorsa-io/sorsa-x-api-skill ~/.claude/skills/sorsa-x-api
export SORSA_API_KEY=your_key

之后，一句“取 @elonmusk 最近的 100 个粉丝”或“在 X 上搜索本周提及 Solana 的热门帖子”的提示就够了。技能告诉智能体用 ApiKey 请求头认证、选接口（粉丝用 /followers、搜索用 /search-tweets）、并翻页遍历结果。技能附带可运行的 Python 和 curl 示例，外加一个处理重试和分页的小客户端，所以智能体复用请求管道，不必重写。

技能路线是多数竞品页面跳过的一条，也是智能体工作流读取侧的天然契合：智能体自己决定何时需要 X 数据，并自己取回来。

选项 3：面向 vibe coding 的 REST API 和 AI 可读文档

当你自己构建应用、让 AI 编写集成时，直接调用 REST API。vibe coding（氛围编程），也就是用大白话描述来构建软件，是柯林斯词典的 2025 年度词汇，而 Cursor、Bolt、Lovable、Replit 这类工具如今能从提示直接产出可用应用。这个流程里任何外部 API 的瓶颈，是模型是否足够了解该 API 以写出正确的调用。

这正是 AI 可读文档要解决的。在给人看的文档之外，Sorsa 发布了一份 AI 可读版文档：一份智能体可以拉进上下文、不必和 HTML 或渲染搏斗就能解析的纯文本参考。粘贴或链接进 Cursor 或 Claude Code，就给了模型接口列表、参数和响应字段，所以生成的请求第一次就匹配真实的 API。

API 本身保持简单，让生成的代码短。一次用户资料查询是一个已认证的 GET：

python

import os, requests

r = requests.get(
    "https://api.sorsa.io/v3/info",
    headers={"ApiKey": os.environ["SORSA_API_KEY"]},
    params={"username": "elonmusk"},
)
r.raise_for_status()
print(r.json()["followers_count"])

搜索是一个带 JSON 请求体的 POST，通过推文搜索接口接受 Twitter 高级搜索操作符：

bash

curl -X POST "https://api.sorsa.io/v3/search-tweets" \
  -H "ApiKey: $SORSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "from:elonmusk min_faves:1000", "order": "popular"}'

再往后，粉丝接口每次调用返回最多 200 份用户资料，批量接口每次请求接收最多 100 条推文或资料，同一个密钥覆盖一切。更全面的入门见用 AI 构建指南和 API 快速上手，两份文档端到端走一遍配置。

只读还是写权限：自主智能体需要什么 {#read-only}

对多数 AI 用例来说，智能体需要读取公开 X 数据，而不是向账号写入，只读访问因此消除了实实在在的一类风险。只能读的智能体，不管一条抓取回复里的提示注入叫它做什么，都发不了帖、删不了、关不了注、发不了私信。当智能体自主运行时，这是一道有意义的护栏。

信任数据支持这份谨慎。同一份 Stack Overflow 2025 调查发现，使用和信心之间有一道明显落差。只有 29% 的 2025 年受访者说他们信任 AI，比 2024 年下降了 11 个百分点；排第一的挫败感，三分之二的开发者都提到，是“几乎正确、却差那么一点”的 AI 输出。当智能体只能读取时，一个“几乎正确”的动作只会返回你能抓到的错误数据，不会变成发在实时账号上、撤不回的错误帖子。

这也是诚实的取舍。如果你的智能体任务是发布、点赞或发私信，官方 X API 是对用户账号做写操作的合规路径，没有只读服务商能替代。有些第三方 API 确实出售写操作，那是另一种取舍，因为那把自动化的写入放在真实账号上。Sorsa 从产品设计上就是只读，API 调用完全不涉及用户账号。对一个读密集型智能体，所有套餐统一 20 次/秒和按请求计费，比智能体永远不会调用的写入接口更要紧。只读的单密钥认证，配置就是请求头里一个密钥，而不是每个用户走一遍 OAuth 流程。

官方 X API 及其托管 MCP 服务器 {#official-x}

官方 X API 是第一方来源，2026 年年中还加上了自己的 MCP 层。据 X 的开发者公告，平台在 2026 年 6 月 30 日推出了一个托管 MCP 服务器。它让 Grok、Cursor、Claude 或任何 MCP 客户端通过开发者自己的凭据读写 X，另有一个面向开发者文档的 MCP 服务器。这个服务是第一方的、OAuth 作用域的，把每次调用都路由通过该账号的 X API 套餐。

立刻浮现的坑是成本。托管 MCP 不改变定价，而是建在按量付费模型上，所以每次工具调用都按抓取的资源计费。观察者也把按调用的账单列为第一天最大的意外。对一个发出许多读取的智能体，这会以固定套餐不会的方式越滚越多。

对只读智能体，真正要紧的差异是配置和成本：官方 API 需要一个 OAuth 应用、按资源计费；按请求计费的只读套餐只要一个密钥。

维度	官方 X API	Sorsa API
为智能体配置	OAuth 2.0 应用、审核、每用户令牌刷新	`ApiKey` 请求头里单个 API 密钥
MCP 选项	第一方托管 MCP（2026 年 6 月 30 日），OAuth 作用域，读写	只读 MCP 服务器，通过 `npx` 本地运行，无 OAuth
访问模型	按抓取的资源付费	按请求：1 次调用 = 1 次请求
读取成本	每条帖子 $0.005、每份资料 $0.010	每 1,000 条推文 $0.02、每 1,000 份资料 $0.01 起
写操作	发帖、私信、草稿（合规路径）	无（设计上只读）
免费起步	无免费额度；先买额度	100 次免费请求，无需绑卡

一次 Sorsa 请求返回最多 100 条推文或 200 份用户资料，所以每千条的数字用的是那个批量基准。官方 X API 读取费率按 2026 年 4 月 20 日定价。

Twitter/X 数据对一个 AI 智能体要花多少钱 {#cost}

对一个读密集型 AI 智能体，按请求计费的套餐远比按资源计费便宜，因为智能体做许多小读取、并复用同一份数据。官方 X API 按抓取的资源计费：帖子读取每条 $0.005，用户读取每次 $0.010，所以一条连同作者资料返回的推文花 $0.015，即约每 1,000 条 $15。搜索结果里内嵌的作者数据，按单独的用户读取计费。

按请求计费把这个反转过来。在 Sorsa 上，无论一次调用返回多少条目，1 次 API 调用都从月度额度里扣 1 次请求，而每个推文响应里的作者资料免费。套餐为 $49/月含 1 万次请求（Starter）、$199/月含 10 万次（Pro）、$899/月含 50 万次（Enterprise），全都统一 20 次/秒。在读密集型负载上，一旦量越过每月约 1 万次帖子读取，就折算为最多可比官方 API 便宜 50 倍。

这个“每条推文”的数字要分两种情况看。通过 /tweet-info-bulk 的一次批量 ID 查询每请求返回 100 条推文，Pro 上落到每 1,000 条推文 $0.02 的基准。通过 /search-tweets 的一次交互式搜索每请求返回约 20 条推文，所以同一套餐上折算得更接近每 1,000 条 $0.10，因为每次调用返回的条目更少。两者都远低于按资源模型的每 1,000 条 $15，而且都不背官方 API 每月 200 万次帖子读取的上限。用批量调用削减请求数，见优化 API 用量；完整的官方定价见 2026 年 X API 价格详解。

哪条路径适合哪个工具 {#which-path}

正确的路径取决于工具和任务，不是哪个最新。一份简短的决策清单：

Claude Desktop、Cursor 或作为聊天客户端的 VS Code： 用 MCP 服务器，一段配置、无需胶水代码就接入只读工具。

Claude Code、Codex 或构建工作流的 Cursor： 用 Agent 技能，它教编码智能体去写代码调用的接口、认证和分页。

定制或 vibe-coded 的应用： 从生成代码里调用 REST API，配上 AI 可读文档，让模型写出正确的请求。

发帖、点赞或发私信的智能体： 用官方 X API，对用户账号做写操作的合规路径。

高量、读密集型的数据采集： 用 Sorsa 的固定套餐，1 次调用就是 1 次请求，作者资料在推文响应里免费附带。

很多搭建会混用路径：原型阶段用 MCP 服务器探索，交付的应用里用 REST API。为训练或微调模型而采集推文是另一条工作流，见构建用于机器学习的 Twitter 数据集。

一个小团队如何把智能体接到实时 X 数据 {#case}

一个约五人的小型社交分析团队，在官方 X API 上跑一个提及追踪智能体，眼看按资源的账单随着覆盖更多品牌而攀升。每个被追踪的提及都意味着一次帖子读取加一次作者的用户读取，而 OAuth 令牌刷新代码还得为每个环境单独维护。

把读取负载迁到固定套餐、并通过 MCP 服务器接入智能体之后，他们的 Twitter 数据花费削减了 90% 以上，还删掉了每环境的令牌处理，换成环境变量里的一个密钥。因为智能体能调用的每个工具都是只读的，埋在一条抓取回复里的提示注入没法让它发帖或关注任何东西，这去掉了团队出于谨慎加过的一道审查步骤。这个模式对任何常开的读取智能体都适用；持续轮询的机制见用 REST API 做实时监测。

常见问题 {#faq}

AI 智能体能不用开发者账号访问 Twitter/X 数据吗？

能。Sorsa 这类托管 Twitter/X 数据 API 只需要 ApiKey 请求头里的一个 API 密钥，不需要 X 开发者账号、OAuth 流程或应用审核。智能体用一个密钥认证，就能为用户资料、推文、搜索和粉丝调用只读接口。注册即送 100 次免费请求，无需绑卡，所以一个智能体注册后几分钟内就能拉取实时数据。

编码工具该用 Sorsa MCP 服务器还是 Agent 技能？

给 Claude Desktop、Cursor 这类聊天客户端用 MCP 服务器，模型在对话中直接调用只读工具。给 Claude Code、Codex 这类编写并运行集成代码的编码智能体用 SKILL.md 技能，因为技能教它们接口、认证和分页。两者用同一个 Sorsa API 密钥，而很多构建者两个都跑。

一个 AI 智能体能通过 Sorsa API 发推吗？

不能。Sorsa 从设计上就是只读、没有写入接口，所以智能体没法通过它发帖、回复、点赞、关注或发私信。这是有意的：只读访问让自主智能体远离用户账号。账号上的写操作，官方 X API 是合规路径；Sorsa 覆盖读取侧，这正是多数智能体和编码工具工作流真正需要的。

Twitter/X 数据对一个 AI 智能体要花多少钱？

官方 X API 按抓取的资源计费，帖子每条 $0.005、资料每份 $0.010，所以一条带作者的推文约每 1,000 条 $15。Sorsa 采用按请求计费：$49、$199 或 $899 每月分别对应 1 万、10 万或 50 万次请求。批量查询落在约每 1,000 条推文 $0.02，搜索约每 1,000 条 $0.10，作者资料则免费包含。

官方 X MCP 服务器是什么，有何不同？

X 在 2026 年 6 月 30 日推出了一个第一方托管 MCP 服务器，让 AI 客户端通过开发者自己的 OAuth 凭据读写 X，并路由通过其 X API 套餐，支持写操作，只读服务器则不支持。取舍在成本：它在按量付费模型上按调用计费；只读的 Sorsa MCP 服务器本地运行，按请求对一个固定套餐计费。

哪些 AI 编码工具能配合 Sorsa Twitter/X 技能？

该技能用开放的 SKILL.md 格式，所以能配合任何读取该格式的智能体，包括 Claude Code、Cursor 和 Codex CLI。MCP 服务器能配合任何兼容 MCP 的客户端：Claude Desktop、Claude Code、Cursor、带 GitHub Copilot 的 VS Code 和 Windsurf 等。无论哪种方式，配置都是同样的标准配置加一个 Sorsa API 密钥。

如何开始 {#getting-started}

你可以在写任何代码之前先试这份数据。先在在线试用工具 Playground 里从一个界面运行接口、无需注册，然后领取 100 次免费请求，把一个真实智能体指向实时数据。这 100 次请求一次性、无需绑卡、永不过期、覆盖全部 40 个接口，足够端到端测试 MCP 服务器、技能或一次直接调用。

再往后，挑一条路径。为聊天客户端加上 MCP 配置、为编码智能体克隆技能，或把 AI 可读文档粘进你的编辑器、让它编写集成。完整文档和统一 20 次/秒覆盖运营细节，而把现有智能体从官方 API 迁移过来的团队可以跟着迁移指南走。如果你还在掂量服务商，Twitter API 替代方案对比用真实数字摆出了各选项。

审校：Keksich（Sorsa 创始人，X API 研究者）

本指南取材于对 Sorsa API 的一线运营、线上接口和公开的 MCP 与技能仓库，以及当前的 v3 文档。外部数字于 2026 年 7 月 11 日对照 Stack Overflow 2025 开发者调查（AI 工具采用与信任），以及 X 自己关于托管 MCP 服务器的开发者公告（2026 年 6 月 30 日）和 2026 年 4 月 20 日的 X API 定价更新（成本对比）核实。官方 X API 全文都是主要的对比参照点。