X.com (Twitter) — Agent Browser 操作手冊
專為 x.com 上的 agent-browser 設計的平台特定操作序列。 每個操作都記錄了:前置條件、逐步的 agent-browser 指令、驗證方法以及已知陷阱。
狀態:所有章節(1-7)皆已測試並記錄。 測試版本:agent-browser 0.24.0,Chrome CDP 連接埠 9222,帳號 @mashijiann。 最後更新:2026-05-06
目錄
裝置目標:預設操作針對桌面版 Chrome。如果要 在行動版網頁上操作,請在
.env中設定DEVICE_PROFILE=ios|android,或 在 agent-browser 指令前加上-p ios|android。記錄動作時, 請傳入--device <target>以標明來源(這不會影響去重 — 按讚是以 帳號為準)。
1. 瀏覽與閱讀
1.1 開啟首頁時間軸
目標:導航至首頁時間軸並確認已載入。
前置條件:已登入(帶有 Cookie 的 Chrome CDP 工作階段)。
步驟:
agent-browser open https://x.com/home
驗證:
# 標題應包含 "Home / X"
agent-browser get title
# URL 應為 https://x.com/home
agent-browser get url
# 快照應顯示區域 "Your Home Timeline" 與分頁 "為你推薦"
agent-browser snapshot -i -c -s '[role="region"]'
關鍵元素:
- 導航側邊欄:
navigation "Primary"— 包含連結:首頁、搜尋和探索、通知、直接訊息、Grok、Premium、書籤、個人檔案 - 時間軸分頁:
tab "為你推薦"(預設選取)、tab "正在關注",可能還有自訂分頁 - 發文區域:
textbox "貼文文字"— 首頁上的內嵌發文框 - 帳號按鈕:
button "帳號選單"— 顯示已登入的使用者名稱 - 時間軸區域:
region "Your Home Timeline"— 包含推文article元素
已知問題:
- 無
1.2 透過網址開啟特定推文
目標:直接導航至一則推文並閱讀其內容。
前置條件:擁有推文網址(例如 https://x.com/user/status/123456)。
步驟:
agent-browser open "https://x.com/<username>/status/<tweet_id>"
驗證:
# 標題應包含作者名稱和推文內容預覽
agent-browser get title
# URL 應符合推文網址
agent-browser get url
# 快照應顯示含有完整文字和互動按鈕的推文 article
agent-browser snapshot -i -c -s 'article'
關鍵元素(推文詳細頁):
- 推文 article:
article— 包含完整推文文字、作者資訊、互動統計 - 作者連結:
link "<DisplayName> 已驗證帳號"、link "@<username>" - 時間戳記:
link "<時間> · <日期>"(例如"下午2:30 · 2026年5月5日") - 觀看次數:
link "<N> 次觀看" - 互動按鈕:
button "N 則回覆。回覆"、button "N 次轉貼。轉貼"、button "N 個讚。喜歡"、button "N 個書籤。書籤"、button "分享貼文" - 訂閱按鈕:
button "訂閱 @<username>"
已知問題:
- 無
1.3 搜尋關鍵字推文
目標:搜尋符合關鍵字或查詢條件的推文,並閱讀結果。
前置條件:已登入。
步驟:
# 搜尋 "熱門" 結果(預設):
agent-browser open "https://x.com/search?q=<url_encoded_query>&src=typed_query"
# 搜尋 "最新" 結果:
agent-browser open "https://x.com/search?q=<url_encoded_query>&src=typed_query&f=live"
# 搜尋 "人物" 結果:
agent-browser open "https://x.com/search?q=<url_encoded_query>&src=typed_query&f=user"
# 搜尋 "媒體" 結果:
agent-browser open "https://x.com/search?q=<url_encoded_query>&src=typed_query&f=image"
驗證:
# 標題應包含 "<query> - 搜尋 / X"
agent-browser get title
# 檢查哪個分頁是啟用的
agent-browser snapshot -i -c -s '[role="tablist"]'
# 讀取搜尋結果推文
agent-browser snapshot -i -c -s 'article'
關鍵元素:
- 搜尋分頁:
tab "熱門"、tab "最新"、tab "人物"、tab "媒體"、tab "清單" fURL 參數控制分頁:省略 = 熱門、live= 最新、user= 人物、image= 媒體- 返回按鈕:
button "返回"— 返回上一頁 - 每個結果都是一個
article元素,結構與時間軸推文相同
已知問題:
- 對查詢字串進行 URL 編碼(空格 →
%20等) - 搜尋結果可能在未認證的工作階段顯示「登入牆」
- X 進階搜尋運算子有效:
from:user、since:2026-01-01、min_faves:100等
1.4 檢視使用者個人檔案
目標:導航至使用者的個人檔案,並閱讀其個人簡介和多則近期推文。
前置條件:擁有使用者名稱或個人檔案網址。
步驟:
# 1. 導航至個人檔案
agent-browser open "https://x.com/<username>"
# 2. 初始快照 — 通常只顯示置頂推文(若有)
agent-browser snapshot -i -c -s 'article'
# 警告:第一個 article 通常是置頂推文,而非最新貼文。
# 您必須向下捲動才能看到實際的近期貼文。
# 3. 向下捲動以載入近期貼文(越過置頂推文和個人檔案頁首)
agent-browser scroll down 3000
agent-browser wait 2000
agent-browser snapshot -i -c -s 'article'
# 現在您應該會看到第一篇近期(非置頂)貼文
# 4. 繼續向下捲動以載入更多貼文 — 視需要重複
agent-browser scroll down 3000
agent-browser wait 2000
agent-browser snapshot -i -c -s 'article'
驗證:
# 標題應包含 "<DisplayName> (@<username>) / X"
agent-browser get title
# URL 應為 https://x.com/<username>
agent-browser get url
關鍵模式 — 瀏覽多則貼文:
# 若要從使用者的個人檔案瀏覽 N 則貼文,請使用此捲動迴圈:
# 每個 scroll+wait 週期由於虛擬化清單,約會顯示 1 則新貼文
for i in $(seq 1 N); do
agent-browser scroll down 3000
sleep 2 # 或:agent-browser wait 2000
agent-browser snapshot -i -c -s 'article'
# 處理可見的 article(s)
done
已知問題:
- 重要:初始頁面檢視通常只顯示置頂推文。您必須向下捲動才能看到近期貼文。 代理常常錯誤地認為置頂推文是唯一內容。
- X 使用虛擬化清單 — 視埠中通常只有 1-2 個 article 存在於 DOM 中。已捲過的文章會從 DOM 中移除。
- 捲動 3000 像素 + 等待 2 秒可可靠地載入下一批內容
- 置頂推文在其 article 描述的開頭會有文字
"置頂"— 使用此標記來識別並跳過它 - 個人檔案有分頁:貼文、回覆、精選、媒體、喜歡 — 預設為「貼文」,其排除回覆。使用
https://x.com/<username>/with_replies可查看貼文 + 回覆。
1.5 閱讀推文串 / 回覆
目標:開啟一則推文,閱讀完整的推文串及其下方的回覆。
前置條件:擁有推文網址。
步驟:
# 1. 開啟推文
agent-browser open "https://x.com/<username>/status/<tweet_id>"
# 2. 向下捲動以載入回覆
agent-browser scroll down 800
# 3. 讀取回覆(它們會以主要推文下方的額外 article 元素形式出現)
agent-browser snapshot -i -c -s 'article'
驗證:
# 應出現多個 article 元素 — 第一個是主要推文,其餘是回覆
agent-browser snapshot -i -c -s 'article'
已知問題:
- 回覆可能分頁 — 尋找
button "顯示更多回覆"並點擊它 - 可能會出現「顯示可能的垃圾內容」區塊 — 跳過它
- 推文串上下文(父推文)會出現在主要推文上方
- 引用推文點擊陷阱:如果回覆或時間軸條目是引用推文,點擊文章本體會導航到被引用的原始貼文,而不是引用推文的詳細頁面。若要導航到正確的推文,請改為點擊時間戳記連結。完整細節請參閱第 3.4 節的已知問題。
1.6 閱讀通知
目標:開啟通知分頁並閱讀近期通知。
前置條件:已登入。
步驟:
agent-browser open https://x.com/notifications
驗證:
# 標題應包含 "通知 / X"
agent-browser get title
# URL 應為 https://x.com/notifications
agent-browser get url
關鍵元素:
- 通知分頁:全部、已驗證、提及
- 側邊欄連結顯示未讀數量:
link "通知 (未讀通知數 N)"
已知問題:
- 通知有子分頁:全部、已驗證、提及
1.7 閱讀直接訊息 (DM)
目標:開啟 DM 並閱讀近期訊息。
前置條件:已登入。
步驟:
# 注意:/messages 會重新導向至 /i/chat
agent-browser open https://x.com/messages
驗證:
# URL 將變為 https://x.com/i/chat(自動重新導向)
agent-browser get url
已知問題:
- URL 從
/messages重新導向至/i/chat - DM UI 根據視埠大小可能是側邊面板或全頁面
- 某些 DM 功能可能需要 X Premium
2. 互動 — 對內容做出反應
2.1 喜歡一則推文
目標:喜歡特定的推文。
前置條件:位於推文可見的頁面上(時間軸、推文詳細頁、搜尋結果)。
步驟:
# 1. 快照以找到目標推文的喜歡按鈕
agent-browser snapshot -i -c -s 'article'
# 尋找:button "N 個讚。喜歡"(尚未喜歡)在目標 article 內
# 2. 點擊喜歡按鈕
agent-browser click <like_button_ref>
驗證:
# 再次快照 — 按鈕文字應從 "喜歡" 變為 "已喜歡"
agent-browser snapshot -i -c -s 'article'
# 尋找:button "N 個讚。已喜歡"
元素識別:
- 尚未喜歡:
button "N 個讚。喜歡"— 文字以. 喜歡結尾 - 已喜歡:
button "N 個讚。已喜歡"— 文字以. 已喜歡結尾 - 喜歡數 N 在喜歡後會增加 1
已知問題:
- 速率限制:X 可能會限制快速連續的喜歡動作
- 按鈕參照可能在狀態改變後改變(重新快照以取得新參照)
2.2 取消喜歡推文
目標:移除先前已喜歡的推文。
前置條件:推文已被喜歡。
步驟:
# 1. 快照以找到已喜歡的按鈕
agent-browser snapshot -i -c -s 'article'
# 尋找:button "N 個讚。已喜歡"
# 2. 點擊同一個按鈕以取消喜歡
agent-browser click <liked_button_ref>
驗證:
# 按鈕文字應從 "已喜歡" 變回 "喜歡"
agent-browser snapshot -i -c -s 'article'
# 尋找:button "N 個讚。喜歡"
元素識別:
- 同一個按鈕在喜歡/已喜歡狀態間切換
- 參照可能在狀態之間改變 — 務必重新快照
已知問題:
- 無
2.3 轉推 (Repost)
目標:將推文轉貼到自己的時間軸。
前置條件:位於推文可見的頁面上。
步驟:
# 1. 快照以找到轉貼按鈕
agent-browser snapshot -i -c -s 'article'
# 尋找:button "N 次轉貼。轉貼" [expanded=false]
# 2. 點擊轉貼按鈕 — 這會開啟一個下拉式選單,而非直接執行動作
agent-browser click <repost_button_ref>
# 3. 快照以查看下拉式選單項目
agent-browser snapshot -i -c -s '[role="menuitem"]'
# 顯示:menuitem "轉貼" 和 menuitem "引用"
# 4. 點擊 "轉貼" 選單項目以執行轉貼
agent-browser click <repost_menuitem_ref>
驗證:
# 快照 — 按鈕文字應從 "轉貼" 變為 "已轉貼"
agent-browser snapshot -i -c -s 'article'
元素識別:
- 轉貼按鈕:
button "N 次轉貼。轉貼" [expanded=false] - 下拉式選單項目:
menuitem "轉貼"和menuitem "引用" - 轉貼後:按鈕變成
button "N 次轉貼。已轉貼"
已知問題:
- 兩步驟操作:點擊按鈕會開啟一個下拉式選單,您必須接著點擊選單項目
- 若要取消/關閉下拉式選單而不執行動作:
…
[後續內容因長度限制已截斷]