核心用法
Search X 提供双模式实时 X/Twitter 搜索能力：
1. xAI Grok 模式（默认）
- 调用 xAI Responses API 的
x_search工具 - 支持最多 30 天历史数据
- AI 智能格式化结果并附带引用标注
- 使用模型：
grok-4-1-fast
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仅链接 - 结果数量：
--max 50等参数控制
显著优点
1. 双引擎灵活切换：Grok AI 提供智能摘要与更长历史，X API 提供原始数据与精确指标
2. 零订阅成本：X API 按量计费，无固定月费；Grok 模式仅需 xAI API 密钥
3. 引用可追溯：所有结果包含直接推文链接，便于核实原文
4. 权限最小化：只读搜索，无发帖、点赞、私信等写权限
潜在缺点与局限
- 历史窗口有限：最长 30 天，无法满足深度历史归档需求
- API 成本波动：高频使用 X API 可能产生不可预测费用
- 内容依赖平台：受 X/Twitter 内容审核、账号封禁影响
- 地域与语言偏差：搜索结果反映平台用户分布，可能不具代表性
- Grok 幻觉风险：AI 格式化可能引入理解偏差，需核对原文链接
适合人群
- 市场调研人员追踪品牌舆情与竞品动态
- 开发者与产品经理监控技术社区反馈
- 记者与研究者收集实时事件一手信源
- 投资者跟踪加密货币、股市情绪指标
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| API 密钥泄露 | 密钥存储于环境变量，可能意外暴露 | 使用专用密钥，定期轮换，避免提交到版本控制 |
| 成本超支 | X API 按调用计费，高频使用易超预算 | 设置用量监控，优先使用 Grok 模式 |
| 信息茧房 | 算法推荐导致搜索结果偏颇 | 多关键词交叉验证，结合多平台信源 |
| 实时性误差 | "实时"仍有分钟级延迟 | 对时效性极强场景保留人工确认环节 |
技术实现
- Node.js 脚本驱动，依赖
XAI_API_KEY或X_BEARER_TOKEN - 仅向
api.x.ai或api.x.com发送请求，无第三方中转 - 显式禁用模型自主调用（
disable-model-invocation: true），需用户明确触发