# twitter-search

> 搜索 Twitter (X) 上的推文。

- Author: JKJoker
- Repository: Mr-funny/twitter-search-skills
- Version: 20260126182641
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/Mr-funny/twitter-search-skills
- Web: https://mule.run/skillshub/@@Mr-funny/twitter-search-skills~twitter-search:20260126182641

---

---
name: twitter-search
description: 搜索 Twitter (X) 上的推文。
---

# Twitter Search Skill

独立的 Twitter/X 检索工具。依赖真实 Chrome + Rettiwt-API，通过同一份登录 Cookie 完成搜索，并为后续子 Agent/其它技能提供素材。

## 初始化（首次操作必读）

1. **安装依赖**
   ```bash
   cd .claude/skills/twitter-search
   npm install
   ```
2. **准备登录会话**
   ```bash
   cd .claude/skills/twitter-search && X_BROWSER_HEADLESS=false node scripts/get-cookie.js
   ```
   - 默认使用技能目录内的 `.local-chrome-profile`，不会复用系统全局登录。
   - 如需与其它工具共享，可显式设置 `X_BROWSER_PROFILE_DIR=/path/to/profile`。
   - 登录成功后会生成两个文件：
     - `cookies.json`：JSON 格式，供 `scripts/search.js` 自动读取
     - `cookie_output.txt`：Base64 编码，方便手动复制使用

> 若 `TWITTER_COOKIE` 环境变量已存在，可直接跳过登录步骤。

## references
- `references/rettiwt-search.md`：Rettiwt 查询语法、常用命令、故障提示。
- `references/search-modes.md`：各种搜索模式的参数详解。
- `references/tweet-filter-reference.md`：TweetFilter 完整参数参考。

---

## 高频常用模式

最常用的三种搜索方式：

| 场景 | 命令 |
|------|------|
| 搜关键词 | `cd .claude/skills/twitter-search && node scripts/search.js --query "AI" --count 10` |
| 搜热门 | `cd .claude/skills/twitter-search && node scripts/search-trending.js --query "AI" --count 10` |
| 搜用户 | `cd .claude/skills/twitter-search && node scripts/search-user.js --user "elonmusk" --count 10` |

> 需要其他搜索方式？查看下方完整列表

---

## 不知道用哪个模式？

回答几个问题帮你选择合适的搜索脚本：

| 你想搜... | 使用脚本 |
|----------|----------|
| **关键词**（如 "AI"、"tech"） | `search.js` |
| **热门/火的**内容 | `search-trending.js` |
| **某人发的**推文 | `search-user.js` |
| **带话题标签**的推文（如 #AI） | `search-hashtag.js` |
| **高点赞**的推文 | `search-viral.js` |
| **含链接**的推文 | `search-links.js` |
| **提及某人**的推文 | `search-mentions.js` |
| **回复给某人**的推文 | `search-replies.js` |
| **仅原创**（排除转发） | `search-original.js` |

> 需要更复杂的搜索（如组合多个条件）？查看 [进阶使用](#进阶使用) 或 [详细参数](references/search-modes.md)

---

## 使用方式

### A. 快速检索（search.js）
```bash
cd .claude/skills/twitter-search && node scripts/search.js --query "OpenAI" --count 5
```
参数：
- `--query/-q`（必填）：关键字或 Twitter 原生查询语法
- `--count/-n`：返回条数（默认 20，最大 20）
- `--auth/-k`：可直接传 Cookie；否则自动读取 `cookies.json` 或 `TWITTER_COOKIE`

### B. 自动化工作流（workflow.js）
`workflow.js` 会串联"依赖检查 → 登录校验 → 搜索 → 落盘结果"，并默认使用技能目录内的独立 Chrome profile。

```bash
cd .claude/skills/twitter-search && node scripts/workflow.js --query "AI policy" --count 8
```

生成内容：
- `runs/<timestamp>_<query>/results.json|txt`：推文原始数据与可读摘要
- 后续若需要子 Agent / 发布，可直接基于 `results.txt` 再处理

`workflow.js` **不会** 调用其它技能，确保 search 完全独立。

---

## 完整模式列表

所有可用的搜索模式及命令示例：

| 用户意图 | 使用脚本 | 命令示例 |
|---------|---------|----------|
| 搜索关键词 | search.js | `cd .claude/skills/twitter-search && node scripts/search.js --query "AI"` |
| 搜索热门推文 | search-trending.js | `cd .claude/skills/twitter-search && node scripts/search-trending.js --query "AI"` |
| 查看用户时间线 | search-user.js | `cd .claude/skills/twitter-search && node scripts/search-user.js --user "elonmusk"` |
| 监控标签推文 | search-hashtag.js | `cd .claude/skills/twitter-search && node scripts/search-hashtag.js --tag "AI"` |
| 查看谁提及了某人 | search-mentions.js | `cd .claude/skills/twitter-search && node scripts/search-mentions.js --user "openai"` |
| 查看回复推文 | search-replies.js | `cd .claude/skills/twitter-search && node scripts/search-replies.js --to "user"` |
| 查找高互动推文 | search-viral.js | `cd .claude/skills/twitter-search && node scripts/search-viral.js --min-likes 10000` |
| 仅看原创推文 | search-original.js | `cd .claude/skills/twitter-search && node scripts/search-original.js --query "AI"` |
| 仅收集带链接推文 | search-links.js | `cd .claude/skills/twitter-search && node scripts/search-links.js --query "AI"` |

---

## 进阶使用

### 自定义搜索参数

所有脚本都支持 `--count` 参数（最大 20）

部分脚本支持额外的自定义参数，例如：

```bash
# 高互动推文 - 可指定点赞数下限
cd .claude/skills/twitter-search && node scripts/search-viral.js --min-likes 1000 --query "AI" --count 10

# 含链接推文 - 可选关键词
cd .claude/skills/twitter-search && node scripts/search-links.js --query "tech" --count 10
cd .claude/skills/twitter-search && node scripts/search-links.js --count 10  # 所有含链接推文
```

### 组合多个条件？

想搜索"某用户的热门原创推文"这类组合条件？

当前脚本专注于单一场景，组合多个条件需要直接修改 TweetFilter 参数。
详见 [参数组合示例](references/search-modes.md#参数组合示例)

---

## 故障排查

| 错误类型 | 快速解决 |
|----------|----------|
| 依赖未安装 | 重新运行 `npm install` |
| 401/403 | Cookie 过期，重新运行 `get-cookie.js` |
| Chrome 未启动 | 确认本地安装 Chrome，可设置 `X_BROWSER_CHROME_PATH` |
| Profile 无写权限 | 设置 `X_BROWSER_PROFILE_DIR` 指向可写目录 |
| 其他错误 | 查看 [详细排查](references/rettiwt-search.md#9-常见错误与处理) |