核心用法
search-x 是一个实时搜索 X/Twitter 内容的命令行工具，提供两种互补模式：
1. xAI Grok 模式（默认） —— 调用 Grok 的 x_search 工具，支持最多 30 天历史搜索，由 AI 智能提取并格式化结果，自动附带来源引用。需配置 XAI_API_KEY，模型默认为 grok-4-1-fast。
2. X API 原生模式（`--x-api`） —— 直接调用 X 官方搜索接口，最多 7 天历史，按量付费（无需订阅），返回原始推文数据与互动指标。需配置 X_BEARER_TOKEN。
核心功能：关键词搜索、按账号过滤（--handles/--exclude）、时间范围限定（--days）、JSON/精简/仅链接三种输出格式。典型场景包括追踪品牌舆情、监控技术社区动态、查找特定账号的历史发言等。
显著优点
- 双引擎灵活切换：Grok 模式适合深度分析与长周期回溯，X API 模式适合高频、低成本的近期数据抓取
- 零订阅成本：X API 按调用付费，无固定月费；Grok 模式通过 xAI API 密钥即可使用
- 安全沙盒设计：显式声明
disable-model-invocation: true，禁止模型自主调用，需用户主动触发 - 透明可审计：所有请求仅发送至
api.x.ai或api.com，脚本源码公开可审阅
潜在缺点与局限性
- 数据时效天花板：即使 Grok 模式也无法突破 30 天，不适合历史档案研究
- 成本不可控风险：X API 按量计费，高频或大批量查询可能产生意外费用；Grok 模式受限于 xAI 账户额度
- API 稳定性依赖：X/Twitter API 政策与定价历史上多次变动，存在服务中断或调价风险
- 无中文优化：文档与接口均基于英文生态，中文内容检索效果未明确说明
适合人群
- 产品经理、运营人员监控品牌声量与竞品动态
- 开发者、研究员追踪技术社区（如
@remotion_dev）的实时讨论 - 记者、分析师快速核实社交媒体上的突发新闻与热点趋势
常规风险
- API 密钥泄露：
XAI_API_KEY与X_BEARER_TOKEN需妥善保管，避免硬编码上传仓库 - 隐私合规边界：虽仅读取公开推文，但聚合分析可能触及 GDPR/CCPA 等数据保护法规
- 信息茧房偏差：搜索结果受 X 平台算法排序影响，不代表全网舆论全貌