X(Twitter)作品搜索

X(Twitter)作品搜索

📝 简介

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

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

✨ 功能特性

核心功能

特色亮点

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

📖 使用指南

🔑 鉴权

前往 红狐hub 获取 API KEY

配置方式：

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

基础使用

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

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

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

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

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

用户：继续看下一页

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

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

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

常用说法速查

🔄 工作流程

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 检查 API Key 是否正确配置，确保密钥有效且未过期。

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

📚 参考文档

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