Search X

核心用法

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 可能对搜索结果进行不准确的总结归纳

核心用法

search-x 提供两种实时搜索X/Twitter的模式：

1. xAI Grok模式（默认）：通过 x_search 工具调用Grok-4-1-fast模型，支持最多30天历史数据，AI自动格式化结果并附带引用链接。适合快速获取结构化讨论摘要。

2. 原生X API模式（`--x-api`）：直接调用X官方搜索接口，最多7天历史，按量计费无订阅门槛，返回原始推文数据与互动指标。适合需要精确控制和大量结果的场景。

显著优点

• 零依赖安全架构：纯Node.js原生模块实现，无任何npm第三方依赖，彻底消除供应链攻击风险
• 双引擎灵活切换：Grok模式适合智能摘要，X API模式适合精准搜索，满足不同需求
• 丰富的过滤能力：支持按时间窗口（1-30天）、指定用户句柄、排除账号等精细化筛选
• 多格式输出：提供完整JSON、精简版、仅链接等多种输出格式，便于后续处理
• 安全的凭证管理：API密钥仅从环境变量读取，无硬编码，符合安全最佳实践
• 显式用户触发：disable-model-invocation: true 设计防止agent自动调用，确保用户控制权

潜在缺点与局限性

• 数据来源受限：仅能搜索公开推文，无法访问私信、账号设置或历史收藏
• 时间窗口限制：Grok最多30天，X API仅7天，无法进行长期历史回溯
• T3来源可信度：由个人开发者维护，无企业背书，需自行审查代码更新
• API成本：X API按量计费，高频使用可能产生费用；Grok模式依赖xAI API配额
• 网络依赖：需稳定连接至api.x.ai或api.x.com，无离线能力

适合人群

• 研究人员与分析师：快速追踪社交媒体话题趋势、公众情绪与热点讨论
• 内容创作者：监控品牌提及、竞品动态或行业话题，获取创作灵感
• 开发者与产品团队：调试社交功能、验证用户反馈、收集真实用例
• 新闻与媒体工作者：实时跟踪突发事件、核实信息源、发现一手素材

常规风险

• API密钥泄露风险：环境变量若配置不当可能被其他进程读取，建议仅在当前shell会话设置
• 搜索结果偏见：X平台内容本身存在算法推荐和信息茧房，搜索结果不代表全局观点
• 隐私合规注意：虽仅访问公开数据，但批量抓取可能触及平台服务条款，建议遵守合理使用原则
• 数据时效性：社交媒体内容变化极快，30天窗口外的关键信息可能无法获取