# X 社区导出器：成员导出 CSV

X 社区导出器：把任意公开 X 社区的成员列表导出为 CSV 或 Excel。Pro 功能，使用你自己连接的 X 账号，最多 1,000 人。

Page: https://twitterviewer.app/zh-hans/x-communities-exporter

## Plan

- Pro only: advanced search, community member export (up to 1,000 members), likes tab and every page of replies, fetched with the X account the user connects (the user pastes their own x.com session cookie, stored encrypted).

## 什么是 X 社区导出器？

X 社区导出器是一款工具，它会读取 X 社区的成员列表（这类主题群组以前叫推特社区），并把它保存成表格文件。X 只在应用内展示这份列表，一屏一屏地翻，而且没有任何按钮能把它变成文件。本页负责的正是这一步：你粘贴一个社区链接，成员会加载进实时表格，然后你就可以把它们下载成 CSV 或 Excel。它面向的正是需要导出推特社区成员的场景。

它是为那些真正需要在 X 之外使用这份名单的人做的：想要备份的版主、想知道谁是管理者和版主的社区运营者、统计和比较各类群体的研究者，以及任何想把对话搬到邮件列表、Discord 或 Telegram 上的人。如果你想在导出之前先了解社区整体是怎么运作的，[导出 X 社区成员的完整指南](https://twitterviewer.app/zh-hans/blog/export-x-community-members)里有更全面的说明。

> **Note: 需要 Pro，并使用你自己的 X 账号**
> 导出是 Pro 的一部分，并且要用你自己连接的 X 账号来运行。X 只向已登录用户提供社区成员列表，所以没有账号就无法导出。细节见下文各节。

## 文件里有什么

每次导出每位成员一行，共十一列，顺序如下：

| 列 | 内容 |
| --- | --- |
| `handle` | 不带 @ 符号的 @用户名 |
| `name` | 显示名称 |
| `role` | `admin`、`moderator` 或 `member` |
| `followers` | 空（见下） |
| `following` | 空 |
| `posts` | 空 |
| `verified` | `true` 或 `false`，X 报告的认证标记 |
| `location` | 空 |
| `bio` | 空 |
| `created_at` | 空 |
| `profile_url` | `https://x.com/<handle>` |

十一列里有六列是空的，这是数据源的限制，不是 bug。X 提供给已登录账号的成员列表只包含名称、用户名、头像、认证标记，以及该成员在社区里的角色。粉丝数、简介、所在地和加入日期都不在那个响应里，所以我们把这些单元格留空，而不是去猜。这些列仍然保留在文件里，是为了让版式保持一致，如果你有别的数据源，也可以自己把它填上。

可以依赖的是对大多数社区工作真正重要的部分：谁在群里、他们是什么角色，以及每个主页都能打开的链接。本页的实时预览展示其中四列，即用户名、显示名称、角色和主页 URL，而下载下来的文件包含全部十一列。

### CSV 还是 Excel

CSV 文件是带字节顺序标记的 UTF-8，并使用 Windows 风格的换行，因此 Excel 打开时，阿拉伯语、日语或任何其它文字的姓名都完好无损。以 `=`、`+`、`-` 或 `@` 开头的文本会被加上一个前置撇号，避免电子表格把显示名称当成公式执行。当你要把这份名单导入其它工具时，用 CSV。

Excel 文件是真正的 `.xlsx` 工作簿，只有一个名为 Members 的工作表，表头加粗并在滚动时保持冻结，数字列和认证列使用带类型的单元格。当你想自己排序、筛选和查看这份名单时，就用它。两个文件都在你的浏览器里根据刚刚抓取到的行生成，文件名是 `twitterviewer-community-<id>`。

## X 社区导出器怎么用，一步步来

1. **升级并连接你的 X 账号，只需一次。** Pro 解锁导出器。然后用输入框下方状态栏里的「连接 X 账号」按钮，或者账户 → X 账号，连接请求要使用的账号（下一节会说明这涉及什么）。
2. **复制社区链接。** 在 X 里打开该社区并复制它的地址，形如 `https://x.com/i/communities/1234567890`。末尾那串数字单独使用也可以。
3. **粘贴到上方并选择「导出成员」。** 页面会先查找该社区，显示它的名称和成员数，然后开始读取成员列表。页面上还有一个示例社区链接，如果你想先看看整个流程再用自己的链接，可以用它。
4. **看预览。** 随着每一页返回，成员会出现在表格里，并有一行进度提示，例如「已抓取 340 位，最多 1,000 位成员」。
5. **下载。** 抓取完成后，「下载 CSV」和「下载 Excel」按钮就会变为可用。

页面接受完整的社区 URL 或纯数字 ID。其它内容会得到一条行内提示，要求提供形如 `https://x.com/i/communities/123…` 的链接。你也可以用 `?q=` 加上一个社区链接直接打开页面并开始导出，把它存成书签很方便。

### 需要多长时间

一次运行会一页一页地读取成员，X 每页大约返回 20 位。我们在每页之间等待 2 秒。导出完整的 1,000 位成员大约是 50 页、两分钟左右，再加上请求本身所需的时间。成员只有几百位的社区，不到一分钟就能完成。

这个停顿是刻意的。请求运行在你自己的 X 账号上，而列表请求的密集爆发正是容易让账号被限流或被标记为异常活动的那种流量。慢一点、稳一点，能让你的账号远离麻烦。

你可以让标签页开着去做别的事，但关掉它就会中断运行。每次运行使用一个有效期十分钟的短期导出会话，这远远超过一次 1,000 位成员的导出所需。

## 为什么导出器需要你的 X 账号

X 不会向未登录的用户展示社区成员列表。一个声称完全不需要账号就能导出成员的工具，要么根本没有在导出，要么用的是别人的账号。这个工具用的是你的账号，而且你可以清楚地看到它是怎么用的。

连接时，你从自己在 x.com 上已登录的浏览器会话里，从浏览器开发者工具中的 cookie 里复制 `auth_token` 和 `ct0` 两个值，粘贴进连接表单。表单会一步步引导你完成。随后我们会拿这个 cookie 向 X 校验，只有 X 接受它，我们才会保存。

- **它是加密存储的。** cookie 不会以明文保存。
- **它只用于你发起的请求。** 你在本站运行的导出和 Pro 搜索，除此之外没有后台活动。
- **断开连接就会删除它。** 随时可以在账户 → X 账号里使用「断开连接」。
- **退出 X 登录就会失效。** 如果你在那个浏览器里退出 x.com、修改密码，或者会话过期，X 就会停止接受该 cookie，页面会要求你重新连接。

会话 cookie 就像账号的一把钥匙，所以只连接你愿意这样使用的账号。如果不愿意，用完就断开连接。

## X 社区导出器与浏览器扩展的对比

把社区成员列表变成文件，常见的做法有两种。一种是浏览器扩展，另一种是像这样的服务端工具。两者最终都会用到你的 X 登录状态，所以诚实的比较在于代码在哪里运行、能碰到什么。

| | 浏览器扩展 | TwitterViewer 导出器 |
| --- | --- | --- |
| 运行位置 | 安装在你的浏览器里的代码，在你已登录的会话下运行于 x.com 页面 | 在我们的服务器上，由服务器替你向 X 发送请求 |
| 凭据 | 你实时的浏览器会话，直接使用 | 你连接的 `auth_token` 和 `ct0` cookie，加密存储 |
| 你需要安装什么 | 一个在 X 页面上有权限的扩展 | 什么都不用装 |
| 何时运作 | 在你浏览、打开页面时 | 只在你启动导出或 Pro 搜索时 |
| 如何停止 | 停用或移除扩展 | 断开连接账号，从而删除 cookie |

两种做法都绕不开使用你的账号，我们也不会声称不是这样。实际的差别在于下面这几点。扩展需要安装，并且要被信任可以访问你打开的 X 页面。用这个导出器，你的浏览器里什么都不用装，任何现代浏览器都能用，代价是一个 cookie 会被加密保存在我们的服务器上，直到你断开连接。

## 导出器做不到的事

- **私密或不存在的社区。** 只有公开社区可以导出。如果该社区不存在或不是公开的，页面会显示「未找到社区」，此外什么都不会发生。
- **单次导出超过 1,000 位成员。** 每次运行的上限是 1,000 位成员。如果社区更大，导出会在 1,000 位处停止，页面会用一条提示告诉你。
- **选择哪 1,000 位。** 每次运行都按 X 提供列表的顺序从头开始。我们这边没有偏移量也没有排序，所以对一个大社区再次运行，返回的还是列表开头那部分，再加上期间发生变化的内容。
- **粉丝数、简介、所在地。** 如上所述，X 的成员列表里没有这些。单个账号的这些信息，你可以在它的[个人主页](https://twitterviewer.app/zh-hans/twitter-profile-viewer)上看到。
- **邮箱、电话号码或私信。** 这些都不在成员列表里，也不在文件里。
- **任何与帖子有关的内容。** 这次导出只是一份名单。它不会读取社区的帖子，也不会读取成员的帖子。
- **精确到秒的实时数据。** 成员列表按账号和社区缓存最多约 15 分钟，所以一分钟前刚加入的成员可能还不在文件里。

> **Warning: 谨慎使用这份名单**
> 成员名单是一群真实的人，他们并没有同意被你联系。请通过公开帖子邀请他们，并尊重他们的选择。未经请求的群发消息可能导致账号被限制。

## 社区成员导出常见的用法

### 版主与所有者

定期备份社区里有谁，并保留带日期的版本。按 `role` 列筛选，就能在一个视图里看到管理者和版主。把本月的导出和上个月的对比，可以大致看出这个群体是怎么增长的，因为每个文件都是当时的快照。

### 社区运营者

按用户名排序，扫一遍认证标记，挑出你想感谢、想重点推荐或想邀请来帮忙管理的人。`profile_url` 列给你一个可以打开任意成员 X 主页的链接；想更仔细地看某位成员最近的帖子，可以把该用户名粘贴进[主页查看器](https://twitterviewer.app/zh-hans/twitter-profile-viewer)，或者看他们的[媒体](https://twitterviewer.app/zh-hans/twitter-media-viewer)和[回复](https://twitterviewer.app/zh-hans/twitter-reply-viewer)。

### 研究者与分析人员

为一组社区分别导出文件，统计成员和角色，然后在一个工作簿里比较。因为文件里只有 X 公开出来的内容，没有需要清理的隐藏数据，而且每次的列都一样。

### 把对话搬到别处

如果一个社区正在超出 X 的承载，一份用户名清单就是搭建邮件列表、Discord 服务器或 Telegram 群组的起点。导出给你的是用户名和主页链接，至于怎么以尊重的方式联系他们，由你决定。

## Pro、价格与 X 账号状态栏

社区导出是需要连接 X 账号的四项功能之一，另外三项是[高级搜索](https://twitterviewer.app/zh-hans/twitter-advanced-search)、点赞标签页和所有回复页面。这四项都属于 Pro，Pro 每月 5 美元或每年 48 美元（相当于每月 4 美元）。Pro 通过 Stripe 用卡支付，每期自动续订直到你取消；你随时可以取消，并在已付费的周期内继续使用 Pro。[价格页](https://twitterviewer.app/zh-hans/pricing)有完整的说明，此外 Pro 还取消了查看时的限流。

输入框下方的状态栏会在你粘贴链接之前显示你的当前状态：是需要升级、需要连接、需要重新连接，还是导出会使用哪个 @用户名。

## 疑难排查

如果出了问题，页面上的提示会告诉你属于下面哪一种。

- **「登录」或「升级到 Pro」。** 导出需要已登录的 Pro 账号。先登录或升级，然后重试。
- **「连接 X 账号」或「重新连接 X 账号」。** 没有保存 cookie，或者因为你退出了 x.com 的登录、修改了密码，X 不再接受你保存的那个 cookie。用新的值重新连接。
- **「未找到社区」。** 检查链接是否完整，以及该社区是否为公开社区。
- **「X 当前繁忙」。** X 正在限流或超时。等一分钟再重试导出。
- **文件里的数量比显示的成员数少。** 卡片显示的是 X 报告的该社区人数，而文件里包含的是 X 实际返回的成员。期间可能有成员离开，而且 1,000 的上限也会生效。

## X 社区导出器常见问题

### 什么是 X 社区导出器？

X 社区导出器是一款工具，能把 X 社区的成员列表下载成 CSV 或 Excel 文件。X 只在它自己的应用里展示这份列表，而且只提供给已登录用户，所以导出器用一个你连接的 X 账号来读取它，把成员显示在实时表格里，然后让你保存。文件包含每位成员的用户名、显示名称、角色和主页链接。

### 我如何导出 X 社区的成员？

把社区链接或它的数字 ID 粘贴到本页顶部的框里，然后选择「导出成员」。成员会加载进预览表格，抓取完成后你就可以把这份名单下载成 CSV 或 Excel。首次导出之前，你需要 Pro 和已连接的 X 账号。

### 导出社区成员需要 X 账号吗？

需要。X 只向已登录用户提供社区成员列表，所以导出器必须以已登录的身份读取。你在账户 → X 账号里连接一次自己的账号，粘贴你的 `auth_token` 和 `ct0` cookie 即可。我们会拿它们向 X 校验，加密存储，只用于你发起的导出和搜索，并在你断开连接时删除。

### 导出 X 社区成员是免费的吗？

不是。社区导出属于 Pro，Pro 每月 5 美元或每年 48 美元，通过 Stripe 用卡支付。同一套餐还包含高级搜索、点赞标签页和完整回复列表，这些同样依赖已连接的 X 账号。你随时可以取消，并在已付费的周期内继续使用 Pro。

### 一次最多能导出多少位成员？

每次导出最多 1,000 位成员。如果社区人数更多，导出会在 1,000 位处停止，页面上会有一条提示说明它被截断了。每次运行都按 X 提供列表的顺序从开头开始，所以无法跳到下一千位。

### 一次社区导出要多久？

完整的 1,000 位成员大约两分钟，几百位则不到一分钟。X 大约每页返回 20 位成员，我们在每页之间等待 2 秒，以保护你的账号不被限流。

### 我可以导出私密社区的成员吗？

不可以。只有公开社区可以导出。如果社区不是公开的或不存在，页面会显示「未找到社区」，也不会生成任何文件。导出绝不会绕过 X 的隐私设置。

### 为什么文件里的粉丝数、简介和所在地是空的？

因为 X 的社区成员列表里没有这些内容。它返回的是每位成员的名称、用户名、头像、认证标记和角色，仅此而已。我们把这几列保留在文件里，是为了让版式稳定，并且宁可不猜也要留空。你仍然可以用用户名或 `profile_url`，通过[主页查看器](https://twitterviewer.app/zh-hans/twitter-profile-viewer)去查某个账号。

### 这个和浏览器扩展有什么区别？

扩展是你安装在浏览器里的代码，在你已登录的会话下运行于 x.com 页面。这个导出器不需要安装任何东西：由我们的服务器发送请求，使用你所连接的 X 账号的 cookie，加密存储，断开连接时删除。两者都会用到你的 X 登录状态，所以选择在于你想让代码和凭据放在哪里。

### 我该用哪种文件格式，CSV 还是 Excel？

想把这份名单导入其它工具就选 CSV，想自己排序、筛选和查看就选 Excel。CSV 在 Excel 里能正确打开非拉丁文字的姓名，Excel 文件则有冻结的表头行和带类型的列。两种文件里的数据完全相同。