x-trends

X (Twitter) Trends 是一个专注于查询和分析 X 平台（原 Twitter）热门话题的 Agent Skill。该技能通过调用官方 Twitter CLI 工具 twurl，为用户提供实时的全球及地域化趋势数据查询能力，支持获取热门话题标签、搜索相关推文等功能。

核心用法
该 Skill 主要基于命令行工具 twurl 与 Twitter API 进行交互。用户首先需要安装 twurl 并授权 X/Twitter API 凭证，随后可通过简单的命令获取 Worldwide 或特定 WOEID 地区的趋势话题。常用操作包括：查询全球趋势（id=1）、按国家/地区获取趋势（如美国 23424977、英国 23424975）、查找可用趋势位置、基于坐标定位最近趋势点，以及搜索特定话题的相关推文。所有操作均支持通过 jq 进行 JSON 数据解析和过滤，便于后续数据处理。

显著优点
首先，该 Skill 直接对接官方 Twitter API，数据来源权威可靠，趋势更新频率约为 5 分钟，能够保证信息的时效性。其次，支持全球 234 个国家和地区的地域化趋势查询（通过 WOEID），满足本地化运营需求。再者，命令行操作方式灵活高效，适合批量处理和自动化脚本集成。此外，代码示例完全透明，均为官方 API 的合法调用，无黑箱操作。

潜在缺点与局限性
该 Skill 存在几个明显的使用门槛：一是强制依赖第三方工具 openclaw-agent，该工具来自非官方社区（hedefbari/openclaw-agent），其安全性和稳定性未经广泛验证；二是需要用户自行申请 Twitter/X API 密钥并完成授权配置，对非技术用户不够友好；三是受限于 Twitter API v1.1 的速率限制（每 15 分钟 75 次请求），高频查询场景下可能受限；四是部分趋势数据可能缺失 tweet_volume 字段，且存在推广内容标记。

适合的目标群体
主要面向社交媒体运营人员、市场趋势分析师、数据新闻记者、开发者以及需要监控特定话题的研究人员。特别适合习惯命令行操作、需要快速获取原始 JSON 数据进行二次分析的技术用户。

使用风险
首要风险在于对 openclaw-agent 的依赖，建议在使用前审查该第三方代理工具的来源和安全性。其次是 API 凭证管理风险，用户需确保在安全环境中配置 twurl 授权，避免密钥泄露。此外，Twitter API 的速率限制可能导致服务中断，且该 Skill 为纯文档型资产，无异常处理机制，网络波动或 API 变更可能导致命令执行失败。由于来源为 T3 级社区开发者，长期维护支持存在不确定性。