AI导哈

Twitter/X代理工具

xbird提供无需Twitter开发者账户或API密钥的AI代理工具，支持阅读、搜索、发布和媒体上传等多种Twitter/X操作，适用于本地MCP工具、后端服务和虚拟市场等多种场景。

  • by checkra1neth
  • 本地部署
  • 15 星标
  • 更新于
在 GitHub 查看 checkra1neth/xbird-skill

使用说明

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

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

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

技能

技能 协议 最适合
xbird MCP（stdio） 克劳德代码、光标、风帆——本地MCP工具
xbird休息api REST+x402 后端服务、自主代理、任何HTTP客户端
xbird acp ACP（虚拟） 虚拟协议市场上的代理对代理商务

使用哪种技能？

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
  |<-- 402 Payment Required       <--  (challenge)
  |-- x-payment header (signed)   -->  (auto via @x402/fetch)
  |<-- 200 { data, cursor }       <--  (result)

完全无状态的服务器——没有数据库，没有存储的凭据。令牌是自包含的(xbird_sk_<key>.<ciphertext>.<iv>)，根据请求解密，然后丢弃。

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中继只传输不透明的密文。

定价

资源目录计费（约2倍于X API每单位使用付费）：

资源 费率/单位 计数感知 示例
post_read 0.0025美元 是（默认值为20，最大值为100） get_tweet, search_tweets, get_replies
user_read 0.005美元 是 get_user, get_followers
owned_read 0.001美元 是 get_bookmarks, get_home_timeline
post_create 0.0075美元 否 post_tweet, reply_to_tweet
interaction_create 0.0075美元 否 like_tweet, follow_user
content_create 0.005美元 否 upload_media

与X API的比较

示例会话（9个呼叫， count=20 在搜索/列表上）：

调用 xbird X API
search_tweets 计数=20 0.05美元 0.10美元
get_tweet ×3 $0.0075 $0.015
get_user $0.005 $0.010
get_replies 计数=20 0.05美元 0.10美元
post_tweet $0.0075 $0.015
like_tweet $0.0075 $0.015
upload_media $0.005 $0.015
总计 ~$0.13 ~$0.26

每资源单位的账单——四分之一单位费率都低了2倍。

安全

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

技能结构

每项技能如下 Anthropic的最佳实践 --简洁的SKILL.md（<500字），在单独的文件中有大量参考。

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

兼容性

客户端 安装方法
克劳德代码 /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
Claude代码插件 /plugin install checkra1neth/xbird-skill
技能s.sh npx skills add checkra1neth/xbird-skill
Smithery MCP @checkra1neth/xbirdmcp
史密斯技能 checkra1neth/xbird
技能MP skillsmp.com
网站 xbird.dev

许可证

麻省理工学院

相关 MCP