WEIR

twikit 替代方案 2026:twscrape、snscrape 现状与 Python 迁移

twikit 停在 2.3.3,KEY_BYTE 报错上游没修;twscrape 还在更新但要登录账号;snscrape 2023 年已失效。附 11 月 17 日核对的状态表、封号风险、字段对照和迁移代码。


发布于 · 更新于 · 阅读约 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 号问题,也在同一天关闭。

表格:snscrape、twikit、twifork 和 twscrape 从 2023 年 6 月到 2026 年 11 月的关键日期
按 PyPI 和 GitHub 记录整理,2026 年 11 月 17 日核对

升级到 0.21.0 要改代码:请求失败时会抛出 AbortReqError、ApiError 等异常,不再返回 None。

README 写明它“requires authorized X/Twitter accounts”,也就是要已登录的 X 账号。

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

迁移只改三处:

  1. 拿到 Key免费注册 Weir,复制 API Key。不用绑卡,也不用 X 账号。
  2. 换掉调用把 api.search() 或 search_tweet() 换成 POST /v1/x/search。
  3. 用 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 积分:

终端:weir_search.py 通过 Weir 搜到 NASA 的 5 条推文,打印 ID、用户名和正文,本页扣 6 积分
真实运行,2026 年 11 月 17 日
  • 多了两个过滤。 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 积分。

读取 1,000 条推文,2026 年 11 月 17 日的价格
官方 X API$5.00
Weir,$5 套餐约 $0.21
Weir,$20 套餐约 $0.175
TwitterAPI.io$0.15

每月 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)核对,除注明外均为英文页面: