X实时搜索

技能简介

search-x 提供两种模式实时检索 X/Twitter 内容：默认使用 xAI Grok 模型（支持30天历史），或切换至原生 X API（7天历史，按量计费）。返回带引用的推文、趋势话题及讨论数据。

业务背景

市场与公关团队可实时追踪品牌声量、竞品动态及热点话题，无需人工刷取海量信息流。支持按账号精准筛选或排除特定来源，快速定位关键讨论，为舆情响应和营销决策提供时效性数据支撑。

落地案例：某新品发布期间，运营人员设置关键词监控产品名及竞品对比词，限定近7天范围并排除官方账号，自动抓取真实用户反馈与吐槽。团队据此在2小时内识别出包装设计的负面集中点，及时调整客服话术并同步产品部门优化方案。

能做什么

• 按关键词搜索公开推文，获取实时讨论
• 筛选特定用户账号或排除指定账号
• 限定时间范围（1-30天）
• 输出 JSON、精简文本或仅链接格式
• 查看互动数据（X API 模式）

使用说明

安装准备

1. 确保已安装 Node.js
2. 选择以下任一方式配置密钥：
   • xAI 模式（默认）：export XAI_API_KEY="xai-YOUR-KEY"，密钥获取地址 https://console.x.ai
   • X API 模式：export X_BEARER_TOKEN="YOUR-BEARER-TOKEN"，密钥获取地址 https://console.x.com

基础用法

# Grok 模式搜索
node {baseDir}/scripts/search.js "AI video editing"

# X API 模式搜索
node {baseDir}/scripts/search.js --x-api "AI video editing"

# 时间过滤（Grok 最大30天，X API 最大7天）
node {baseDir}/scripts/search.js --days 7 "breaking news"

# 指定用户账号
node {baseDir}/scripts/search.js --handles @elonmusk,@OpenAI "AI announcements"

# 输出格式控制
node {baseDir}/scripts/search.js --json "topic"        # 完整 JSON
node {baseDir}/scripts/search.js --compact "topic"     # 精简文本
node {baseDir}/scripts/search.js --links-only "topic"  # 仅链接

输入与输出

见下方输入与输出表格。

风险提示

• X API 采用按量计费，无订阅费用但需留意用量
• Grok 模式依赖 xAI 服务可用性
• 仅返回公开推文，无法访问私信或受限内容
• 本技能不会发布、点赞或转发任何内容
• 建议首次使用前审查 scripts/search.js 代码

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/mvanhorn/search-x/SKILL.md
来源类型：GitHub 开源技能