核心用法
xbird 是一套面向 AI Agent 的 Twitter/X 集成工具，通过 MCP（Model Context Protocol）协议提供 34 个细粒度工具，覆盖社交媒体操作的完整生命周期。用户需通过 npx @checkra1n/xbird 启动本地 MCP 服务器，并配置 Twitter 认证 Cookie（auth_token、ct0）及可选的钱包私钥以启用 x402 微支付。工具按功能分为六类：Read（$0.001/次）用于获取推文、时间线、用户信息；Search（$0.005/次）支持高级搜索语法；Bulk（$0.01/次）批量获取用户推文、关注列表等；Write（$0.01/次）执行发帖、回复、点赞、转发等互动操作；Profile（$0.01/次）管理个人资料；Media（$0.05/次）处理图片视频上传。典型工作流包括：先调用 get_user 解析 handle 获取 numeric userId，再用于批量工具；媒体需先 upload_media 获取 mediaId 再附加到推文。
显著优点
定价透明且按调用计费，低频次使用成本可控；工具粒度极细，Agent 可精确组合实现复杂自动化策略；支持线程发布、高级搜索运算符（from:/to:/since:/filter:media）、分页游标等高级功能；本地运行配合住宅 IP，降低平台风控概率；x402 支付协议实现无订阅的即用即付模式。
潜在缺点与局限性
安全架构风险：核心逻辑封装于闭源 npm 包，无法本地审计；凭据暴露：需手动从浏览器 DevTools 提取敏感 Cookie，操作繁琐且易出错；身份耦合：Bulk 工具强制要求 numeric userId，增加一次 API 往返；支付门槛：高频调用成本累积，无免费额度明确说明；平台依赖：完全绑定 Twitter/X 私有 API，存在随时失效风险；功能边界：不支持私信、空间、社区等进阶功能。
适合的目标群体
社交媒体自动化开发者、AI Agent 研究者、品牌运营团队的数据分析人员、需要批量采集公开推文的研究机构、Twitter Bot 原型验证者。特别适合已有 Twitter 开发经验、能接受微支付模式、具备基础安全意识的个人开发者或小团队。
使用风险
账号安全：Cookie 泄露可导致账号完全失控，建议专用小号；资金风险：钱包私钥配置后存在被盗刷 USDC 可能，需控制余额；合规风险：自动化互动可能触发 Twitter 反垃圾策略导致封号；供应链风险：远程 npm 包更新可能引入未审计代码；性能风险：本地 MCP 服务器单点运行，无高可用保障；隐私风险：所有操作数据经第三方服务器中转，存在中间人攻击面。