核心用法
search-x 提供双模式实时X/Twitter搜索能力：
1. xAI Grok模式（默认）
- 调用xAI Responses API的
x_search工具 - 使用
grok-4-1-fast模型优化智能搜索 - 支持最长30天历史回溯
- AI自动格式化结果，附带引用链接
2. 原生X API模式（`--x-api`）
- 直接调用X官方搜索接口
/2/tweets/search/recent - 最长7天历史，按量付费（无需订阅）
- 返回原始推文数据及互动指标
- 单次最多100条结果
关键功能
- 时间过滤：
--days 1~30（Grok）或1~7（X API） - 账号筛选：
--handles @user1,@user2指定来源，--exclude @bots排除账号 - 输出格式：
--json完整数据、--compact精简推文、--links-only仅链接
显著优点
- 双源可靠性：Grok提供AI理解+30天深度，X API提供官方实时+精准指标
- 零社交权限：纯搜索工具，无需X账号授权，不触碰发帖/点赞/DM等功能
- 成本灵活：X API按量计费无订阅门槛，Grok模式随xAI配额使用
- 引用完整：每条结果包含直接跳转链接，便于溯源验证
潜在局限
- 时效天花板：Grok 30天、X API 7天的回溯限制，无法获取历史存档
- 公开数据边界：仅能搜索公开推文， protected 账号内容不可见
- API依赖风险：xAI或X API政策变更可能影响可用性或定价
- 结果质量波动：AI格式化可能遗漏上下文，X API返回原始数据需自行解读
适合人群
- 需要追踪品牌声量、竞品动态的 marketers & PM
- 研究社交媒体舆情、热点趋势的研究者
- 开发者寻找技术讨论、开源项目反馈的技术从业者
- 记者、分析师验证X平台信源与实时事件
常规风险
- API密钥泄露：
XAI_API_KEY与X_BEARER_TOKEN需妥善保管，避免硬编码提交 - 按量成本失控：X API高频查询可能产生意外费用，建议设置用量监控
- 信息偏见：X平台内容本身存在 echo chamber 效应，AI摘要可能强化偏见
- 合规边界：商业用途需遵守X API服务条款，爬虫替代方案风险更高