AgentSkillsCN

frigatebird

借助 frigatebird npm 包，通过类鸟式命令行接口与 X 平台交互，支持发布、回复、撰写文章，以及在无需 X API 密钥的情况下实现列表自动化。

SKILL.md
--- frontmatter
name: frigatebird
description: Use the frigatebird npm package to interact with X from the CLI with bird-style command parity, posting/reply/article support, and list automation without X API keys.
argument-hint: 'whoami, read https://x.com/user/status/123, tweet "hello", article "Launch notes" "We shipped", add "AI News" @openai @anthropicai'

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: frigatebird
  • •Global install: npm install -g frigatebird
  • •Local use: npx frigatebird <command>

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, -n

Feature Coverage

  • •Posting/mutations: tweet, post, reply, article, like, retweet, follow, unfollow, unbookmark
  • •Read/timelines: read, replies, thread, search, mentions, user-tweets, home, bookmarks, likes, list-timeline, news, about
  • •Identity/health: check, whoami, query-ids, help
  • •List automation: add, remove, batch, lists, list, refresh

Options That Matter Most

  • •Auth/cookies: --auth-token, --ct0, --cookie-source, --chrome-profile, --firefox-profile
  • •Determinism/testing: --base-url, --plain, --no-color
  • •Pagination: -n, --all, --max-pages, --cursor, --delay
  • •Output: --json, --json-full
  • •Media posting: --media, --alt

Live E2E Notes

  • •Standard live mutation e2e does not run premium-feature checks by default.
  • •Premium-feature e2e opt-in:
    • •npm run test:e2e:live -- --list-name <name> --enable-premium-features-e2e --article-cookie-source chrome --article-expected-handle-prefix <prefix>

Caveats

  • •This tool depends on X web UI selectors; selector drift can break flows.
  • •query-ids 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.