# 推特社群匯出工具：成員轉成 CSV

推特社群匯出工具：把任何公開 X 社群的成員名單存成 CSV 或 Excel。需要 Pro，並連接你自己的 X 帳號，最多 1,000 位成員。

Page: https://twitterviewer.app/zh-hant/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 只在應用程式內顯示這份名單，一次一整個畫面，而且沒有任何按鈕能把它變成檔案。本頁負責的就是這一步：你貼上一個社群連結，成員會載入到即時表格中，然後你就可以把它們下載成 CSV 或 Excel。

它是為真正需要在 X 之外使用這份名單的人打造的：想要備份的版主、想知道管理員和版主是誰的社群經營者、會統計和比較各種群組的研究者，以及任何想把對話搬到郵件清單、Discord 或 Telegram 上的人。如果你想在匯出之前先了解社群整體怎麼運作，[匯出 X 社群成員的完整指南](https://twitterviewer.app/zh-hant/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>`。

## 推特社群匯出工具怎麼用，一步步來

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 登入狀態，所以誠實的比較在於程式碼在哪裡執行、能碰到什麼。

| | 瀏覽器擴充功能 | 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-hant/twitter-profile-viewer)上看到。
- **電子郵件、電話號碼或私人訊息。** 這些都不在成員名單裡，也不在檔案裡。
- **任何與貼文有關的內容。** 這次匯出只是一份名冊。它不會讀取社群的貼文，也不會讀取成員的貼文。
- **精確到秒的即時資料。** 成員名單會依帳號和社群快取最多約 15 分鐘，所以一分鐘前才加入的成員可能還不在檔案裡。

> **Warning: 請謹慎使用這份名單**
> 成員名單是一群真實的人，他們並沒有同意被你聯繫。請透過公開貼文邀請他們，並尊重他們的選擇。未經請求的群發訊息可能導致帳號被限制。

## 大家怎麼運用社群成員匯出

### 版主與擁有者

定期備份社群裡有誰，並保留帶日期的版本。依 `role` 欄篩選，就能在一個檢視中看到管理員和版主。把本月的匯出和上個月的相比，可以大致看出這個群體成長了多少，因為每個檔案都是當時的快照。

### 社群經營者

依使用者名稱排序，掃一遍驗證標記，挑出你想感謝、想特別介紹或想邀請來幫忙管理的人。`profile_url` 欄給你一個可以開啟任何成員 X 個人檔案的連結；想更仔細看某位成員最近的貼文，可以把該使用者名稱貼進[個人檔案檢視器](https://twitterviewer.app/zh-hant/twitter-profile-viewer)，或看他們的[媒體](https://twitterviewer.app/zh-hant/twitter-media-viewer)和[回覆](https://twitterviewer.app/zh-hant/twitter-reply-viewer)。

### 研究者與分析人員

為一組社群分別匯出檔案，統計成員和角色，然後在單一活頁簿裡比較。因為檔案裡只有 X 公開出來的內容，沒有需要清理的隱藏資料，而且每次的欄位都一樣。

### 把對話搬到別處

如果一個社群已經超出 X 能承載的規模，一份使用者名稱清單就是建立郵件清單、Discord 伺服器或 Telegram 群組的起點。匯出給你的是使用者名稱和個人檔案連結，至於怎麼以尊重的方式聯繫他們，由你決定。

## Pro、定價與 X 帳號狀態列

社群匯出是需要連接 X 帳號的四項功能之一，另外三項是[進階搜尋](https://twitterviewer.app/zh-hant/twitter-advanced-search)、讚的分頁，以及所有回覆頁面。這四項都屬於 Pro，Pro 每月 5 美元或每年 48 美元（相當於每月 4 美元）。Pro 透過 Stripe 以信用卡付款，每期自動續訂直到你取消；你隨時可以取消，並在已付費的期間內繼續使用 Pro。[定價頁面](https://twitterviewer.app/zh-hant/pricing)有完整的說明，而且 Pro 也會取消查看時的速率限制。

輸入框下方的狀態列會在你貼上連結之前顯示你的目前狀態：是需要升級、需要連接、需要重新連接，或是匯出會使用哪個 @使用者名稱。

## 疑難排解

如果出了問題，頁面上的訊息會告訴你屬於下面哪一種。

- **「登入」或「升級至 Pro」。** 匯出需要已登入的 Pro 帳號。請先登入或升級，然後再試一次。
- **「連接 X 帳號」或「重新連接 X 帳號」。** 沒有儲存 cookie，或是因為你登出了 x.com 或變更了密碼，X 不再接受你儲存的那個 cookie。請用新的值重新連接。
- **「找不到社群」。** 檢查連結是否完整，以及該社群是否為公開社群。
- **「X 目前忙碌中」。** X 正在進行速率限制或逾時。等一分鐘再重試匯出。
- **檔案裡的數量比顯示的成員數少。** 卡片顯示的是 X 回報的該社群人數，而檔案裡包含的是 X 實際回傳的成員。期間可能有成員離開，而且 1,000 的上限也會生效。

## 推特社群匯出工具常見問題

### 什麼是推特社群匯出工具？

推特社群匯出工具是一款工具，能把 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-hant/twitter-profile-viewer)去查某個帳號。

### 這個和瀏覽器擴充功能有什麼不同？

擴充功能是你安裝在瀏覽器裡的程式碼，在你已登入的工作階段下於 x.com 頁面執行。這個匯出工具不需要安裝任何東西：由我們的伺服器送出請求，使用你所連接的 X 帳號的 cookie，加密儲存，中斷連接時刪除。兩者都會用到你的 X 登入狀態，所以選擇在於你想讓程式碼和憑證放在哪裡。

### 我該用哪種檔案格式，CSV 還是 Excel？

想把這份名單匯入其他工具就選 CSV，想自己排序、篩選和查看就選 Excel。CSV 在 Excel 裡能正確開啟非拉丁文字的姓名，Excel 檔案則有凍結的標題列和帶類型的欄位。兩個檔案裡的資料完全相同。