x-research

用途

X Research 是一个通用型智能体研究技能，专门用于在 X/Twitter 上进行研究。它可以将任意研究问题拆解为有针对性的搜索，迭代优化查询，追踪推文线程，深入挖掘链接内容，并综合成一份带来源的简报。适用于检索实时观点、开发者讨论、产品反馈、文化评论、突发新闻和专家意见。

主要能力

搜索：通过关键词和 X 搜索操作符检索推文，支持按点赞、曝光、转发或时间排序，支持时间过滤、最低点赞/曝光过滤、分页、结果数量限制、快速模式、按用户过滤、质量过滤、排除回复、保存结果、JSON 或 Markdown 输出。默认自动添加 -is:retweet，并显示预估 API 成本。
用户资料：获取指定用户的近期推文（默认排除回复）。
线程：根据根推文 ID 获取完整对话线程。
单条推文：获取指定推文。
监控列表：查看、添加、移除、检查监控账号，数据存储在 data/watchlist.json，可用于心跳集成。
缓存：15 分钟 TTL，避免重复抓取相同查询。

使用方式

所有命令需在技能目录下运行：

cd ~/clawd/skills/x-research
source ~/.config/env/global.env

搜索命令：

bun run x-search.ts search "<query>" [options]

常用选项包括 --sort、--since、--min-likes、--min-impressions、--pages、--limit、--quick、--from、--quality、--no-replies、--save、--json、--markdown。

示例：

bun run x-search.ts search "BNKR" --sort likes --limit 10
bun run x-search.ts search "from:frankdegods" --sort recent
bun run x-search.ts search "(opus 4.6 OR claude) trading" --pages 2 --save
bun run x-search.ts search "$BNKR (revenue OR fees)" --min-likes 5
bun run x-search.ts search "BNKR" --quick
bun run x-search.ts search "BNKR" --from voidcider --quick
bun run x-search.ts search "AI agents" --quality --quick

其他命令：

bun run x-search.ts profile <username> [--count N] [--replies] [--json]
bun run x-search.ts thread <tweet_id> [--pages N]
bun run x-search.ts tweet <tweet_id> [--json]
bun run x-search.ts watchlist
bun run x-search.ts watchlist add <user> [note]
bun run x-search.ts watchlist remove <user>
bun run x-search.ts watchlist check
bun run x-search.ts cache clear

研究循环（智能体）

进行深度研究时，遵循以下循环：

拆解问题为查询：将研究问题转化为 3-5 个关键词查询，使用 X 搜索操作符，包括核心查询、专家声音（from:）、痛点关键词、正面信号关键词、链接（url:）、降噪（-is:retweet，必要时加 -is:reply）、加密垃圾过滤（-airdrop -giveaway -whitelist）。
搜索与提取：运行每个查询，评估信号或噪声，调整操作符，识别值得搜索的关键声音、值得追踪的线程、值得深入挖掘的链接资源。
追踪线程：对高互动或线程起始推文使用 thread 命令。
深入挖掘链接内容：当推文链接到 GitHub 仓库、博客文章或文档时，使用 web_fetch 获取，优先处理被多条推文引用、来自高互动推文、直接相关的技术资源。
综合：按主题而非查询分组发现，输出主题标题、摘要、关键引用（含点赞/曝光数和推文链接）以及共享资源。
保存：使用 --save 标志或手动保存到 ~/clawd/drafts/x-research-{topic-slug}-{YYYY-MM-DD}.md。

优化启发式

噪声太多？添加 -is:reply，使用 --sort likes，收窄关键词。
结果太少？用 OR 拓宽，移除限制性操作符。
加密垃圾？添加 -$ -airdrop -giveaway -whitelist。
只要专家观点？使用 from: 或 --min-likes 50。
要实质内容而非热点？使用 has:links 搜索。

心跳集成

在心跳时，可运行监控列表检查，查看关键账号是否发布了值得注意的内容。仅在真正有趣或可操作时标记，不要报告常规推文。

文件结构

skills/x-research/
├── SKILL.md           (本文件)
├── x-search.ts        (CLI 入口点)
├── lib/
│   ├── api.ts         (X API 封装：搜索、线程、资料、推文)
│   ├── cache.ts       (基于文件的缓存，15 分钟 TTL)
│   └── format.ts      (Telegram + markdown 格式化器)
├── data/
│   ├── watchlist.json  (要监控的账号)
│   └── cache/          (自动管理)
└── references/
    └── x-api.md        (X API 端点参考)

适用场景

检索 X 上的实时观点和专家意见。
跟踪开发者讨论和产品反馈。
追踪突发新闻和文化评论。
对特定主题进行深度研究并生成带来源的简报。
监控关键账号的动态。

限制

需要 X API 访问权限，搜索会显示预估 API 成本。
需要 Bun 运行环境和相应环境变量配置。
缓存 TTL 为 15 分钟。
分页最多 1-5 页，每页 100 条推文。
关于具体收费、价格、平台支持范围等细节，资料中暂未提供。