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

流程

Step 1: 确定搜索关键词

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

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

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

Step 2: 初始化浏览器环境

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

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

bu() { ALL_PROXY= HTTP_PROXY= HTTPS_PROXY= http_proxy= https_proxy= all_proxy= browser-use "$@"; }

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

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

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 并启动

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: 逐个关键词搜索

对每个关键词执行：

# 导航到搜索页
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 分块，从每块中收集上述字段。

滚动加载更多（可选）:

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

切换到"最新"标签:

从 state 中找到 最新 的索引号，然后：

bu click {索引号} && sleep 3 && bu state 2>&1

搜索下一个关键词

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

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 正常加载）。

恢复策略：

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

Step 4: 降级方案 — fxtwitter API

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

# 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 会话：

bu close 2>/dev/null

Step 6: 汇总去重

将所有搜索结果合并：

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

Step 7: 输出结构化报告

# Twitter {话题} 热门内容汇总（{日期}）
搜索关键词：{关键词1}、{关键词2}、...
数据来源：Twitter/X 热门 + 最新
采集方式：Browser Use CLI / fxtwitter API
采集时间：{时间}
一、{主题分类1}
1. {推文标题/摘要}
作者: {display_name} (@{handle}) | 时间: {time} | 互动: {likes} likes, {retweets} RT, {views} views
{推文正文}
要点: {一句话总结}
关键趋势总结
趋势1: {描述}
...
值得关注的项目/工具
项目名
类型
一句话描述
推荐来源
...
...
...
@handle

常见问题排查