用途：通过 xAI Grok API 的 x_search 工具实时检索 X/Twitter，产出摘要、帖子/话题串分析、趋势主题和自定义搜索结果，并生成可用的内容选题灵感。适合关注特定账号或话题、需要快速掌握实时讨论动向的场景。
主要能力：提供 digest（订阅账号摘要）、analyze（帖子/话题串/主题深度分析）、trending（按兴趣的趋势）、search（自定义搜索）四类脚本，以及 find_latest.sh 查找最新缓存结果。每次运行保存不可变 JSON 快照到 cache/runs/，并写入 cache/index.jsonl 索引；返回结构化条目（作者、日期、摘要、互动数据、URL、主题）及叙事总结、引用与选题建议。
使用方式：先获取 xAI API key（console.x.ai），执行 cp config/.env.example config/.env 并填入 XAI_API_KEY、配置账号与话题（含空格的值需加引号）。分类注册机制用 X_CATEGORIES、X_DEFAULT_CATEGORY、X_ACCOUNTS_<ID>、X_TOPICS_<ID>、X_ACCOUNTS_<ID>_LABEL 配置。运行前建议创建运行副本：sh scripts/prepare_runtime.sh，然后 cd /home/claude/x-research。常用命令示例：bash scripts/digest.sh --period today；bash scripts/analyze.sh --url "https://x.com/elonmusk/status/123456" --query "context"；bash scripts/trending.sh --topics "Bitcoin,Ethereum,DeFi"；bash scripts/search.sh --query "Claude 4 reactions" --period week。可用 --prefer-cache 复用缓存、--refresh 强制实时请求。参数优先级为显式 --accounts/--topics 高于 .env 分类配置。无 .env 时须显式传入参数。
限制：仅能访问公开帖子，无法获取私密/受保护账号与私信；x_search 是服务端 Grok 工具，返回的是合成分析而非原始帖子数据；结构化 JSON 依赖模型输出，解析失败会回退为纯文本；只有公开互动指标，无分析数据。x_search 每次 allowed_x_handles 最多 10 个账号，超出会自动分批；速率限制按套餐分级；工具调用单独计费；主模型不可用时自动回退到 grok-4.20-reasoning。stdout 限制 30 行，完整数据在 artifact 文件中。价格、具体套餐等细节资料未提供。