Bird Twitter Skill 🐦
Fast Twitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline via Twitter's GraphQL API.
Required Environment Variables
CODEBLOCK0
How to Get Tokens
- 1. Log in to Twitter/X in your browser
- Open Developer Tools (F12)
- Go to Application/Storage → Cookies → twitter.com
- Copy:
-
auth_token →
AUTH_TOKEN
-
ct0 → INLINECODE4
Quick Usage
CODEBLOCK1
Commands
Posting
| Command | Description |
|---|
| INLINECODE5 | Post a new tweet |
| INLINECODE6 |
Reply to a tweet |
|
bird tweet <text> --media <path> | Tweet with media (up to 4 images or 1 video) |
Reading
| Command | Description |
|---|
| INLINECODE8 | Read/fetch a tweet |
| INLINECODE9 |
Show full conversation thread |
|
bird replies <url> | List replies to a tweet |
|
bird user-tweets <handle> | Get user's tweets |
Timelines
| Command | Description |
|---|
| INLINECODE12 | Home timeline ("For You" feed) |
| INLINECODE13 |
Tweets mentioning you |
|
bird likes | Your liked tweets |
|
bird bookmarks | Your bookmarked tweets |
Search & Discovery
| Command | Description |
|---|
| INLINECODE16 | Search tweets |
| INLINECODE17 |
AI-curated news from Explore |
|
bird trending | Trending topics |
Account Management
| Command | Description |
|---|
| INLINECODE19 | Show logged-in account |
| INLINECODE20 |
Check credential availability |
|
bird follow <user> | Follow a user |
|
bird unfollow <user> | Unfollow a user |
|
bird followers | List your followers |
|
bird following | List users you follow |
|
bird lists | Your Twitter lists |
Output Options
| Option | Description |
|---|
| INLINECODE26 | JSON output |
| INLINECODE27 |
Include raw API response |
|
--plain | Plain text (no emoji, no color) |
|
--no-emoji | Disable emoji |
|
--no-color | Disable ANSI colors |
|
--timeout <ms> | Request timeout |
Configuration
Reads from:
- - INLINECODE32
- INLINECODE33
Supports: chromeProfile, firefoxProfile, cookieTimeoutMs, timeoutMs, INLINECODE38
Environment Variables
| Variable | Description |
|---|
| INLINECODE39 | Required — Twitter auth_token cookie |
| INLINECODE40 |
Required — Twitter ct0 cookie |
|
NO_COLOR | Disable colors |
|
BIRD_TIMEOUT_MS | Default timeout |
|
BIRD_COOKIE_TIMEOUT_MS | Cookie extraction timeout |
|
BIRD_QUOTE_DEPTH | Max quoted tweet depth |
Examples
CODEBLOCK2
Troubleshooting
401 Unauthorized
Check that
AUTH_TOKEN and
CT0 are set and valid. Run
bird check to verify.
Token Expired
Twitter tokens expire periodically. Re-copy from browser cookies.
Rate Limited
Twitter GraphQL API has rate limits. Wait a few minutes and retry.
TL;DR: Fast Twitter/X CLI via bird. Set
AUTH_TOKEN and
CT0, then tweet, read, search, and manage your timeline!
Bird Twitter 技能 🐦
使用 bird 快速操作 Twitter/X 的命令行工具 — 通过 Twitter 的 GraphQL API 发布推文、回复、阅读、搜索和管理时间线。
所需环境变量
bash
export AUTH_TOKEN=<你的推特认证令牌>
export CT0=<你的推特ct0 cookie>
如何获取令牌
- 1. 在浏览器中登录 Twitter/X
- 打开开发者工具 (F12)
- 进入 应用/存储 → Cookies → twitter.com
- 复制:
- auth
token → AUTHTOKEN
- ct0 → CT0
快速使用
bash
检查登录状态
bird whoami
检查凭证可用性
bird check
发布推文
bird tweet 来自 bird-twitter 技能的问候!
回复推文
bird reply <推文ID或链接> 精彩的讨论!
阅读推文
bird read <推文ID或链接>
以 JSON 格式阅读
bird read <推文ID或链接> --json
搜索推文
bird search 查询内容
获取首页时间线
bird home
获取提及
bird mentions
获取点赞的推文
bird likes
关注用户
bird follow <用户名>
获取用户的推文
bird user-tweets <用户句柄>
获取热门话题
bird news
bird trending
命令
发布
| 命令 | 描述 |
|---|
| bird tweet <文本> | 发布新推文 |
| bird reply <链接> <文本> |
回复推文 |
| bird tweet <文本> --media <路径> | 发布带媒体的推文(最多4张图片或1个视频) |
阅读
| 命令 | 描述 |
|---|
| bird read <链接> | 阅读/获取推文 |
| bird thread <链接> |
显示完整对话线程 |
| bird replies <链接> | 列出推文的回复 |
| bird user-tweets <句柄> | 获取用户的推文 |
时间线
| 命令 | 描述 |
|---|
| bird home | 首页时间线(为你推荐信息流) |
| bird mentions |
提及你的推文 |
| bird likes | 你点赞的推文 |
| bird bookmarks | 你收藏的推文 |
搜索与发现
| 命令 | 描述 |
|---|
| bird search <查询> | 搜索推文 |
| bird news |
来自探索页面的AI精选新闻 |
| bird trending | 热门话题 |
账号管理
| 命令 | 描述 |
|---|
| bird whoami | 显示已登录账号 |
| bird check |
检查凭证可用性 |
| bird follow <用户> | 关注用户 |
| bird unfollow <用户> | 取消关注用户 |
| bird followers | 列出你的粉丝 |
| bird following | 列出你关注的用户 |
| bird lists | 你的Twitter列表 |
输出选项
| 选项 | 描述 |
|---|
| --json | JSON 输出 |
| --json-full |
包含原始 API 响应 |
| --plain | 纯文本(无表情符号,无颜色) |
| --no-emoji | 禁用表情符号 |
| --no-color | 禁用 ANSI 颜色 |
| --timeout <毫秒> | 请求超时 |
配置
读取自:
- - ~/.config/bird/config.json5
- ./.birdrc.json5
支持:chromeProfile、firefoxProfile、cookieTimeoutMs、timeoutMs、quoteDepth
环境变量
| 变量 | 描述 |
|---|
| AUTHTOKEN | 必需 — Twitter authtoken cookie |
| CT0 |
必需 — Twitter ct0 cookie |
| NO_COLOR | 禁用颜色 |
| BIRD
TIMEOUTMS | 默认超时 |
| BIRD
COOKIETIMEOUT_MS | Cookie 提取超时 |
| BIRD
QUOTEDEPTH | 最大引用推文深度 |
示例
bash
检查登录状态
bird whoami
发布简单推文
bird tweet 来自 OpenClaw 的问候!
发布带图片的推文
bird tweet 看看这个! --media ./image.png
回复推文
bird reply 1234567890123456789 感谢分享!
搜索关于 AI 的推文
bird search 人工智能 --json
获取首页时间线
bird home -n 20
阅读推文线程
bird thread https://x.com/user/status/1234567890
获取热门话题
bird trending
故障排除
401 未授权
检查 AUTH_TOKEN 和 CT0 是否已设置且有效。运行 bird check 验证。
令牌过期
Twitter 令牌会定期过期。重新从浏览器 cookies 复制。
请求频率限制
Twitter GraphQL API 有请求频率限制。等待几分钟后重试。
总结:通过 bird 快速操作 Twitter/X 的命令行工具。设置 AUTH_TOKEN 和 CT0,然后发布、阅读、搜索和管理你的时间线!