| name | twitter-publisher |
| description | 通过 bird CLI 发布和管理 Twitter/X 内容。使用此 skill 当用户需要：(1) 发布推文或帖子，(2) 回复推文，(3) 读取或获取推文内容，(4) 搜索推文，(5) 查看 mentions/bookmarks/likes，(6) 附带图片或视频发推。触发词包括：发推、tweet、发帖、回复推文、读取推文、Twitter、X 平台。 |
Twitter Publisher
通过 bird CLI 与 Twitter/X 交互，支持发推、回复、读取和搜索。
前置要求
安装 bird CLI：
npm install -g @steipete/bird
认证
bird 使用浏览器 cookie 认证（无需 API key），按以下优先级获取凭证：
- CLI flags:
--auth-token, --ct0
- 环境变量:
AUTH_TOKEN, CT0
- 浏览器 cookies（自动提取）
验证认证状态：
bird whoami
bird check
核心操作
发布推文
bird tweet "推文内容"
bird tweet "内容" --media image.png --alt "图片描述"
bird tweet "内容" --media img1.png --media img2.png
回复推文
bird reply <tweet-id-or-url> "回复内容"
bird reply https://x.com/user/status/123456789 "回复内容"
bird reply 123456789 "回复内容" --media image.png
读取推文
bird read <tweet-id-or-url>
bird read <url> --json
bird <tweet-id>
bird thread <url>
bird replies <url>
搜索与查询
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
用户关系
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 限流：等待后重试
工作流示例
发布带图推文：
bird tweet "分享今天的成果！" --media screenshot.png --alt "项目截图"
监控并回复提及：
bird mentions -n 5 --json > mentions.json
bird reply <tweet-id> "感谢反馈！"
搜索并分析：
bird search "关键词 lang:zh" -n 20 --json
