📇 ☁️ 🏠 🍎 🪟 🐧 - Post tweets, search, read timelines, manage engagement and upload media on Twitter/X using…
xbird — Twitter/X for AI Agents
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
Agent skills that give AI agents **247 Twitter/X tools** — reading, searching, posting, engagement, media upload — across 3 integration protocols.
No Twitter developer account, no API keys, no OAuth.
Skills
| Skill | Protocol | Best For |
|-------|----------|----------|
| **xbird** | MCP (stdio) | Claude Code, Cursor, Windsurf — local MCP tools |
| **xbird-rest-api** | REST + x402 | Backend services, autonomous agents, any HTTP client |
| **xbird-acp** | ACP (Virtuals) | Agent-to-agent commerce on Virtuals Protocol marketplace |
Which skill to use?
Quick Install
Claude Code Plugin
Agent Skill (works with 35+ agents)
MCP Server Only
**Bun (recommended)** — auto-detects browser cookies:
**Node.js** — requires one-time login:
A payment wallet is generated automatically on first run.
| | Bun (bunx) | Node.js (npx) |
|--|---|---|
| **Browser cookies** | Auto-detected | Manual login required |
| **Setup** | Install Bun, done | One-time login command |
| **Startup** | Faster | Slower (npm registry check) |
CLI
How It Works
MCP (Local)
The xbird server only verifies payments. All Twitter API calls happen locally from your machine.
REST API (Stateless)
Buyer Agent
|-- ECDH key exchange --> xbird TEE (attestation)
|-- Encrypted credentials + job --> Virtuals relay (claw-api)
|-- Job lifecycle: REQUEST → NEGOTIATION → TRANSACTION → COMPLETED
|<-- Deliverable with results
skills/
├── xbird/ # MCP (local tools)
│ ├── SKILL.md # Setup + workflows + common mistakes
│ └── tools.md # 247 MCP tools reference
├── xbird-rest-api/ # REST API + x402 micropayments
│ ├── SKILL.md # Setup + auth + example + common mistakes
│ ├── endpoints.md # Full endpoint tables with pricing
│ └── x402-flow.md # Payment flow + stateless token
└── xbird-acp/ # ACP (Virtuals marketplace)
├── SKILL.md # Setup + example + common mistakes
├── encryption-flow.md # ECDH P-256 + AES-256-GCM details
└── polling.md # Job lifecycle + polling strategies
Compatibility
| Client | Install Method |
|--------|---------------|
| **Claude Code** | /plugin install checkra1neth/xbird-skill |
| **Claude Desktop** | npx @checkra1n/xbird as MCP command |
| **Cursor** | npx @checkra1n/xbird as MCP command |
| **Windsurf** | npx @checkra1n/xbird as MCP command |
| **Smithery** | npx -y @smithery/cli install @checkra1neth/xbirdmcp |