twikit 替代方案 2026:twscrape、snscrape 现状与 Python 迁移
twikit 停在 2.3.3,KEY_BYTE 报错上游没修;twscrape 还在更新但要登录账号;snscrape 2023 年已失效。附 11 月 17 日核对的状态表、封号风险、字段对照和迁移代码。
Weir Team
发布于 · 更新于 · 阅读约 7 分钟 · Read in English
twikit 的替代方案有三条路:还在更新的 twscrape、官方 API,以及不用登录的托管 API。
这篇写给 twikit、twscrape 或 snscrape 脚本突然报错的 Python 开发者。你会看到这些库在 2026 年 11 月 17 日的状态、登录账号的风险,以及把搜索循环迁到 REST API 的代码。
示例里的 Weir 是我们做的 API,请把这一点考虑进去。下面这条请求不用 X(推特)账号,也不用 cookie:
curl https://api.weirapp.io/v1/x/search \
-H "Authorization: Bearer $WEIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "from:XDevelopers lang:en -filter:nativeretweets", "limit": 3}'
twikit、twscrape、snscrape 2026 年还能用吗?
还在更新的爬虫库,全都要登录 X。我们在 2026 年 11 月 17 日查了 PyPI 和 GitHub,Tweepy 是官方 API 的客户端,放进来对照:
| 库 | PyPI 最新版本 | 登录 X? | 状态 |
|---|---|---|---|
| twikit | 2.3.3,2025-02-07 | 要 | #408 未修,135 个 issue |
| twifork | 2.4.0,2026-08-30 | 要,只认 cookie | twikit 的社区分支 |
| twscrape | 0.21.0,2026-11-06 | 要,账号池 | 活跃,12 个 issue |
| Scweet | 5.8.2,2026-10-22 | 要,cookie | 活跃 |
| snscrape | 0.7.0.20230622,2023-06-22 | 不登录 | 推特部分已失效 |
| Tweepy | 4.17.0,2026-07-02 | 不用,开发者 Key | 官方 X API,按量付费 |
issue 数为当天未关闭的数量。twikit、twscrape、snscrape 和 Tweepy 都没有归档。
twikit 替代方案怎么选?
按你能接受什么来选,没有哪一条路适合所有人:
- twscrape 还跑得动、量也不大: 先别换,按 0.21.0 改好出错处理,接受账号风险。
- 要发推,或者需要 X 本身的许可: 用官方 X API,Python 里用 Tweepy。
- 不想再拿账号冒险,只读公开数据: 用托管 API,Weir 是其中一家。
snscrape 为什么不能用了?
snscrape 从来不登录,只读未登录的访客能看到的内容。
2023 年 6 月 30 日,维护者开了 #996 号问题“All Twitter scrapes are failing: blocked (404)”。他说,这很可能和推特当天整站放到登录墙后有关。
两天后他又写:“Auth will not be added.”意思是不会加登录。这个问题至今没有关闭,PyPI 上也再没有新版本。
所以 blocked (404) 不是你的环境出了错,重装、换 Python 版本都没用。
twikit 登录报错、KEY_BYTE 报错:上游没有修
twikit 用你的账号登录,再调用 x.com 网页版用的内部 GraphQL 接口。X 一改网页版,它就坏。
GitHub 上能查到这几种报错:
Couldn't get KEY_BYTE indices: #408 报告从 2026 年 3 月 18 日起所有调用都失败,至今未关闭。- 登录返回 399: #414(2026 年 4 月)的报错是“Could not log you in now”。
- 登录返回 398: #305(2025 年 2 月)的报错是“We were unable to confirm you're human”。
升级没用,2.3.3 就是最新版。最后一次合并代码是 2025 年 4 月 22 日,之后只改过 README。
社区分支 twifork 在 2026 年 8 月发了 2.4.0,说修好了 #408。它的 README 也写明,密码登录“cannot be made to work”,只能用浏览器登录后的 cookie。
twscrape 还能用,代价是你的账号
twscrape 一直在跟着 X 的改动更新。2026 年它发了 8 个版本,0.21.0 发布于 11 月 6 日。
Cloudflare 拦截 user_by_id 的 #337 号问题,也在同一天关闭。

升级到 0.21.0 要改代码:请求失败时会抛出 AbortReqError、ApiError 等异常,不再返回 None。
README 写明它“requires authorized X/Twitter accounts”,也就是要已登录的 X 账号。
用 cookie 的库,风险落在你的账号上
X 的简体中文版用户协议 2026 年 10 月 9 日生效,原文这样写:
登录型的库用的正是你的账号,各家自己的说法也对得上:
- twikit 用户报告被冻结。 #359 的提问者说,换哪个账号用 twikit 都被冻结,下面有 25 条评论。
- twscrape 为冻结留了后路。 0.21.0 的说明写着,被冻结的账号会被标记为不可用,换下一个账号继续。
- Scweet 不支持密码登录, 理由是程序登录“likely to trigger account locks”,容易让账号被锁。
- snscrape 的维护者在 2021 年就说过, 这样用的账号很可能“would get banned”。
托管 API 不用你的 X 账号,这部分风险不在你身上,但 X 的条款还在。本文不构成法律建议。四种取数方法的完整对比,见推特爬虫 2026。
把 twscrape 搜索循环迁到 REST API
迁移只改三处:
- 拿到 Key免费注册 Weir,复制 API Key。不用绑卡,也不用 X 账号。
- 换掉调用把 api.search() 或 search_tweet() 换成 POST /v1/x/search。
- 用 cursor 翻页把 meta.nextCursor 原样传回,直到它为 null。
你原来的 twscrape 循环大概是这样,改自它的 README,省略了账号部分:
async for tweet in api.search("from:NASA lang:en", limit=20):
print(tweet.id, tweet.user.username, tweet.rawContent)
换成 Weir 只要 requests,也不再需要 asyncio。把下面存为 weir_search.py:
import os, requests
API = "https://api.weirapp.io/v1/x/search"
HEADERS = {"Authorization": "Bearer " + os.environ["WEIR_API_KEY"]}
def search(query, limit=20, max_pages=5):
body = {"query": query, "limit": limit} # sort 默认 latest,和 twscrape 一样
for _ in range(max_pages): # 页数上限,也是花费上限
r = requests.post(API, json=body, headers=HEADERS, timeout=60)
r.raise_for_status() # 402、429 等错误直接抛出,不扣积分
print("# 本页扣", r.headers["x-credits-charged"], "积分")
page = r.json()
yield from page["data"]
body["cursor"] = page["meta"]["nextCursor"]
if not body["cursor"]: # 只有 null 表示没有下一页
return
在文件末尾加上调用。查询字符串原样放进 query,X 的搜索语法照用:
QUERY = "from:NASA lang:en -filter:replies -filter:nativeretweets"
for post in search(QUERY, limit=5, max_pages=1):
print(post["id"], post["author"]["username"], post["text"][:30].replace("\n", " "))
正式跑时去掉 limit=5, max_pages=1 即可。我们在 2026 年 11 月 17 日 22:00(UTC)带着这两个参数跑了一次,拿到 NASA 最新的 5 条原创推文,扣 6 积分:

- 多了两个过滤。 X 搜索默认会带上回复和转推,加上这两个运算符,只留原创。
- 错误看状态码。
429等Retry-After秒后重试;402是积分用完,重试没用。 - twikit 的写法也对得上。
search_tweet(q, "Latest")对应默认的latest,"Top"对应"sort": "top"。
字段对照:twscrape、twikit 的字段在 Weir 叫什么
开头那条 curl,我们 11 月 17 日跑出 3 条推文,扣 4 积分。第一条删减后是这样:
{
"id": "2120289321693630734",
"text": "Your agent can no longer send an 𝕏 Chat to your ex by mistake",
"createdAt": "2026-11-10T22:55:42.000Z",
"author": { "username": "XDevelopers", "followersCount": 696778 },
"likeCount": 411,
"viewCount": 23726
}
字段名大多一一对应,改个名就行:
| 字段 | twscrape | twikit | Weir |
|---|---|---|---|
| 推文 ID | id(int) |
id |
id(字符串) |
| 正文 | rawContent |
full_text |
text |
| 发布时间 | date |
created_at |
createdAt(UTC) |
| 用户名 | user.username |
user.screen_name |
author.username |
| 粉丝数 | user.followersCount |
user.followers_count |
author.followersCount |
| 点赞数 | likeCount |
favorite_count |
likeCount |
| 浏览量 | viewCount |
view_count |
viewCount |
| 下一页 | async for 自动翻页 |
await tweets.next() |
meta.nextCursor |
id 要存成字符串:19 位的推文 ID 超过 2^53,转成浮点数会丢精度。
迁过来以后,1,000 条推文要多少钱?
Weir 每次调用扣 1 积分,每条推文再扣 1 积分。X 每页搜索最多给约 20 条,所以 1,000 条大约是 50 次调用、1,050 积分。
每月 5,000 免费积分约够 4,760 条推文,不用绑卡。$5(美元)买 25,000 积分,永不过期。
出错的调用不扣积分。省额度的办法,见推特 API 免费额度。
什么时候不适合用 Weir
- 你要发推、点赞或发私信。 Weir 只读,这些要用官方 X API。
- 你只比单价。 TwitterAPI.io 标价每 1,000 条推文 $0.15,比我们的 $5 套餐便宜。
- 你需要 X 的正式授权。 Weir 没有 X 的授权,访问方式可能变化。
常见问题
twikit 登录报错怎么办?
升级解决不了,2.3.3 就是最新版。KEY_BYTE 报错(#408)和 399 登录错误(#414)上游都还没修,twifork 也说密码登录已经行不通。不想再折腾账号,就换官方 API 或托管 API。
snscrape 2026 年还能用吗?
用在推特上不能。它从不登录,2023 年 6 月 30 日推特整站上了登录墙,它的推特抓取从那天起全部失败。维护者说不会加登录,之后再没发过新版本。
有没有不需要登录 X 的 Python 方案?
有两种:官方 X API 用开发者 Key,每读一条推文 $0.005(美元);托管 API 用服务商的 Key,比如 Weir。还能用的开源爬虫库都要登录。
用 twscrape 会被封号吗?
有可能。它的 README 写明要已授权的账号,还提醒 X 的条款不鼓励多账号。登录用的每个账号,都要当作可能被锁。
参考来源
以下均于 2026 年 11 月 17 日(UTC)核对,除注明外均为英文页面:
- twikit(2.3.3)和第 305、359、408、414 号问题:https://pypi.org/project/twikit/ 、https://github.com/d60/twikit/issues
- twifork(2.4.0)和 Scweet(5.8.2)的 README:https://pypi.org/project/twifork/ 、https://pypi.org/project/Scweet/
- twscrape(0.21.0)的 README、发布说明和第 337 号问题:https://github.com/vladkens/twscrape
- snscrape 第 996 和 270 号问题:https://github.com/JustAnotherArchivist/snscrape/issues/996 、https://github.com/JustAnotherArchivist/snscrape/issues/270
- Tweepy(4.17.0):https://pypi.org/project/tweepy/
- X 用户协议,2026 年 10 月 9 日生效(简体中文版):https://x.com/zh-cn/tos
- 价格:https://docs.x.com/x-api/getting-started/pricing 、https://twitterapi.io/pricing
- Weir 计费和错误:https://docs.weirapp.io/billing 、https://docs.weirapp.io/errors
- 我们的 Weir 调用:一次 curl 搜索(4 积分)、两次 Python 搜索(各 6 积分,第一次没去掉回复,未采用)、一次用量查询(免费)