核心用法
search-x 提供两种实时搜索 X/Twitter 的模式：
xAI Grok 模式（默认）：调用 xAI Responses API，使用 grok-4-1-fast 模型，支持自然语言查询，AI 自动整理结果并标注引用来源，可追溯近 30 天内容。
原生 X API 模式：直接访问 X 官方搜索接口，返回原始推文数据与互动指标，限近 7 天内容，按用量计费。
支持丰富的过滤选项：按时间范围（--days）、指定用户（--handles）、排除账号（--exclude），以及多种输出格式（完整 JSON、精简内容、仅链接）。
显著优点
- 双源互补：Grok 模式智能易读，X API 模式原始精准，适应不同场景
- 引用可追溯：Grok 模式自动附加推文链接，方便核实信息来源
- 无需 X 账号：仅需 xAI API key 即可搜索，降低使用门槛
- 成本灵活：X API 按量付费无订阅，Grok 模式走 xAI 统一计费
- 安全设计：只读搜索，无发帖/点赞/DM 权限，且禁止模型自主调用
潜在局限
- 时效限制：Grok 最多 30 天，X API 仅 7 天，无法搜索历史存档
- 覆盖盲区：X 平台内容本身存在信息茧房，搜索结果不代表全网观点
- API 依赖：xAI 或 X 服务波动会直接影响可用性
- 成本累积：高频搜索 X API 可能产生意外账单
- 地域限制：部分国家/地区 X 服务受限
适合人群
- 需要追踪热点话题的市场营销、公关从业者
- 关注技术社区动态（如 AI、开发者工具）的研究人员
- 希望快速了解公众对某产品/事件反响的产品经理
- 新闻采编人员寻找一手社交信源
常规风险
- 信息真实性：社交媒体内容未经审核，需交叉验证
- 隐私合规：抓取公开推文仍需遵守平台 ToS 与数据保护法规
- API 密钥泄露：
XAI_API_KEY或X_BEARER_TOKEN需妥善保管 - 模型幻觉：Grok AI 可能对搜索结果进行不准确的总结归纳