Search X

核心用法

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 保障与长期支持存不确定性

核心用法

search-x 是一款专注于X/Twitter实时搜索的Skill，提供两种互补的搜索模式：

xAI Grok模式（默认）：调用xAI的Responses API，利用grok-4-1-fast模型进行AI驱动的智能搜索，支持最长30天的历史数据，返回带引用标注的结构化结果。

X API原生模式（--x-api）：直接调用X官方搜索接口，支持7天内数据，按量计费无订阅门槛，返回原始推文及互动数据。

核心命令结构为 node {baseDir}/scripts/search.js [选项] "搜索词"，支持时间过滤（--days）、账号筛选（--handles/--exclude）、输出格式控制（--json/--compact/--links-only）等丰富参数。

显著优点

1. 双引擎架构：Grok模式提供AI理解的语义搜索和智能摘要，X API模式提供原生精确数据和成本控制灵活性，用户可按场景切换。

2. 零依赖轻量设计：仅使用Node.js内置模块（https, process），无第三方npm包，大幅降低供应链攻击面，代码透明可审计。

3. 隐私优先：API密钥仅通过环境变量读取，不存储、不记录、不外传；仅访问公开推文，不触及用户账户或私信。

4. 权限克制：disable-model-invocation: true 设计防止AI代理自动调用，确保每次搜索都经用户明确触发。

5. 输出灵活：从完整JSON到精简推文列表再到纯链接提取，适配自动化脚本、人工阅读和外部工具集成等多种场景。

潜在局限

• 时效天花板：Grok模式30天、X API模式7天的历史限制，无法满足深度历史回溯需求。
• 外部依赖风险：功能完全依赖xAI和X Corp的API服务可用性，任一端点变更或中断将直接影响使用。
• 成本不确定性：X API按量计费模式在大规模查询时成本可能累积；Grok模式虽通常包含在xAI订阅中，但高频调用同样需关注配额。
• T3来源需关注：由个人开发者维护，虽代码开源可审查，但长期维护承诺和企业级安全实践不如T1/T2来源稳定。

适合人群

• 需要实时追踪社交媒体舆情的产品经理、市场运营、公关从业者
• 从事AI/科技趋势研究的分析师、投资人、记者
• 构建社交数据监控工作流的开发者、自动化工程师
• 希望替代X官方搜索界面、获得更结构化输出结果的重度X用户

常规风险

• API密钥泄露：若环境变量管理不当，可能导致密钥泄露引发未授权使用或费用损失
• 数据合规边界：虽仅读取公开数据，但批量抓取和再分发仍需遵守X平台服务条款及各地数据法规
• 结果偏差：AI总结可能引入Grok模型的理解偏差，关键决策应交叉验证原始推文