用途：为 Claude Code 提供 Twitter/X 的多模式集成，按任务选择工具完成搜索、发帖、监控与归档。
五种模式：托管 MCP（xapi MCP 服务器，OAuth 2.0，按次计费，用于全档案搜索、趋势、书签、Articles、时间线）；官方 API（x-search，Bearer + OAuth 1.0a，按次计费，适合可控成本的研究、信息流、监控列表、发帖）；官方 CLI（xurl，OAuth 1.0a + 2.0，任意端点、媒体上传、私信、原始调用）；会话模式（bird，浏览器 cookie，免费，适合随手读取、提及、带媒体发帖）；归档模式（smaug，经由 bird，免费，书签/点赞处理与 AI 归档）。
定价频繁变动，资料给出头部数字：读取帖子 $0.005、发帖 $0.015、含 URL 发帖 $0.200、自有读取 $0.001，24 小时 UTC 去重，每月 200 万读取上限。x-search 通过 bun run ~/.claude/skills/twitter/x-search/x-search.ts <命令> 运行，支持 counts、search、multi、profile、thread、tweet、feed、watchlist、post、reply、delete、usage 等子命令及 --today、--since、--quick、--dry-run、--bird、--markdown、--save 等参数；含 URL 的发帖除非加 --allow-url 否则被拒绝。xurl 可调用任意端点并上传媒体。bird 使用浏览器 cookie，须始终传 --cookie-source chrome；上游已停止维护（冻结于 0.8.0），X 更改内部接口后无法修复，可回退到 xapi MCP / x-search 读取、xurl 写入。smaug 输出 bookmarks.md 与 knowledge 目录。
限制：多数模式按用量计费，代理循环需控制成本；不要把 ~/.xurl 的 OAuth 令牌或技能 .env 值读入上下文；bird 依赖未公开 GraphQL 接口，存在失效风险。测试发帖/回复务必用 --dry-run。