用途:面向 X/Twitter 的智能体研究工具,用于获取实时观点、开发者讨论、产品反馈、突发新闻与专家意见,并综合成有来源的简报。
主要能力:搜索推文(支持排序、时间过滤、最低点赞/曝光、分页、快速模式、质量过滤、排除回复、保存与 JSON/Markdown 输出);查看指定用户近期推文;按根推文 ID 抓取完整对话线程;获取单条推文;维护关注列表并检查其近期动态;15 分钟文件缓存避免重复请求。
使用方式:需设置 X_BEARER_TOKEN(或 XAI_API_KEY)环境变量,并安装 Python 3.11+ 与 uv。命令通过 uv run 运行,例如:uv run {baseDir}/skills/x-research/scripts/x_search.py search "<query>" [options];profile、thread、tweet、watchlist、cache 等子命令同理。搜索默认自动添加 -is:retweet,并显示预估 API 成本。深度研究可按拆解查询、搜索提取、跟踪线程、深挖链接、按主题综合、保存的循环进行。
适用场景:了解开发者或社区对某话题的看法、突发新闻与产品发布的实时反应、技术讨论、监控关键账号、竞品与市场调研、深入调查前的快速摸底。
限制:只读工具,不能发推、回复或管理账号;仅使用近期搜索端点,无法做超过 7 天的历史研究;不搜索非 X 平台;X API 按量计费(资料称每篇读取 $0.005、用户查询 $0.01),快速模式可将单次搜索成本控制在约 $0.50 以内。X API 端点、操作符与完整定价见 references/x-api.md。