Search X

核心用法

Search X 是一款集成 Grok AI 的实时 Twitter/X 搜索技能，通过 xAI Responses API 调用 x_search 工具获取真实推文。支持自然语言查询、时间范围过滤（--days）、指定账号（--handles）及排除账号（--exclude），输出格式可选完整 JSON、精简推文或纯链接模式。

显著优点

1. 实时性强：直接对接 X 平台，获取最新推文而非缓存数据
2. 引用溯源：每条结果附带推文链接，便于核实信息来源
3. 灵活过滤：支持多维度筛选（时间、账号、排除项），精准定位内容
4. 模型优化：默认使用 grok-4-1-fast，针对代理式搜索场景调优

潜在缺点与局限性

• API 依赖：需自备 xAI API key，存在付费门槛
• 平台局限：仅覆盖 X/Twitter，无法检索其他社交平台
• 内容风险：返回未经审核的UGC内容，可能包含不实信息或敏感言论
• 地域限制：X 平台在部分国家/地区受限，影响可用性

适合人群

• 市场研究员与舆情分析师
• 媒体记者追踪突发新闻
• 品牌运营监控社媒口碑
• 开发者调试 Grok API 集成

常规风险

• API key 泄露可能导致账户滥用
• 抓取公开推文需遵守 X 平台 Terms of Service
• 实时搜索可能消耗较多 token，需关注用量成本

核心用法

search-x 是一个基于 xAI Grok 的 X/Twitter 实时搜索工具，通过 Claude Code 直接调用。用户可通过自然语言触发搜索，支持多种过滤条件和输出格式。

基础搜索：输入任意关键词即可获取相关推文
时间过滤：--days N 限定最近 N 天的内容（1-30天）
用户筛选：--handles @user1,@user2 限定特定账号，--exclude @bots 排除机器人
输出格式：支持 --json 完整响应、--compact 精简模式、--links-only 仅链接

显著优点

1. 实时性强：直接对接 X 平台数据，获取最新讨论动态
2. 结果可信：每条推文附带原始链接和引用信息，便于核实
3. 零依赖架构：仅使用 Node.js 内置模块，无第三方包，供应链风险为零
4. 轻量高效：代码结构清晰（285行核心脚本），无冗余功能
5. 配置灵活：支持环境变量和配置文件双模式管理 API 密钥

潜在局限

• 依赖外部服务：需持有 xAI API 密钥，存在服务商政策变更风险
• 成本考量：xAI API 调用按 token 计费，高频使用需关注费用
• 数据覆盖：搜索范围受限于 X 平台公开内容及 Grok 索引范围
• 无本地缓存：每次搜索均为实时请求，无法离线复用
• T3 来源：个人开发者项目，长期维护稳定性需观察

适合人群

• 需要追踪社交媒体舆情的市场研究人员
• 关注技术社区动态的开发者和产品经理
• 进行竞品监测和品牌分析的运营团队
• 希望快速获取热点话题讨论的内容创作者

常规风险

• API 密钥泄露：密钥存储于本地文件或环境变量，需确保文件权限（建议 chmod 600）
• 网络传输：搜索关键词和密钥经 HTTPS 发送至 xAI 服务器
• 隐私合规：搜索内容可能涉及他人公开信息，需遵守平台使用规范
• 结果准确性：AI 生成的搜索结果可能存在摘要偏差，建议点击原始链接核实