X 作品搜索

这个技能解决什么问题

在 X(Twitter) 上做舆情监测或竞品调研时，第一道坎往往不是分析，而是采集。手动在时间线里翻找关键词相关内容，既慢又容易漏：热门排序是动态的，最新动态转瞬即逝，带图带视频的推文和纯文本混在一起，想找某个账号还得逐个点进主页确认。就算翻到目标推文，点赞、转发、回复、浏览量、媒体地址、作者粉丝数这些字段也散落在页面各处，复制粘贴本身就会产生格式错乱和遗漏。

核心能力与工作流程

该技能把整个采集过程封装成一次关键词请求：

• 五种搜索模式：热门（Top）按热度排序、最新（Latest）按时间倒序、媒体（Media）只返回含图片或视频的推文、用户（People）检索账号、列表（Lists）聚合列表资源。不指定类型时默认走热门。
• 结构化输出：每条结果包含正文、发布时间、点赞/转发/回复/收藏/浏览量、媒体封面与视频播放地址（支持多清晰度），以及作者昵称、粉丝数、认证状态和所在地。
• 自动翻页：结果超过 20 条时，自动沿用当前 searchType 加载下一页，不需要重复说明筛选条件。

调用链路很直白：从自然语言中提取搜索关键词和类型偏好 → 校验输入有效性 → 调用 X 搜索接口 → 结果整理成易读的结构化表格。口语化表达如「看看特斯拉的热门内容」会被解析为 Top + Tesla；翻页只需一句「下一页」或「继续」。

适用边界与注意点

• 分页粒度：单页上限 20 条，只有满页才会出现翻页提示；返回不足 20 条即代表已经是最后一页。
• 空结果排查：关键词过窄或限定词过多是检索不到的常见原因，应放宽词条，或从 热门 切换到 最新 换个视角重试。
• 鉴权依赖：需要有效的 API Key 才能调用，密钥失效或过期会直接报错，需要到红狐hub 检查。
• 排序语义：热门 的排序由 X 平台的热度机制决定，不同关键词的热度构成并不相同，结果不宜当作统一的传播度量标准横向对比。