Twitter 完整工作流

自动采集 Twitter 搜索结果，输出推文链接列表，可直接粘贴到筛选网页进行人工筛选。

使用场景

当你希望自动批量获取符合特定搜索参数的推文链接，而不是手动在浏览器中搜索和复制链接时使用。

使用方式

方式 A：MCP 驱动模式（推荐，免配置）

直接指令 AI 执行采集。AI 会自动调用内置的 browser 技能，同步您的 Profile 并处理所有搜索逻辑。

优点：无需手动启动 Chrome 调试端口，全自动化。
指令示例：@twitter-collector 执行下，使用 nano-banana-pro 预设。

方式 B：本地脚本模式（需开启调试端口）

如果您希望在本地终端手动运行：

启动 Chrome 调试端口：

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

运行脚本：

node scripts/collector.js --preset nano-banana-pro --output preview

工作流程

基于搜索参数访问 Twitter 搜索页面
自动滚动加载更多推文
提取推文链接和基础信息
去重和简单过滤
输出链接列表（每行一个链接）或预览 HTML

快速开始

前置要求

npm install playwright
npx playwright install chromium

运行方式

# 基础使用（默认搜索参数）
node scripts/collector.js

# 自定义搜索参数
node scripts/collector.js --query "你的关键词" --since "24h"

# 生成可视化预览页面
node scripts/collector.js --preset nano-banana-pro --output preview

# 从筛选页导出完整文本（基于第三方解析）
node scripts/collector.js --preset nano-banana-pro --output filter-json

可用参数

--query: 搜索关键词（支持 AND/OR 逻辑）
--since: 时间范围（24h、7d、30d）
--min-likes: 最小点赞数
--max-tweets: 最大采集数量（默认 100）
--exclude: 排除关键词（空格分隔）
--filter-content: 内容类型过滤（media、videos、images）
--exclude-replies: 排除回复
--exclude-retweets: 排除转发
--score-keywords: 评分关键词（逗号分隔）
--min-score: 最低评分阈值（0-1）
--output: 输出格式（console/file/preview/filter-json）
--filter-url: 筛选页地址
--output-dir: 输出目录

预设搜索参数

内置预设搜索配置，直接使用插件中的搜索参数：

Nano Banana Pro

默认搜索参数（来自你的插件配置）：

#NanoBananaPro OR #NanoBanana OR "Nano Banana" OR "prompt"
AND -female -woman -hair -GEMINIFOURTH
since_time:{{NOW-24h}}
min_faves:50
filter:media
-filter:replies

说明：

关键词：Nano Banana Pro 相关 + prompt
排除：女性相关、GEMINIFOURTH
时间：最近 24 小时
最小点赞：50
内容：包含媒体
排除：回复

输出格式

链接列表格式

输出为纯文本，每行一个链接：

https://x.com/username/status/1234567890
https://x.com/username/status/1234567891
https://x.com/username/status/1234567892

使用方法：

复制输出内容
粘贴到筛选网页（https://twitterhot.vercel.app/tweet-filter.html）
继续你现有的筛选流程

输出统计

运行结束后显示：

✅ 采集完成
📊 总计: 100 条
✅ 去重后: 95 条
🔗 链接已输出到控制台

技术实现

核心逻辑

搜索页面导航
- 构建完整的 Twitter 搜索 URL
- 支持时间变量（{{NOW-24h}}）
自动滚动采集
- 模拟人工滚动行为
- 等待内容加载
- 停止条件：达到最大数量或到底部
推文提取
- 选择器：article[data-testid="tweet"]
- 提取：URL、ID、文本、点赞数
去重机制
- 基于推文 ID
- Set 数据结构去重
输出处理
- 统一 URL 格式（https://x.com/...）
- 每行一个链接
- 可选：保存到文件

示例输出

$ node scripts/collector.js --preset "nano-banana-pro"

🔍 搜索参数：
#NanoBananaPro OR #NanoBanana OR "Nano Banana" OR "prompt"
AND -female -woman -hair -GEMINIFOURTH
since_time:{{NOW-24h}}
min_faves:50
filter:media
-filter:replies

📊 采集进度: ████████████████ 100/100
✅ 采集完成
📊 总计: 100 条
✅ 去重后: 95 条
🔗 链接列表:

https://x.com/username1/status/1234567890
https://x.com/username2/status/1234567891
https://x.com/username3/status/1234567892
...

优势

零配置：内置搜索参数，开箱即用
完全自动化：无需手动操作浏览器
兼容现有流程：输出格式直接适配你的筛选网页
可扩展：支持自定义搜索参数
轻量：基于 Node.js + Playwright，无需额外依赖

twitter-collector