为 AI 打造的推特(X)接口

把文档地址粘进任意大模型,一个提示词就能交付推特集成。为 AI 编程助手而建,也为需要推特实时数据的自主智能体而建。前 100 次请求免费:无需绑卡,永不过期。

api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt
适用于 Claude、GPT、Gemini、Grok、Cursor 和任何 AI。

AI 编程助手

在你已经在用的工具里直接交付

粘提示词,粘文档地址,拿到能跑的代码。下面是每个工具对应的提示词。

Claude Code

在终端里完成整个项目的集成。

Build a Python script that pulls every tweet from @naval and saves them to CSV. Use the Sorsa API, docs: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt

OpenAI Codex

生成函数和模块。

Write a function that takes a list of usernames and returns their follower counts with the Sorsa API. Docs: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt

Cursor

在编辑器里加一个接口客户端。

Add a Sorsa API client to this project that searches tweets by keyword and handles pagination. Docs: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt

GitHub Copilot

行内补全。

# Sorsa API docs: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt
# search tweets for "AI agents" with over 100 likes, latest first

Gemini CLI

在命令行里快速拉数据。

Use the Sorsa API to fetch the latest 100 mentions of @openai with over 50 likes. Docs: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt

ChatGPT 或 Claude

一次性脚本,零配置。

Here are the Sorsa API docs: https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt Write me a script to download all tweets from @sama into a CSV.

在 Grok build、Antigravity 以及任何其他大模型或编程智能体里都一样好用。需要的只是文档地址。


为 AI 智能体准备

把推特实时数据接进你的 AI 智能体

用干净的工具而不是胶水代码,把任意自主智能体连上推特实时流。所有套餐统一 20 次/秒,智能体转为自主运行时不会立刻被限速;只读访问则意味着智能体弄不坏任何东西。

原生支持 function calling

每个接口都干净地对应一个智能体可以调用的工具。

为自主循环而建

所有套餐统一 20 次/秒,每次请求成本可预估。

默认安全

只读,所以智能体能读推特数据,但绝不发帖或删除。

一个 skill 接入 Sorsa API

把开源的 Sorsa API skill 装一次,你的智能体就获得推特只读工具:搜索推文、读取用户资料、拉取粉丝与关注、取用户时间线、追踪提及、读热搜。它基于开放的 SKILL.md 格式,可用于 Claude Code、Cursor 和 Codex CLI,也可用于 OpenClaw(通过 ClawHub)、Hermes Agent 这类基于 skill 的智能体,或任何能加载 skill 目录的智能体。密钥由你自己带。无需推特开发者账号,不发帖,也没有写权限。

Claude Code Cursor Codex CLI OpenClaw Hermes Agent OpenAGI Claude tool use OpenAI function calling 任何自研智能体
  • 搜索推文
  • 读取用户资料
  • 粉丝与关注
  • 用户时间线
  • 追踪提及
  • 读热搜

更喜欢 MCP?接上 Sorsa API MCP 服务器

把 Sorsa API 作为原生工具加进 Claude、Cursor、VS Code 和任意 MCP 客户端。开源服务器把全部 40 个接口暴露成 40 个 MCP 工具,一条 npx 命令装好。和官方托管的 X MCP 不同,这里没有 OAuth 流程,也没有按资源计费:一个密钥,按请求固定计费,你这边零胶水代码。

配置 MCP 服务器 在 GitHub 上查看服务器

一次搞定

从提示词到数据,一次就跑通

一次真实往返。你提问,模型读文档,然后交付这段代码。

"找出最近关于 AI 智能体、点赞数超过 100 的推文,保存成 CSV。用 Sorsa API。"

Python
import requests, csv

resp = requests.post(
    "https://api.sorsa.io/v3/search-tweets",
    headers={"ApiKey": "YOUR_API_KEY"},
    json={"query": "AI agents min_faves:100", "order": "latest"},
)
tweets = resp.json()["tweets"]

with open("tweets.csv", "w", newline="") as f:
    writer = csv.writer(f)
    writer.writerow(["author", "likes", "text"])
    for t in tweets:
        writer.writerow([t["user"]["username"], t["likes_count"], t["full_text"]])

整个集成就是这些。用 next_cursor 翻过前 20 条结果。每条推文都已经附带完整的作者资料,不额外收费。


可靠性

为什么模型第一次就能写对

文档就是照着让大模型读一遍就能写出正确、可运行的调用来设计的,不用靠猜。

01

一个自包含的文档文件

模型从同一个地址读到每个接口、参数和响应结构。

02

OpenAPI 3.0,为 function calling 而生

天然契合 Claude tool use 和 OpenAI function calling。

03

干净、可预测的 JSON

每条响应结构一致,生成的代码第一次就能解析成功。

04

固定计费,1 次请求 = 1 次调用

助手写出来的代码,成本始终可预估,不用做按资源的换算。

05

接口贴近官方推特接口

模型已有的知识可以迁移,写出正确调用更快。

06

设计上就是只读

助手或智能体无法发帖、删除或做任何破坏性操作。


对比

AI 助手处理推特数据:没有 Sorsa API 和有 Sorsa API

助手或智能体单靠自己能对推特数据做什么,接上 Sorsa API 之后又能做什么。

能力没有 Sorsa API有 Sorsa API
全站搜索推特做不到,只能读你粘进去的一个链接按关键词、操作符、日期和互动量在数百万条里检索
读取资料和粉丝关系图仅限粘进去的那一页按用户名或 ID 取完整资料、粉丝和关注
实时数据过期或被拦实时的推文、指标和热搜
做出能跑的集成去猜没文档或被 OAuth 挡住的接口,然后卡住读文档地址就交付代码
大规模自主运行被限速,而且脆弱所有套餐统一 20 次/秒,按请求固定计费

使用场景

一个提示词能做出什么

把助手指向文档,描述你要的结果。下面每一个都只差一个提示词。

针对任意关键词或股票代码的情感分析管道。

看做法

把粉丝或关注列表导出成 CSV。

看做法

实时监测品牌提及。

看做法

追踪竞品的时间线和互动。

看做法

拉取任意地区的热搜话题。

看做法

为模型训练搭建干净的数据集。

看做法

AI 原生

一个地址。全部接口。任意大模型。

我们的文档是一个自包含、机器可读的单文件。把地址丢进 Claude Code、Codex、Cursor、ChatGPT、Gemini 或 Grok,模型当场学会每个接口、参数和响应结构,然后端到端写出你的集成。没有 SDK 要学,也没有包装层要写。

api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt
01

一个文档文件

模型从同一个地址读完全部内容,不用爬 30 个文档页。

02

OpenAPI 3.0 规范

为机器阅读和原生 function calling 而结构化。

03

干净的 JSON

每条响应结构一致且可预测,生成的代码直接就能跑。


常见问题

问题,都在这里

Claude Code、Cursor 或 Codex 能写出 Sorsa API 的集成吗?

能。把文档地址粘进你的助手,它会写好客户端、请求和响应解析。多数集成一个提示词就够了。

在 AI 工具里用 Sorsa API 需要装什么吗?

不需要。只是生成代码的话,粘上文档地址就行。想要实时的智能体工具,可以选装 MCP 服务器或 Sorsa API skill,但起步都不是必需的。

Sorsa API 支持 OpenAI function calling 和 Claude tool use 吗?

支持。OpenAPI 3.0 规范和干净、可预测的 JSON 就是为这两者准备的。

哪些 AI 智能体能用 Sorsa API skill?

Claude Code、Cursor 和 Codex CLI,基于 skill 的智能体如 OpenClaw(通过 ClawHub)和 Hermes Agent,以及任何能读开放 SKILL.md 格式的智能体。密钥由你自己带。

AI 智能体能通过 Sorsa API 发推文或发私信吗?

不能。Sorsa API 设计上就是只读。这让自主运行的智能体保持安全,服务也更稳定:智能体可以读推特数据,但绝不发帖、删除或关注。

智能体循环跑起来,怎么让接口成本可预估?

靠固定计费。所有接口、所有套餐都是 1 次请求等于 1 次调用,统一 20 次/秒,智能体不会被限速。

能免费用 AI 工具试试 Sorsa API 吗?

能。注册即送 100 次免费请求:仅此一次,无需绑卡,永不过期,覆盖全部 40 个接口。这足够把生成的代码、MCP 服务器或 skill 端到端试一遍,再决定选哪个套餐。

有 OpenAPI 规范和 MCP 服务器吗?

两个都有。OpenAPI 3.0 文档只有一个地址,开源的 Sorsa API MCP 服务器把全部 40 个接口变成任意 MCP 客户端里的原生工具。一条 npx 命令装好,一个密钥就能跑,不用配 OAuth。

到底能拉到什么数据?

推特公开数据:推文与用户搜索、用户资料、粉丝与关注、时间线、评论、引用、转发者、提及、热搜和行为验证。

粘上文档。一个提示词交付。

把地址丢进你的助手,拿个密钥,推特集成就做完了。前 100 次请求免费:无需绑卡,永不过期。

获取 API 密钥