常见问题
如果这里没答上,API 参考写得更细。
XCrap 是什么?
一个免费服务,读 X 上的公开帖子、推文串和个人主页,再以 Markdown、JSON、YAML、CSV 或 HTML 的形式还给你。它存在的意义,是让智能体、机器人和小项目不用 API key 也能读 X。
真的免费吗?
是。不用账号,不用密钥,不用绑卡,也没有试用期。全靠捐赠维持,运营成本就是一个域名加一台小服务器。
我需要 API key 吗?
不需要。没有密钥要生成,也没有请求头要发。速率限制按 IP 地址和接口分别施加。
速率限制是多少?
按 IP、按接口计算:单条帖子和主页每分钟 45 次,推文串、时间线、回复和关注列表每分钟 15 次,媒体每分钟 20 次,历史导出每五分钟 4 次、批量请求每五分钟 6 次,搜索每十五分钟 10 次。每个响应都会在 x-ratelimit 系列头里告诉你还剩多少。需要更多?请看企业版。
能读私密或者受保护的账号吗?
不能,以后也不会。受保护账号返回的 404,和它给其他任何人的一样;私信则完全无法访问。XCrap 只读取公开账号:帖子、个人资料、回复和关注者列表。
能读已删除的帖子吗?
不能。帖子在 X 上没了,这里也就没了。五天的缓存可能还会短暂留着刚刚被删掉的东西,那份副本会在过期时丢掉。
怎么拿到一整个推文串?
用 /v1/thread,给它串里任意一条帖子的链接,第一条也行。X 只会告诉你某条帖子的父级,所以我们按 conversation id 拼接作者的时间线,一路往后把串走完。
我能下载视频或者图片吗?
能。/v1/media 会列出每个附件和它的下载链接,X 编码过的每一档码率都有。文件是直接流式转发的,从不写进我们的磁盘。
有哪些格式可以拿?
JSON、Markdown、YAML、CSV,以及一张独立的 HTML 卡片。给任意请求加上 ?format=,或者发一个 Accept 头。
怎么在 AI 智能体里用?
三种方式。把 MCP 服务器加进客户端配置;下载技能文件粘进 prompt;或者把你的框架指向 OpenAPI 规范。
x-markdown-tokens 这个头是干什么的?
它是对一个 Markdown 响应要花多少 token 的估算,每个 Markdown 响应都会带上。这样智能体在读正文之前,就能判断一个推文串塞不塞得进它的上下文。
有全文搜索吗?
有:/v1/search 接受 X 搜索能理解的任何查询,包括 from:、"精确短语"、since: 等运算符,返回最新或最热门的帖子,或只返回带图片或视频的帖子。它是限流最严格的端点。
你们会保留我的请求多久?
请求日志会保存路径、时间戳、IP 和请求头,好让我们发现滥用、排查故障。帖子内容缓存五天后删除。我们是管道,不是档案馆。
这合法吗?
读取公开网页不构成未经授权的访问,美国法院在 hiQ v. LinkedIn 一案中确认了这一点。它确实违反了 X 的服务条款,但那是我们和 X 之间的合同问题,不是刑事问题。你拿到数据之后做了什么,由你自己负责。
我在 X 上,我不想被这个服务读到。
用一个能和该账号对上的邮箱发信到 [email protected],这个用户名就会进屏蔽名单,任何请求跑起来之前都会先查这份名单。不争辩,不填表。
为什么不用官方 API?
你要是用得起就去用。入门档每月 $200,顶档 $42,000,而免费档根本读不了帖子。XCrap 是为这条线以下的所有人存在的。
X 那边改了东西会怎样?
每个接口后面垫着四个数据源,它们各自独立失效。我们自己的客户端挂了,请求会落到下一个上继续给出结果,我们同时去修。
我可以自己部署吗?
不行。XCrap 是闭源的,也没有可供运行的发行版。如果你要为重要的事情拿到有保障的容量,企业版提供专属容量和更高限额:写信到 [email protected]。只要捐助能覆盖服务器,免费 API 就一直免费。
能商用吗?
可以。免费 API 没有许可证密钥,也没有用量分级。请遵守速率限制,另外记住:遵守 X 的条款以及你所在地的数据保护法,是你自己的责任。如果你的产品需要更多容量,企业版就是为此准备的。
我能帮上什么忙?
有余力就捐一点,服务器是唯一真正的开销。发现坏了的地方就报告。告诉其他在做智能体的人有这么个东西。
有没有被收录?
Aura++ 的目录收录了 XCrap,它的徽章就在下面。如果你在运营目录并想收录它,写信到 [email protected],你的徽章就会放在那一个旁边。