Claude Skill

twitter-work-search

输入关键词搜索X(Twitter)作品，支持按热门、最新、媒体、用户、列表五种类型精准筛选，一键获取作品正文、互动数据、媒体附件与作者信息等结构化结果。触发词：当用户提到'X搜索'、'Twitter搜索'、'作品搜索'、'X关键词搜索'、'搜一下X上的'时使用

LLM Mart · 0 points · 0 0 0

Virus-scanned Reviewed automatically before listing.

Full trust report

Download redfox-data-redfox-community-skills_twitter-work-search-5e7b435.zip · 10 KB

redfox-data/redfox-community 413 55 forks Updated 2d ago

Part of redfox-data/redfox-community — 66 skills

Install

skills CLI npx skills add https://github.com/redfox-data/redfox-community/tree/main/skills/twitter-work-search

Claude Code

claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install redfox-data-redfox-community@llmmart

Git git clone https://github.com/redfox-data/redfox-community.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole redfox-data/redfox-community collection as a plugin from our marketplace. Git is the plain clone.

README

X(Twitter)作品搜索 / twitter-work-search

简介

在 X 平台按关键词一键精准检索作品，支持热门、最新、图片视频等多种搜索模式，输出推文正文、互动数据、媒体附件和作者信息，为舆情分析、市场调研和内容运营提供数据支撑。

核心价值

🔍 精准检索：输入关键词即可秒级获取 X 平台相关内容，告别手动浏览
📊 数据全面：点赞、转发、回复、浏览等全维度互动指标一站到位
🎯 模式灵活：热门 / 最新 / 媒体 / 用户 / 列表五种搜索视角自由切换
🧠 智能体验：口语化表达即可触发搜索，自动翻页无需手动操作

适用对象

📱 运营人员 — 快速追踪话题热度趋势，掌握一手舆情动态
📈 市场团队 — 分析竞品在 X 平台的声量与用户反馈
🏷️ 品牌方 — 监控品牌提及情况，及时发现传播机会与风险
✍️ 内容创作者 — 寻找灵感素材，了解海外热门话题走向

功能特性

核心功能

关键词智能搜索：输入任意关键词，一键检索 X 平台推文、用户和列表
五种搜索模式：热门排序、最新发布、图片视频筛选、精准找人、列表聚合，覆盖全部搜索意图
推文详情提取：自动获取正文、点赞、转发、回复、收藏、浏览等全维度数据
媒体附件获取：自动提取推文中的图片封面和视频播放地址，支持多清晰度
作者画像展示：同步展示作者昵称、粉丝数、认证状态、所在地等信息
智能分页翻页：自动处理翻页逻辑，数据量大也不遗漏

使用指南

直接用自然语言描述需求，无需记忆命令。

用户：搜一下 X 上关于"AI"的热门推文

助手：为你找到 20 条关于"AI"的热门推文，按热度排序如下...

用户：看看"苹果发布会"的最新讨论

助手：为你找到关于"苹果发布会"的最新推文，共 20 条...

用户：继续看下一页

助手：已加载下一页，继续为你展示更多推文...

常用说法速查

意图	示例话术	效果
热门内容	"搜一下 X 上关于特斯拉的热门内容"	按综合热度排序
最新动态	"看看比特币的最新讨论"	按发布时间倒序
图片视频	"找一下巴黎奥运相关的图片和视频"	筛选含媒体的推文
找人	"在 X 上搜一下做 AI 的账号"	搜索相关用户
查列表	"搜一下科技类的列表"	搜索相关列表
翻页	"下一页""继续""还有吗"	加载更多推文

使用场景

场景	角色	示例问法	收益
话题热度追踪	运营人员	"看看今天关于 ChatGPT 的最新讨论"	掌握热点走向，及时跟进内容策略
竞品动态分析	市场团队	"搜一下竞品品牌最近有什么新动态"	了解竞品声量变化，辅助决策
品牌舆情监控	品牌方	"搜一下我们品牌在 X 上的讨论"	快速发现正面/负面舆情
内容灵感挖掘	内容创作者	"搜一下 AI 绘画相关的热门推文"	获取海外内容趋势，激发创作灵感

Skill manifest

X(Twitter)作品搜索

📝 简介

X(Twitter)作品搜索工具，帮你快速在 X 平台按关键词精准检索作品。支持热门排序、最新发布、图片视频筛选等多种搜索模式，输出作品正文、点赞转发等互动指标、媒体附件详情及作者画像，为舆情分析、市场调研和内容运营提供数据支撑。

适用场景：运营人员追踪话题热度趋势、市场团队分析竞品动态、品牌方监控舆情声量、内容创作者寻找灵感素材。

✨ 功能特性

核心功能

功能模块	能力描述	核心价值
关键词智能搜索	输入任意关键词，一键检索 X 平台相关推文	告别手动浏览，秒级获取目标内容
五种搜索模式	支持热门、最新、媒体、用户、列表五种筛选方式	按需切换视角，精准定位所需内容
推文详情提取	自动提取正文、点赞、转发、回复、收藏、浏览等全维度数据	数据全面，分析有据可依
媒体附件获取	自动提取推文中的图片封面和视频播放地址	内容素材一键获取，支持多清晰度
作者画像展示	同步展示作者昵称、粉丝数、认证状态、所在地等信息	快速评估信源质量与影响力
智能分页翻页	自动处理分页逻辑，支持连续翻页获取更多结果	数据量大也不遗漏，翻页无感知

特色亮点

搜索模式自由切换：热门推文、最新动态、图片视频、精准找人、列表聚合，五大模式覆盖所有搜索意图
全维度数据输出：从推文正文到互动数据、从媒体附件到作者画像，一条推文的信息全部到位
操作极简：只需输入关键词，支持口语化表达，自动识别搜索意图并返回结构化结果

📖 使用指南

🔑 鉴权

前往红狐hub 获取 API KEY

配置方式：

在 ~/.openclaw/openclaw.json 中配置
设置环境变量 REDFOX_API_KEY
使用命令行参数 --api-key

基础使用

直接告诉我你想搜索的关键词即可：

用户：搜一下X上关于"AI"的热门推文

助手：为你找到 20 条关于"AI"的热门推文，按热度排序如下...

用户：看看"苹果发布会"的最新讨论

助手：为你找到关于"苹果发布会"的最新推文，共 20 条...

用户：继续看下一页

助手：已加载下一页，继续为你展示更多推文...

支持五种搜索类型，如果不指定，默认按热门搜索：

热门（Top）：综合热度最高的推文
最新（Latest）：按发布时间倒序
媒体（Media）：包含图片或视频的推文
用户（People）：搜索相关用户账号
列表（Lists）：搜索相关列表

常用说法速查

searchType	触发关键词	示例话术
Top（热门）	热门、热度、最火、Top	"搜一下X上关于特斯拉的热门内容"
Latest（最新）	最新、最近、Latest、新发布	"看看比特币的最新讨论"
Media（媒体）	图片、视频、媒体、Media、照片	"找一下巴黎奥运相关的图片和视频"
People（用户）	用户、账号、找人、People、博主	"在X上搜一下做AI的账号"
Lists（列表）	列表、Lists	"搜一下科技类的列表"
—（翻页）	下一页、继续、还有吗	加载更多推文，自动沿用上次的 searchType

🔄 工作流程

接收关键词：从你的消息中提取搜索关键词和搜索类型偏好
验证输入：检查关键词是否有效，搜索类型是否在支持范围内
执行搜索：调用 X 搜索接口，一键获取推文数据
智能翻页：结果满 20 条时自动提示翻页，支持连续查看
结构化输出：将推文数据整理为易读的表格，包含正文、互动指标、推文链接和作者信息，媒体附件以图标标记

完整执行流程详见 references/core_workflow.md

接口参数与数据结构详情见 references/core_workflow.md

❓ 常见问答

使用相关

Q：支持搜索哪些内容？ A：支持按关键词搜索 X 平台的推文、用户和列表，覆盖正文、图片、视频等全部内容类型。

Q：搜索类型怎么选？ A：想看热度高的选"热门"，想看最新动态选"最新"，只想看图片视频选"媒体"，找人搜账号选"用户"，查列表选"列表"。不指定时默认热门排序。

Q：一次能看多少条推文？ A：每次返回最多 20 条，如果结果超过一页，会自动提示你翻页继续查看。

Q：可以搜非中文关键词吗？ A：可以，支持任意语言的关键词搜索。

Q：搜索结果包含哪些信息？ A：每条推文包含正文、发布时间、点赞/转发/回复/收藏/浏览等互动数据、图片封面和视频地址、以及作者昵称、粉丝数、认证状态等用户信息。

故障排除

Q：搜索返回"未找到相关推文"？ A：尝试更通用的关键词、减少限定词，或更换搜索类型（如从热门改为最新）。

Q：提示 API Key 无效？ A：请前往红狐hub 检查 API Key 是否正确配置，确保密钥有效且未过期。

Q：翻页提示不出现了？ A：只有当搜索结果满 20 条时才会出现翻页提示，不足 20 条说明已经是最后一页。

📚 参考文档

详细执行工作流：references/core_workflow.md

Files (redfox-community)

references

core_workflow.md 9.3 KB

# X(Twitter)作品搜索 - 执行工作流

## Step 0: 鉴权前置检查

1. 检查用户是否已配置 API Key（环境变量 `REDFOX_API_KEY` 或 `~/.openclaw/openclaw.json` 中配置）
2. 未配置 → 引导用户前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取并配置：
   ```
   ⚠️ 未检测到 API Key，请先完成鉴权：
   1. 前往 https://redfox.hk/settings/api-keys?source=github 获取 API Key
   2. 设置环境变量 REDFOX_API_KEY 或在 ~/.openclaw/openclaw.json 中配置
   3. 配置完成后重新发起搜索
   ```
3. 已配置 → 进入 Step 1

---

## Step 1: 解析用户输入

### 1.1 提取搜索参数

从用户消息中提取以下信息：

| 字段 | 提取规则 | 默认值 |
|------|---------|--------|
| keyword | 用户消息中的搜索关键词，去除非关键词的废话 | 必需，缺失则追问 |
| searchType | 根据语义识别：热门/Top → `"Top"`，最新/Latest → `"Latest"`，图片/视频/媒体 → `"Media"`，用户/找人/账号 → `"People"`，列表 → `"Lists"` | `"Top"` |
| cursor | 用户提到"下一页""继续""还有吗"时，使用上次返回的 nextCursor | `null`（首次搜索） |

### 1.2 searchType 语义映射表

| 用户表述（部分） | 映射值 |
|---------|--------|
| 热门、热度、最火、Top | `"Top"` |
| 最新、最近、Latest、新发布 | `"Latest"` |
| 图片、视频、媒体、Media、照片 | `"Media"` |
| 用户、账号、找人、People、博主 | `"People"` |
| 列表、Lists | `"Lists"` |

### 1.3 输入验证

1. keyword 为空或无实际搜索关键词 → 提示用户：
   ```
   请告诉我你想搜索什么关键词？例如："搜一下X上关于'AI'的推文"
   ```
2. searchType 不在上述 5 种值中 → 默认使用 `"Top"`
3. 用户未指定 searchType → 默认使用 `"Top"`

---

## Step 2: 执行数据采集

> ⛔ 所有接口调用必须在请求体中携带 `source` 字段，值为 `"X(Twitter)作品搜索-GitHub"`

### 2.1 构建请求

**请求头**：
```
Content-Type: application/json
REDFOX_API_KEY: {用户配置的API Key}
```

**请求体**：
```json
{
  "keyword": "{用户输入的关键词}",
  "searchType": "{Top|Latest|Media|People|Lists}",
  "cursor": "{分页游标，首次为null}",
  "source": "X(Twitter)作品搜索-GitHub"
}
```

### 2.2 发送请求

- **接口地址**：`POST https://redfox.hk/story/api/x/search`
- **超时设置**：30 秒
- **重试策略**：失败时重试 1 次

### 2.3 响应处理

检查 `code` 字段：
- `code === 2000` → 请求成功，进入 Step 3
- `code !== 2000` → 请求失败，输出 `msg` 中的错误信息给用户
- 网络错误/超时 → 提示："搜索请求超时，请稍后再试"

---

## Step 3: 数据结构化

### 3.1 字段映射表

| 原始字段 | 输出字段 | 格式转换 |
|---------|---------|---------|
| tweetId | 推文ID | 保持原样 |
| text | 推文正文 | 截取前 80 字，超出加"..." |
| text | 推文链接 | 从 text 中正则提取 `https://t.co/...` 链接，无则显示 "—" |
| createdAt | 发布时间 | 保持原样（如 "Fri May 22 07:45:42 +0000 2026"） |
| language | 语言 | 保持原样 |
| likeCount | 点赞 | 数字格式化（见 3.2） |
| retweetCount | 转发 | 数字格式化 |
| replyCount | 回复 | 数字格式化 |
| quoteCount | 引用 | 数字格式化 |
| bookmarkCount | 收藏 | 数字格式化 |
| viewCount | 浏览 | 数字格式化（原始为字符串，需转数字后格式化） |
| user.displayName | 作者昵称 | 保持原样 |
| user.username | 用户名 | 格式化为 `@username` |
| user.followers | 粉丝数 | 数字格式化 |
| user.verified | 认证 | `true` → "✅"，`false` → 不显示 |
| user.location | 所在地 | 保持原样，空则不显示 |
| medias[].type | 媒体类型 | `video` → "📹 视频"，`photo` → "🖼️ 图片" |
| medias[].coverUrl | 封面图 | 保持原样（可点击链接） |
| medias[].durationMillis | 视频时长 | 毫秒 → 分:秒格式（如 43282ms → "0:43"），图片时为 null 不显示 |
| medias[].variants | 视频地址 | 取最高码率 mp4 的 url 作为视频链接 |

### 3.2 数字格式化规则

```
function formatNumber(num):
  if num == null → "—"
  num = parseInt(num)  // viewCount 可能是字符串
  if num < 10000 → 原数（如 8523）
  if num < 100000000 → num/10000 保留1位小数 + "w"（如 1.5w、92.5w）
  if num >= 100000000 → num/100000000 保留1位小数 + "亿"（如 2.3亿）
```

### 3.3 推文排序

保持接口返回的原始顺序（已按 searchType 排序），不做二次排序。

---

## Step 4: 输出结果

### 4.1 输出格式

**表格前先输出数据说明**：

```
> 💡 数据说明：
> - ✅ 表示该账号已通过 X 平台认证
> - 作者列和推文链接列均为 X 平台外链，境内网络可能无法直接访问
```

所有推文以 Markdown 表格形式展示，每页 20 条，包含以下列：

| # | 推文内容 | 作者 | 推文链接 | 👍 点赞 | 🔁 转发 | 💬 回复 | 👁️ 浏览 | 时间 |
|---|---------|------|---------|---------|---------|---------|---------|------|
| {序号} | {正文前80字}... | [{作者昵称}](https://x.com/{username}) {✅} | [链接]({tcoUrl}) | {likeCount} | {retweetCount} | {replyCount} | {viewCount} | {发布时间短格式} |

**列说明**：
- 推文内容：截取 text 前 80 字，超出加 "..."；含媒体时末尾追加 📹 或 🖼️ 标记
- 作者：显示为可点击的 X 主页链接，认证用户追加 ✅
- 推文链接：从 text 中提取第一个 `https://t.co/...` 短链接，以 Markdown 链接渲染，无则显示 "—"
- 浏览量：`null` 时显示 "—"
- 时间：简化为 `YYYY-MM-DD` 格式（仅日期）
- 数字按 3.2 规则格式化

### 4.2 翻页处理

- 搜索结果返回后，检查 `data.tweets` 数组长度
- **长度为 20** → 在结果末尾展示翻页提示：
  ```
  📄 还有更多推文。回复「下一页」继续查看。
  ```
- **长度 < 20** → 不展示翻页提示，表示已是最后一页
- 翻页时使用 `data.nextCursor` 作为 `cursor` 参数重新请求

### 4.3 未找到数据时的降级逻辑

1. `data.tweets` 为空数组 → 告知用户：
   ```
   未找到与"{keyword}"相关的推文。建议：
   - 尝试更通用的关键词
   - 减少限定词
   - 更换搜索类型（如从"{currentType}"改为其他类型）
   ```
2. 接口返回错误 → 透传 `msg` 内容给用户
3. 网络超时 → 提示"搜索请求超时，请稍候再试"

### 4.4 搜索类型中文显示

在结果开头标注当前使用的搜索类型：
```
🔍 搜索关键词：{keyword}  |  类型：{searchType中文}
```

---

## 接口参考

### 接口地址

| 接口名称 | 请求方式 | 接口地址 |
|---------|---------|----------|
| X(Twitter)搜索 | POST | https://redfox.hk/story/api/x/search |

### 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|---------|------|------|------|
| keyword | string | 是 | 搜索关键字 |
| searchType | string | 否 | 搜索类型，默认 Top。可选：Top（热门）、Latest（最新）、Media（媒体）、People（用户）、Lists（列表） |
| cursor | string | 否 | 分页游标，首次不传，后续从上一次返回结果中获取 |
| source | string | 是 | 接口来源标识，固定值：`"X(Twitter)作品搜索-GitHub"` |

### 响应结构

| 字段名 | 类型 | 说明 |
|---------|------|------|
| code | integer | 响应状态码，2000 表示成功 |
| msg | string | 响应消息 |
| data.nextCursor | string | 下一页游标，用于翻页查询 |
| data.prevCursor | string | 上一页游标 |
| data.tweets | array | 推文列表 |
| data.tweets[].tweetId | string | 推文ID |
| data.tweets[].text | string | 推文正文内容 |
| data.tweets[].createdAt | string | 推文发布时间 |
| data.tweets[].language | string | 推文语言 |
| data.tweets[].likeCount | integer | 点赞数 |
| data.tweets[].retweetCount | integer | 转推数 |
| data.tweets[].replyCount | integer | 回复数 |
| data.tweets[].quoteCount | integer | 引用推文数 |
| data.tweets[].bookmarkCount | integer | 收藏数 |
| data.tweets[].viewCount | string | 浏览量 |
| data.tweets[].username | string | 推文作者用户名 |
| data.tweets[].user.avatar | string | 用户头像URL |
| data.tweets[].user.displayName | string | 用户显示名称 |
| data.tweets[].user.followers | integer | 粉丝数 |
| data.tweets[].user.verified | boolean | 是否已认证 |
| data.tweets[].user.location | string | 用户所在地 |
| data.tweets[].medias | array | 媒体附件列表 |
| data.tweets[].medias[].type | string | 媒体类型：video 或 photo |
| data.tweets[].medias[].coverUrl | string | 媒体封面图URL |
| data.tweets[].medias[].durationMillis | integer | 视频时长（毫秒），图片时为 null |
| data.tweets[].medias[].variants | array | 视频清晰度列表（含播放地址），图片时为空 |

### 数据范围

| 数据类型 | 获取范围 | 说明 |
|---------|---------|------|
| 推文列表 | 每次最多 20 条 | 通过翻页获取更多 |
| 搜索类型 | Top / Latest / Media / People / Lists | 默认 Top 热门排序 |

### 降级处理

当未找到目标数据时：
1. 提示用户"未找到与'{关键词}'相关的推文，请尝试更换关键词或调整搜索类型"
2. 建议用户尝试更通用的关键词、减少限定词或改用其他搜索类型

README.en.md 3.5 KB

# X (Twitter) Post Search / twitter-work-search

---

## Introduction

Search X (Twitter) posts by keyword with one click. Supports multiple search modes — trending, latest, media-rich, and more — delivering tweet content, engagement metrics, media attachments, and author profiles. Ideal for sentiment analysis, market research, and content operations.

**Core Value**

- 🔍 **Precise Search**: Enter a keyword and instantly retrieve relevant X content — no more manual browsing
- 📊 **Comprehensive Data**: Likes, retweets, replies, views — all engagement metrics in one place
- 🎯 **Flexible Modes**: Switch between Trending / Latest / Media / People / Lists — five perspectives for every search intent
- 🧠 **Smart Experience**: Use natural language to trigger searches; automatic pagination requires no manual effort

**Who It's For**

- 📱 Operators — track trending topics in real time and stay on top of public sentiment
- 📈 Marketing Teams — analyze competitor presence and user feedback on X
- 🏷️ Brand Owners — monitor brand mentions and catch opportunities or risks early
- ✍️ Content Creators — discover inspiration and tap into global trending topics

---

## Features

### Core Features

- **Smart Keyword Search**: Enter any keyword to instantly search tweets, users, and lists on X
- **Five Search Modes**: Trending, latest posts, image/video filtering, people search, list aggregation — covering every search intent
- **Tweet Detail Extraction**: Automatically retrieves text, likes, retweets, replies, bookmarks, views, and more
- **Media Attachment Access**: Extracts image covers and video playback URLs from tweets, with multi-resolution support
- **Author Profile Display**: Shows author nickname, follower count, verification status, location, and more
- **Smart Pagination**: Handles pagination automatically — no data gets missed even with large result sets

---

## Usage Guide

Just describe what you need in natural language — no commands to memorize.

> User: Search trending tweets about "AI" on X
>
> Assistant: Found 20 trending tweets about "AI", sorted by popularity...

> User: What's the latest discussion on "Apple Event"?
>
> Assistant: Found the latest tweets about "Apple Event", 20 in total...

> User: Show me the next page
>
> Assistant: Loading the next page, here are more tweets...

### Quick Reference

| Intent | Example Query | Result |
|--------|--------------|--------|
| Trending | "Search trending Tesla content on X" | Sorted by overall popularity |
| Latest | "Check the latest Bitcoin discussions" | Sorted by publish time (newest first) |
| Images/Videos | "Find pictures and videos about the Paris Olympics" | Filters tweets with media |
| Find People | "Search X for AI-focused accounts" | Returns relevant user profiles |
| Find Lists | "Search for tech-related lists" | Returns relevant lists |
| Next Page | "Next page", "Continue", "More" | Loads additional tweets |

---

## Use Cases

| Scenario | Role | Example Query | Benefit |
|----------|------|--------------|---------|
| Trend Tracking | Operator | "Show me the latest ChatGPT discussions today" | Stay on top of trends and adjust content strategy |
| Competitor Analysis | Marketing Team | "Search for recent competitor brand updates" | Understand competitor presence shifts to inform decisions |
| Brand Monitoring | Brand Owner | "Search for our brand mentions on X" | Quickly spot positive or negative sentiment |
| Content Inspiration | Creator | "Search trending AI art tweets" | Tap into global content trends for creative ideas |

README.md 3.3 KB

# X(Twitter)作品搜索 / twitter-work-search

---

## 简介

在 X 平台按关键词一键精准检索作品，支持热门、最新、图片视频等多种搜索模式，输出推文正文、互动数据、媒体附件和作者信息，为舆情分析、市场调研和内容运营提供数据支撑。

**核心价值**

- 🔍 **精准检索**：输入关键词即可秒级获取 X 平台相关内容，告别手动浏览
- 📊 **数据全面**：点赞、转发、回复、浏览等全维度互动指标一站到位
- 🎯 **模式灵活**：热门 / 最新 / 媒体 / 用户 / 列表五种搜索视角自由切换
- 🧠 **智能体验**：口语化表达即可触发搜索，自动翻页无需手动操作

**适用对象**

- 📱 运营人员 — 快速追踪话题热度趋势，掌握一手舆情动态
- 📈 市场团队 — 分析竞品在 X 平台的声量与用户反馈
- 🏷️ 品牌方 — 监控品牌提及情况，及时发现传播机会与风险
- ✍️ 内容创作者 — 寻找灵感素材，了解海外热门话题走向

---

## 功能特性

### 核心功能

- **关键词智能搜索**：输入任意关键词，一键检索 X 平台推文、用户和列表
- **五种搜索模式**：热门排序、最新发布、图片视频筛选、精准找人、列表聚合，覆盖全部搜索意图
- **推文详情提取**：自动获取正文、点赞、转发、回复、收藏、浏览等全维度数据
- **媒体附件获取**：自动提取推文中的图片封面和视频播放地址，支持多清晰度
- **作者画像展示**：同步展示作者昵称、粉丝数、认证状态、所在地等信息
- **智能分页翻页**：自动处理翻页逻辑，数据量大也不遗漏

---

## 使用指南

直接用自然语言描述需求，无需记忆命令。

> 用户：搜一下 X 上关于"AI"的热门推文
>
> 助手：为你找到 20 条关于"AI"的热门推文，按热度排序如下...

> 用户：看看"苹果发布会"的最新讨论
>
> 助手：为你找到关于"苹果发布会"的最新推文，共 20 条...

> 用户：继续看下一页
>
> 助手：已加载下一页，继续为你展示更多推文...

### 常用说法速查

| 意图 | 示例话术 | 效果 |
|------|---------|------|
| 热门内容 | "搜一下 X 上关于特斯拉的热门内容" | 按综合热度排序 |
| 最新动态 | "看看比特币的最新讨论" | 按发布时间倒序 |
| 图片视频 | "找一下巴黎奥运相关的图片和视频" | 筛选含媒体的推文 |
| 找人 | "在 X 上搜一下做 AI 的账号" | 搜索相关用户 |
| 查列表 | "搜一下科技类的列表" | 搜索相关列表 |
| 翻页 | "下一页""继续""还有吗" | 加载更多推文 |

---

## 使用场景

| 场景 | 角色 | 示例问法 | 收益 |
|------|------|---------|------|
| 话题热度追踪 | 运营人员 | "看看今天关于 ChatGPT 的最新讨论" | 掌握热点走向，及时跟进内容策略 |
| 竞品动态分析 | 市场团队 | "搜一下竞品品牌最近有什么新动态" | 了解竞品声量变化，辅助决策 |
| 品牌舆情监控 | 品牌方 | "搜一下我们品牌在 X 上的讨论" | 快速发现正面/负面舆情 |
| 内容灵感挖掘 | 内容创作者 | "搜一下 AI 绘画相关的热门推文" | 获取海外内容趋势，激发创作灵感 |

SKILL.md 5.9 KB

---
name: twitter-work-search
description: "输入关键词搜索X(Twitter)作品，支持按热门、最新、媒体、用户、列表五种类型精准筛选，一键获取作品正文、互动数据、媒体附件与作者信息等结构化结果。触发词：当用户提到'X搜索'、'Twitter搜索'、'作品搜索'、'X关键词搜索'、'搜一下X上的'时使用"
---

# X(Twitter)作品搜索

## 📝 简介

X(Twitter)作品搜索工具，帮你快速在 X 平台按关键词精准检索作品。支持热门排序、最新发布、图片视频筛选等多种搜索模式，输出作品正文、点赞转发等互动指标、媒体附件详情及作者画像，为舆情分析、市场调研和内容运营提供数据支撑。

适用场景：运营人员追踪话题热度趋势、市场团队分析竞品动态、品牌方监控舆情声量、内容创作者寻找灵感素材。

## ✨ 功能特性

### 核心功能

| 功能模块 | 能力描述 | 核心价值 |
|---------|---------|----------|
| 关键词智能搜索 | 输入任意关键词，一键检索 X 平台相关推文 | 告别手动浏览，秒级获取目标内容 |
| 五种搜索模式 | 支持热门、最新、媒体、用户、列表五种筛选方式 | 按需切换视角，精准定位所需内容 |
| 推文详情提取 | 自动提取正文、点赞、转发、回复、收藏、浏览等全维度数据 | 数据全面，分析有据可依 |
| 媒体附件获取 | 自动提取推文中的图片封面和视频播放地址 | 内容素材一键获取，支持多清晰度 |
| 作者画像展示 | 同步展示作者昵称、粉丝数、认证状态、所在地等信息 | 快速评估信源质量与影响力 |
| 智能分页翻页 | 自动处理分页逻辑，支持连续翻页获取更多结果 | 数据量大也不遗漏，翻页无感知 |

### 特色亮点

- **搜索模式自由切换**：热门推文、最新动态、图片视频、精准找人、列表聚合，五大模式覆盖所有搜索意图
- **全维度数据输出**：从推文正文到互动数据、从媒体附件到作者画像，一条推文的信息全部到位
- **操作极简**：只需输入关键词，支持口语化表达，自动识别搜索意图并返回结构化结果

## 📖 使用指南

### 🔑 鉴权

前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API KEY

配置方式：
1. 在 `~/.openclaw/openclaw.json` 中配置
2. 设置环境变量 `REDFOX_API_KEY`
3. 使用命令行参数 `--api-key`

### 基础使用

直接告诉我你想搜索的关键词即可：

> 用户：搜一下X上关于"AI"的热门推文
>
> 助手：为你找到 20 条关于"AI"的热门推文，按热度排序如下...

> 用户：看看"苹果发布会"的最新讨论
>
> 助手：为你找到关于"苹果发布会"的最新推文，共 20 条...

> 用户：继续看下一页
>
> 助手：已加载下一页，继续为你展示更多推文...

支持五种搜索类型，如果不指定，默认按**热门**搜索：
- **热门**（Top）：综合热度最高的推文
- **最新**（Latest）：按发布时间倒序
- **媒体**（Media）：包含图片或视频的推文
- **用户**（People）：搜索相关用户账号
- **列表**（Lists）：搜索相关列表

### 常用说法速查

| searchType | 触发关键词 | 示例话术 |
|:---:|---|---|
| **Top**（热门） | 热门、热度、最火、Top | "搜一下X上关于特斯拉的热门内容" |
| **Latest**（最新） | 最新、最近、Latest、新发布 | "看看比特币的最新讨论" |
| **Media**（媒体） | 图片、视频、媒体、Media、照片 | "找一下巴黎奥运相关的图片和视频" |
| **People**（用户） | 用户、账号、找人、People、博主 | "在X上搜一下做AI的账号" |
| **Lists**（列表） | 列表、Lists | "搜一下科技类的列表" |
| —（翻页） | 下一页、继续、还有吗 | 加载更多推文，自动沿用上次的 searchType |

## 🔄 工作流程

1. **接收关键词**：从你的消息中提取搜索关键词和搜索类型偏好
2. **验证输入**：检查关键词是否有效，搜索类型是否在支持范围内
3. **执行搜索**：调用 X 搜索接口，一键获取推文数据
4. **智能翻页**：结果满 20 条时自动提示翻页，支持连续查看
5. **结构化输出**：将推文数据整理为易读的表格，包含正文、互动指标、推文链接和作者信息，媒体附件以图标标记

> 完整执行流程详见 `references/core_workflow.md`

> 接口参数与数据结构详情见 `references/core_workflow.md`

## ❓ 常见问答

### 使用相关

**Q：支持搜索哪些内容？**
A：支持按关键词搜索 X 平台的推文、用户和列表，覆盖正文、图片、视频等全部内容类型。

**Q：搜索类型怎么选？**
A：想看热度高的选"热门"，想看最新动态选"最新"，只想看图片视频选"媒体"，找人搜账号选"用户"，查列表选"列表"。不指定时默认热门排序。

**Q：一次能看多少条推文？**
A：每次返回最多 20 条，如果结果超过一页，会自动提示你翻页继续查看。

**Q：可以搜非中文关键词吗？**
A：可以，支持任意语言的关键词搜索。

**Q：搜索结果包含哪些信息？**
A：每条推文包含正文、发布时间、点赞/转发/回复/收藏/浏览等互动数据、图片封面和视频地址、以及作者昵称、粉丝数、认证状态等用户信息。

### 故障排除

**Q：搜索返回"未找到相关推文"？**
A：尝试更通用的关键词、减少限定词，或更换搜索类型（如从热门改为最新）。

**Q：提示 API Key 无效？**
A：请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 检查 API Key 是否正确配置，确保密钥有效且未过期。

**Q：翻页提示不出现了？**
A：只有当搜索结果满 20 条时才会出现翻页提示，不足 20 条说明已经是最后一页。

## 📚 参考文档

- 详细执行工作流：`references/core_workflow.md`