Twitter Publisher

通过 bird CLI 与 Twitter/X 交互，支持发推、回复、读取和搜索。

前置要求

安装 bird CLI：

bash

npm install -g @steipete/bird
# 或 bunx @steipete/bird <command>

认证

bird 使用浏览器 cookie 认证（无需 API key），按以下优先级获取凭证：

•CLI flags: --auth-token, --ct0
•环境变量: AUTH_TOKEN, CT0
•浏览器 cookies（自动提取）

验证认证状态：

bash

bird whoami    # 显示当前登录账户
bird check     # 显示凭证来源

核心操作

发布推文

bash

# 纯文本
bird tweet "推文内容"

# 附带媒体（最多4张图片或1个视频）
bird tweet "内容" --media image.png --alt "图片描述"
bird tweet "内容" --media img1.png --media img2.png

# 支持格式：jpg, jpeg, png, webp, gif, mp4, mov

回复推文

bash

bird reply <tweet-id-or-url> "回复内容"
bird reply https://x.com/user/status/123456789 "回复内容"
bird reply 123456789 "回复内容" --media image.png

读取推文

bash

bird read <tweet-id-or-url>           # 文本输出
bird read <url> --json                # JSON 输出
bird <tweet-id>                       # 简写形式
bird thread <url>                     # 完整对话线程
bird replies <url>                    # 查看回复

搜索与查询

bash

bird search "关键词" -n 10            # 搜索推文
bird search "from:username" -n 5      # 搜索特定用户
bird mentions -n 10                   # 查看提及
bird mentions --user @handle -n 5     # 查看他人被提及
bird bookmarks -n 10                  # 查看收藏
bird likes -n 10                      # 查看喜欢

用户关系

bash

bird following -n 20                  # 我关注的人
bird followers -n 20                  # 关注我的人
bird following --user <userId> -n 10  # 指定用户关注的人

常用选项

选项	说明
`--json`	JSON 格式输出
`--plain`	稳定输出（无 emoji、无颜色）
`-n <count>`	返回数量
`--timeout <ms>`	请求超时
`--cookie-source <browser>`	指定浏览器：safari/chrome/firefox

JSON 输出结构

推文对象包含：id, text, author, authorId, createdAt, replyCount, retweetCount, likeCount, conversationId, inReplyToStatusId, quotedTweet

错误处理

•GraphQL 错误 226：自动回退到 legacy API
•Query ID 过期：使用 bird query-ids --fresh 刷新
•429 限流：等待后重试

工作流示例

发布带图推文：

bash

# 1. 准备图片
# 2. 发布
bird tweet "分享今天的成果！" --media screenshot.png --alt "项目截图"

监控并回复提及：

bash

# 1. 获取提及
bird mentions -n 5 --json > mentions.json
# 2. 处理并回复
bird reply <tweet-id> "感谢反馈！"

搜索并分析：

bash

bird search "关键词 lang:zh" -n 20 --json