Xbird Skill

xbird——用于人工智能代理的Twitter/X

赋予AI代理的代理技能 35个推特/X工具 --阅读、搜索、发布、参与、媒体上传——跨3个集成协议。

没有Twitter开发人员帐户，没有API密钥，没有OAuth。

技能

使用哪种技能？

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)

快速安装

Claude代码插件

/plugin install checkra1neth/xbird-skill

代理技能（与35+代理合作）

npx skills add checkra1neth/xbird-skill

仅限MCP服务器

Bun（推荐） --自动检测浏览器Cookie：

claude mcp add xbird -- bunx @checkra1n/xbird

Node.js --需要一次性登录：

claude mcp add xbird -- npx @checkra1n/xbird
npx @checkra1n/xbird login  # paste auth_token + ct0 from x.com DevTools

首次运行时会自动生成支付钱包。

||面包(bunx)| Node.js(npx) | |--|---|---| | 浏览器Cookie |自动检测|需要手动登录| | 设置 |安装Bun，完成|一次 login 命令| | 初创公司 |更快|更慢（npm注册表检查）|

命令行界面

# Save Twitter credentials locally
npx @checkra1n/xbird login

运作原理

MCP（本地）

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)

xbird服务器仅验证付款。所有Twitter API调用都是从您的机器本地进行的。

REST API（无状态）

Your Backend / Agent
  |-- npx @checkra1n/xbird login  -->  generates stateless token locally
  |-- GET /api/search + token     -->  xbird server
  |  (auto via @x402/fetch)
  |..`)，根据请求解密，然后丢弃。

### ACP（虚拟协议）

Buyer Agent |-- ECDH key exchange --> xbird TEE (attestation) |-- Encrypted credentials + job --> Virtuals relay (claw-api) |-- Job lifecycle: REQUEST → NEGOTIATION → TRANSACTION → COMPLETED |<-- Deliverable with results

端到端加密凭证（ECDH P-256+AES-256-GCM）。Virtuals中继只传输不透明的密文。

## 定价

|层级|价格|示例|
|------|-------|---------|
|阅读| 0.001美元| `get_tweet`, `get_user`, `get_home_timeline` |
|搜索| 0.005美元| `search_tweets`, `get_mentions` |
|批量/写入| 0.01美元| `get_user_tweets`, `post_tweet`, `like_tweet` |
|媒体| 0.05美元| `upload_media` |

### 与X API的比较

代理会话示例-9个API调用：

|调用|xbird|X API|
|------|-------|-------|
| `search_tweets` | $0.005 | $0.100 |
| `get_tweet` ×3 | $0.003 | $0.015 |
| `get_user` | $0.001 | $0.010 |
| `get_replies` | $0.001 | $0.100 |
| `post_tweet` | $0.010 | $0.010 |
| `like_tweet` | $0.010 | $0.015 |
| `upload_media` | $0.050 | $0.010 |
| **总计** | **$0.080** | **$0.260** |

**便宜3.2倍。** X API对获取的每个资源收费-搜索返回20条推文的价格是每次推文价格的20倍。xbird对每次通话收取固定费用。

## 安全

|协议|凭据保护|
|----------|----------------------|
| **主控程序** |浏览器自动检测，永远不要离开你的机器|
| **休息x402** |完全无状态——在自包含的令牌中加密，服务器不存储任何内容|
| **ACP** |ECDH P-256+AES-256-GCM端到端加密（中继盲）|

## 技能结构

每项技能如下 [Anthropic的最佳实践](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#create-custom-slash-commands) --简洁的SKILL.md（\<500字），在单独的文件中有大量参考。

skills/ ├── xbird/ # MCP (local tools) │ ├── SKILL.md # Setup + workflows + common mistakes │ └── tools.md # 35 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

## 兼容性

|客户端|安装方法|
|--------|---------------|
| **克劳德代码** | `/plugin install checkra1neth/xbird-skill` |
| **克劳德桌面** | `npx @checkra1n/xbird` 作为MCP命令|
| **光标** | `npx @checkra1n/xbird` 作为MCP命令|
| **帆板运动** | `npx @checkra1n/xbird` 作为MCP命令|
| **史密瑟里** | `npx -y @smithery/cli install @checkra1neth/xbirdmcp` |
| **任何MCP客户端** | `bunx @checkra1n/xbird` / `npx @checkra1n/xbird` |

## 分布

|平台|安装|
|----------|---------|
| **npm** | [`@checkra1n/xbird`](https://www.npmjs.com/package/@checkra1n/xbird) |
| **Claude代码插件** | `/plugin install checkra1neth/xbird-skill` |
| **技能s.sh** | `npx skills add checkra1neth/xbird-skill` |
| **Smithery MCP** | [`@checkra1neth/xbirdmcp`](https://smithery.ai/server/checkra1neth/xbirdmcp) |
| **史密斯技能** | [`checkra1neth/xbird`](https://smithery.ai/skills/checkra1neth/xbird) |
| **技能MP** | [skillsmp.com](https://skillsmp.com/) |
| **网站** | [xbird.dev](https://xbird.dev) |

## 许可证

麻省理工学院