第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 发推、点赞、私信，敬请期待！