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