Communitygithub.com

LocoreMind/locoagent

X.com (Twitter) 平台操作手冊,專為 agent-browser 設計。涵蓋瀏覽、互動、內容創作、社交圖譜、個人檔案、導航和清單操作,提供經過測試的逐步 agent-browser 指令。

locoagent 是什麼?

這項技能提供了一個完整且經過測試的操作手冊,專為在 X.com (Twitter) 平台上使用 agent-browser 而設計。它詳細說明了從瀏覽時間軸、互動(按讚、轉推)、內容創作(發文、回覆、引用推文)到社交圖譜管理(追蹤/取消追蹤)、個人檔案編輯和清單操作等所有核心功能的逐步指令。每個操作都明確記錄了前置條件、具體的 agent-browser 指令、驗證方法以及已知的陷阱,確保 AI 代理能夠可靠地執行任務。此技能已在 agent-browser 0.24.0 版本上進行了完整測試,並適用於桌面版 Chrome,同時也提供了針對行動版網頁的設定方式。對於希望自動化 X.com 上任何社交媒體操作的開發者或 AI 代理使用者來說,這是一個不可或缺的參考資源。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LocoreMind/locoagent/tree/HEAD/skills/x-com

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 "清單"
  • f URL 參數控制分頁:省略 = 熱門、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 次轉貼。已轉貼"

已知問題:

  • 兩步驟操作:點擊按鈕會開啟一個下拉式選單,您必須接著點擊選單項目
  • 若要取消/關閉下拉式選單而不執行動作:

…

[後續內容因長度限制已截斷]

相關技能