核心功能
xbird 是一套面向 AI Agent 的 Twitter/X 集成工具集，提供完整的社交媒体自动化能力。覆盖四大核心场景：
1. 内容消费（$0.001/call）：读取推文、线程、回复、用户资料、首页时间线及趋势话题，支持列表管理和深度搜索。
2. 搜索发现（$0.005/call）：高级搜索支持时间范围、媒体过滤、排除转推等运算符，可监控提及。
3. 互动管理（$0.01/call）：发帖、回复、串推（最少2条）、点赞/取消、转推/取消、书签管理及关注操作。
4. 资料与媒体（$0.01-$0.05/call）：更新简介、头像、横幅，支持图片/视频上传（先上传获取mediaId再发布）。
显著优势
- 功能完整度极高：34个工具覆盖Twitter/X官方API的绝大多数能力，包括线程发布、列表管理、高级搜索等进阶功能
- Agent原生设计：MCP协议集成，Claude Code直接调用，无需REST API封装
- 微支付弹性计费：x402协议实现按调用付费，免费额度可用，付费层无需订阅
- 隐私友好：本地运行+住宅IP，规避数据中心IP被封风险
局限与风险
- 账户安全风险：需提取x.com的
auth_token和ct0Cookie，本质为会话劫持，违反Twitter ToS，存在封号可能 - 私钥暴露风险：XBIRD_PRIVATE_KEY存储于环境变量，虽为可选，但付费用户面临密钥管理挑战
- 依赖稳定性：通过Cookie模拟用户会话，Twitter/X的反爬策略变化可能导致工具失效
- 无OAuth支持：相比官方API的标准授权流程，Cookie方案缺乏权限粒度控制
适用人群
- AI Agent开发者需社交媒体自动化能力
- 研究人员进行Twitter数据收集（需评估合规性）
- 个人用户寻求替代官方API的高性价比方案
常规风险
⚠️ 账户封禁：Cookie登录属于非官方授权方式，Twitter/X可检测并限制/封禁账户
⚠️ 数据泄露：Cookie包含完整会话权限，泄露后账户可被完全接管
⚠️ 服务中断：非官方集成，Twitter前端变更可能导致工具突然失效