Twitter/X 话题搜索与汇总

通过 Browser Use CLI 操控真实 Chrome 搜索 Twitter/X，抓取热门推文并汇总成结构化报告。如果 browser-use 不可用则降级到 fxtwitter API。

流程

Step 1: 确定搜索关键词

根据用户给的话题，生成 3-5 组搜索关键词：

1. 1. 核心关键词: 用户原始话题（如 AI Agent）
2. 细分关键词: 话题 + 限定词（如 AI Agent framework 2026）
3. 关联产品/项目: 热门项目名（如 Claude Code、Cursor）
4. 中英文双搜: 同一话题分别用中文和英文搜索

告诉用户关键词列表后开始执行。

Step 2: 初始化浏览器环境

2a. 定义 wrapper 函数（消除代理干扰）

系统 SOCKS/HTTP 代理会破坏 browser-use 的 CDP 连接，必须清除。在 session 开始时定义一次：

bash
bu() { ALLPROXY= HTTPPROXY= HTTPSPROXY= httpproxy= httpsproxy= allproxy= browser-use $@; }

后续所有 browser-use 调用改用 bu。

2b. 检测并自动安装 browser-use

bash
if ! which browser-use &>/dev/null; then
echo INSTALLING browser-use...
uv tool install browser-use && browser-use install
fi

验证

which browser-use &>/dev/null && echo READY || echo INSTALL_FAILED

注意: 安装方式必须是 uv tool install browser-use。curl install.sh 只装 cookie 同步工具 profile-use，不是浏览器自动化 CLI。

2c. 清理旧 session 并启动

bash
bu close 2>/dev/null; sleep 1
bu -b real open https://x.com 2>&1

如果报 CDP connection 错误，说明代理变量没清干净或 Chrome 未运行。-b real 需要本机 Chrome 已启动且已登录 Twitter。

Step 3: 逐个关键词搜索

对每个关键词执行：

bash

导航到搜索页

bu open https://x.com/search?q={URL编码的关键词}&src=typed_query&f=top
sleep 3

获取热门标签内容

bu state 2>&1

解析 state 输出的方法:

state 返回 accessibility tree，推文结构如下：

• -
  — 每条推文的容器
• 内含作者名 — 如 阿绎 AYi
• @handle — 紧跟作者名后面
• — 发布时间
• 连续多个 — 推文正文（被拆成多段）
• — 互动数据汇总

提取时按 article 分块，从每块中收集上述字段。

滚动加载更多（可选）:

bash
bu scroll down && sleep 2 && bu state 2>&1

切换到最新标签:

从 state 中找到 最新 的索引号，然后：
bash
bu click {索引号} && sleep 3 && bu state 2>&1

搜索下一个关键词

直接导航到新 URL（不要用搜索框填充，容易出错）：

bash
sleep 8 # Twitter 搜索限速间隔，不能低于 8 秒
bu open https://x.com/search?q={下一个关键词}&src=typed_query&f=top
sleep 3
bu state 2>&1

限速防护（关键！）

Twitter 搜索限速非常严格。每次搜索之间必须间隔 8-10 秒，否则搜索结果会一直转圈加载不出来。

症状识别：页面能显示搜索框和标签栏，但内容区域持续转圈（主页 /home 正常加载）。

恢复策略：

1. 1. 停止搜索，等待 2-3 分钟让限速解除
2. 先访问主页 bu open https://x.com/home 验证网络正常
3. 再尝试搜索简单词（如 hello）验证搜索功能恢复
4. 恢复后继续，但加大间隔到 10 秒
5. 如果 5 分钟后仍无法搜索，降级到方式 B

Step 4: 降级方案 — fxtwitter API

如果 browser-use 不可用、未安装、或被 Twitter 限速：

bash

1. 用 WebSearch 搜索（在 skill 中调用 WebSearch 工具）

query: {关键词} site:x.com 或 {关键词} Twitter

2. 从搜索结果提取推文 URL，用 fxtwitter API 获取详情

URL 格式: https://x.com/{username}/status/{tweet_id}

curl -s https://api.fxtwitter.com/{username}/status/{tweet_id}

3. fxtwitter 不可用时尝试 vxtwitter

curl -s https://api.vxtwitter.com/{username}/status/{tweet_id}

Step 5: 清理

搜索结束后关闭 browser-use 会话：

bash
bu close 2>/dev/null

Step 6: 汇总去重

将所有搜索结果合并：

• - 去重: 按推文 URL 去重（同一条可能在多个关键词下出现）
• 排序: 按互动量（喜欢 + 转帖 + 书签）降序
• 分类: 按话题主题分组

Step 7: 输出结构化报告

markdown

Twitter {话题} 热门内容汇总（{日期}）

搜索关键词：{关键词1}、{关键词2}、...
数据来源：Twitter/X 热门 + 最新
采集方式：Browser Use CLI / fxtwitter API
采集时间：{时间}

---

一、{主题分类1}

1. {推文标题/摘要}

作者: {display_name} (@{handle}) | 时间: {time} | 互动: {likes} likes, {retweets} RT, {views} views

{推文正文}

要点: {一句话总结}

---

关键趋势总结

• - 趋势1: {描述}
• ...

值得关注的项目/工具

项目名	类型	一句话描述	推荐来源
...	...	...	@handle

常见问题排查

症状	原因	解决
socksio package not installed	系统 SOCKS 代理干扰 CDP	用 bu() wrapper 清除 CLI 进程的代理（Chrome 自身走系统代理，不受影响）
CDP connection: invalid HTTP response

旧 session 残留 | bu close 后重试 | | Browser startup timeout | Chromium 未安装 | browser-use install | | state 只有空 div | 无登录态（Chromium 模式） | 用 -b real 复用真实 Chrome 登录态 | | 搜索页持续转圈，主页正常 | Twitter 搜索限速（最常见） | 等 2-3 分钟恢复，加大间隔到 10 秒 | | curl install.sh 没装到 browser-use | 那个脚本只装 profile-use | 用 uv tool install browser-use | | -b real 模式需要配代理吗？ | 不需要 | Chrome 自己走系统代理，bu() 只清 CLI 进程的代理 |