Twitter/X skill for AI agents — works with Claude Code, Cursor, Windsurf and 35+ agents. Powered by xbird-mcp.
概览
Agent skills that give AI agents — reading, searching, posting, engagement, media upload — across 3 integration protocols. No Twitter developer account, no API keys, no OAuth. A payment wallet is generated automatically on first run. The xbird server only verifies payments. All Twitter API calls happen locally from your machine. Fully stateless server — no database, no stored credentials. The token is self-contained (xbird_sk_ . . ), decrypted per-request then discarded. End-to-end encrypted credentials (ECDH P-256 + AES-256-GCM). The Virtuals relay transports only opaque ciphertext. Resource catalog billing (~2× cheaper than X API pay-per-use per unit): Example session (9 calls, count=20 on search/lists):
README
以下为原文 README 节选，完整内容请查看原文。
xbird — Twitter/X for AI Agents
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?
Running in Claude Code / Cursor / Windsurf?
→ xbird (MCP)
Building a backend service or autonomous agent?
→ xbird-rest-api (x402 micropayments, USDC on Base)
Operating on Virtuals Protocol marketplace?
→ xbird-acp (E2E encrypted credentials, ECDH + AES-256-GCM)
Quick Install
Claude Code Plugin
/plugin install checkra1neth/xbird-skill
Agent Skill (works with 35+ agents)
npx skills add checkra1neth/xbird-skill
MCP Server Only
Bun (recommended) — auto-detects browser cookies:
claude mcp add xbird -- bunx @checkra1n/xbird
Node.js — requires one-time login:
claude mcp add xbird -- npx @checkra1n/xbird
npx @checkra1n/xbird login # paste auth_token + ct0 from x.com DevTools
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
# Save Twitter credentials locally
npx @checkra1n/xbird login
How It Works
MCP (Local)
AI Agent (Claude Code / Cursor / Windsurf)
| MCP stdio
@checkra1n/xbird (local process)
|-- Auto-detect Twitter cookies from browser
|-- Pay x402 --> xbird server (payment only)
'-- Execute --> Twitter API (your residential IP)
The xbird server only verifies payments. All Twitter API calls happen locally from your machine.
REST API (Stateless)
Your Backend / Agent
|-- npx @checkra1n/xbird login --> generates stateless token locally推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add checkra1neth/xbird-skill