Frigatebird Skill
Frigatebird is a Playwright-first CLI and npm package (frigatebird) that preserves bird command ergonomics while running against X via browser session cookies.
Use This Skill When
- - The user asks for
bird-style CLI workflows on X. - The user needs posting/reply/article actions from CLI.
- The user needs list automation (
add, remove, batch, lists). - The user needs API-key-free browser-cookie operation.
Package and Install
- - npm package: INLINECODE7
- Global install: INLINECODE8
- Local use: INLINECODE9
Core Workflow
- 1. Validate auth/session:
-
frigatebird check
-
frigatebird whoami
- 2. Read flows (use JSON when scripting):
-
frigatebird read <tweet-id-or-url> --json
-
frigatebird search "<query>" --json
-
frigatebird home --json
- 3. Mutation flows:
-
frigatebird tweet "<text>"
-
frigatebird reply <tweet-id-or-url> "<text>"
-
frigatebird article "<title>" "<body>"
- 4. List automation:
-
frigatebird add "<List Name>" @handle1 @handle2
-
frigatebird remove @handle "<List Name>"
-
frigatebird batch accounts.json
- 5. For larger reads, use paging controls:
-
--all,
--max-pages,
--cursor, INLINECODE24
Feature Coverage
- - Posting/mutations:
tweet, post, reply, article, like, retweet, follow, unfollow, INLINECODE33 - Read/timelines:
read, replies, thread, search, mentions, user-tweets, home, bookmarks, likes, list-timeline, news, INLINECODE45 - Identity/health:
check, whoami, query-ids, INLINECODE49 - List automation:
add, remove, batch, lists, list, INLINECODE55
Options That Matter Most
- - Auth/cookies:
--auth-token, --ct0, --cookie-source, --chrome-profile, INLINECODE60 - Determinism/testing:
--base-url, --plain, INLINECODE63 - Pagination:
-n, --all, --max-pages, --cursor, INLINECODE68 - Output:
--json, INLINECODE70 - Media posting:
--media, INLINECODE72
Live E2E Notes
- - Standard live mutation e2e does not run premium-feature checks by default.
- Premium-feature e2e opt-in:
- INLINECODE73
Caveats
- - This tool depends on X web UI selectors; selector drift can break flows.
- INLINECODE74 is retained for command compatibility and does not drive Playwright execution.
- Some GraphQL-specific behavior from original
bird is represented as compatibility flags in Playwright mode.
Frigatebird 技能
Frigatebird 是一个以 Playwright 为核心的 CLI 工具和 npm 包(frigatebird),它保留了 bird 命令的操作习惯,同时通过浏览器会话 Cookie 在 X 平台上运行。
适用场景
- - 用户需要在 X 上使用 bird 风格的 CLI 工作流
- 用户需要通过 CLI 执行发帖/回复/文章操作
- 用户需要列表自动化管理(add、remove、batch、lists)
- 用户需要免 API 密钥的浏览器 Cookie 操作
包安装
- - npm 包:frigatebird
- 全局安装:npm install -g frigatebird
- 本地使用:npx frigatebird
核心工作流
- 1. 验证认证/会话:
- frigatebird check
- frigatebird whoami
- 2. 读取流程(脚本化时使用 JSON):
- frigatebird read
--json
- frigatebird search --json
- frigatebird home --json
- 3. 修改流程:
- frigatebird tweet
- frigatebird reply
- frigatebird article
- 4. 列表自动化:
- frigatebird add @handle1 @handle2
- frigatebird remove @handle
- frigatebird batch accounts.json
- 5. 大规模读取时使用分页控制:
- --all、--max-pages、--cursor、-n
功能覆盖
- - 发帖/修改:tweet、post、reply、article、like、retweet、follow、unfollow、unbookmark
- 读取/时间线:read、replies、thread、search、mentions、user-tweets、home、bookmarks、likes、list-timeline、news、about
- 身份/健康检查:check、whoami、query-ids、help
- 列表自动化:add、remove、batch、lists、list、refresh
最重要的选项
- - 认证/Cookie:--auth-token、--ct0、--cookie-source、--chrome-profile、--firefox-profile
- 确定性/测试:--base-url、--plain、--no-color
- 分页:-n、--all、--max-pages、--cursor、--delay
- 输出:--json、--json-full
- 媒体发布:--media、--alt
实时端到端测试说明
- - 标准实时修改端到端测试默认不运行高级功能检查。
- 高级功能端到端测试可选加入:
- npm run test:e2e:live -- --list-name --enable-premium-features-e2e --article-cookie-source chrome --article-expected-handle-prefix
注意事项
- - 此工具依赖 X 网页 UI 选择器;选择器漂移可能导致流程中断。
- query-ids 为保持命令兼容性而保留,不驱动 Playwright 执行。
- 原始 bird 中某些 GraphQL 特定行为在 Playwright 模式下以兼容性标志形式呈现。