核心用法
Search X 提供两种实时搜索模式：默认的 xAI Grok 模式（支持 30 天历史，AI 智能摘要）和 X API 原生模式（支持 7 天，按量计费）。用户可通过自然语言指令触发搜索，支持时间范围（--days）、指定账号（--handles）、排除账号（--exclude）等多维过滤，输出格式可选完整 JSON、精简版或仅链接。
典型场景：监测品牌舆情、追踪技术社区讨论热点、收集行业 KOL 观点、分析竞品用户反馈。
显著优点
1. 双模式灵活切换：Grok 模式零配置门槛，AI 自动提炼要点并标注来源；X API 模式适合深度数据挖掘，支持原始 engagement 指标
2. 实时性强：Grok 模式可达 30 天回溯，远超 X API 的 7 天限制，对突发话题追踪更友好
3. 安全隔离设计：disable-model-invocation: true 防止 AI 自主调用，所有操作需用户明确指令，降低误操作风险
4. 输出可控：--compact 快速预览、--json 结构化分析、--links-only 直接归档，适配不同工作流
潜在局限
- 成本不透明：X API 采用 pay-per-use，高频使用可能产生意外费用；Grok 模式受限于 xAI 账户额度
- 平台依赖风险：完全绑定 X 平台生态，若 API 政策变动或速率限制调整，功能可能受限
- 数据完整性：Grok 模式经 AI 加工，存在摘要偏差可能；X API 的 7 天窗口对历史深度研究不足
- 无中文优化：界面与文档全英文，国内用户配置门槛较高
适合人群
- 市场/公关从业者：实时品牌监测与危机预警
- 技术布道者与开发者：追踪开源项目社区反馈、收集用户痛点
- 投资研究员：捕捉行业情绪与突发事件信号
- 内容创作者：发现 trending topics 与高质量讨论线索
常规风险
- API 密钥泄露：
XAI_API_KEY与X_BEARER_TOKEN需妥善保管，避免硬编码入版本控制 - 合规边界：抓取公开推文虽合法，但大规模存储或商业分析需遵守 X 开发者协议与 GDPR 等法规
- 信息茧房：Grok AI 的摘要可能强化偏见，关键决策建议交叉验证原始推文
- 服务稳定性：xAI 与 X API 均为较新服务，SLA 保障与长期支持存不确定性