第48篇：X 搜索——推特数据抓取

這篇帶你搞懂 Hermes Agent 的「X 搜尋」功能：讓 AI 直接幫你搜推特上的熱門討論、網友反應和具體貼文，並附上原文連結。

它和普通搜尋有啥不一樣？

你可以把 web_search 想成「百度」，而 x_search 是「微博進階搜尋」——專門搜推特上的內容。當你想知道「X 上大家怎麼評價某個新功能」，用它就對了；查普通網頁還是用原來的搜尋工具。

第1步：先有「門票」（認證）

x_search 需要 xAI 的憑證才能用，兩種方式任選其一：

• SuperGrok / X Premium+ 帳號（推薦）：用瀏覽器登入 accounts.x.ai 授權，指令是 hermes auth add xai-oauth
• API 金鑰：在 ~/.hermes/.env 裡設定 XAI_API_KEY

兩個都配了的話，優先使用 OAuth，這樣走訂閱配額，不額外花錢。

第2步：確認工具已開啟

執行 hermes tools，看到 🐦 X (Twitter) Search 是勾選狀態就行。沒勾就按空白鍵開啟。

第3步：設定（可選）

預設設定就夠用，想微調可以編輯 ~/.hermes/config.yaml：

x_search:
  model: grok-4.5        # 建議使用這個模型
  timeout_seconds: 180   # 複雜查詢可能要等 1-2 分鐘
  retries: 2             # 失敗自動重試

第4步：開始搜尋

直接跟 AI 說人話就行，例如：

大家在新 Grok 影像功能上說了啥？只看 @xai 的回覆。

AI 會自動呼叫 x_search，參數包括：

• query（必填）：搜什麼
• allowed_x_handles：只看某些帳號（最多10個）
• excluded_x_handles：排除某些帳號
• from_date / to_date：限定日期範圍
• enable_image_understanding：讓 AI 分析貼文裡的圖片

回傳結果裡有 Grok 總結的答案 + 原始推文連結，方便你點進去核實。

注意：搜尋 ≠ 發文

x_search 只能「看」，不能「發」。如果你想按讚、回覆或發推，得切換到 xurl 工具（下篇會講）。任何改變帳號狀態的操作，都必須用 xurl 確認，x_search 的結果不能證明操作成功。

常見坑

• 提示「無憑證」：重新執行 hermes auth add xai-oauth 或檢查 .env
• 回傳 degraded: true：表示沒搜到相符的貼文，答案是 AI 憑記憶編的，別當真。先檢查帳號名有沒有拼錯、日期範圍是不是太窄
• 工具不顯示：跑一下 hermes auth status 看憑證狀態

---

總結：x_search 是 Hermes 的「推特偵察兵」，幫你快速了解 X 上的輿論風向，但記住它唯讀不寫。搭配 xurl 才能完成完整操作。

下篇預告：第49篇將深入 xurl——如何用 Hermes 發推、按讚、私訊，敬請期待！