bird 🐦

GraphQL + クッキー認証を使用した高速 X/Twitter CLI。

インストール

# npm/pnpm/bun
npm install -g @steipete/bird

# Homebrew (macOS, プリビルドバイナリ)
brew install steipete/tap/bird

# ワンショット（インストール不要）
bunx @steipete/bird whoami

認証

bird はクッキーベースの認証を使用します。

--auth-token / --ct0 でクッキーを直接渡すか、--cookie-source でブラウザのクッキーを使用できます。

bird check を実行してどのソースがアクティブかを確認します。Arc/Brave の場合は、--chrome-profile-dir <path> を使用します。

コマンド

アカウントと認証

bird whoami                    # ログイン中のアカウントを表示
bird check                     # 認証情報のソースを表示
bird query-ids --fresh         # GraphQL クエリ ID キャッシュを更新

ツイートを読む

bird read <url-or-id>          # 単一のツイートを読む
bird <url-or-id>               # read の短縮形
bird thread <url-or-id>        # 完全な会話スレッド
bird replies <url-or-id>       # ツイートへのリプライ一覧

タイムライン

bird home                      # ホームタイムライン（おすすめ）
bird home --following          # フォロー中タイムライン
bird user-tweets @handle -n 20 # ユーザープロフィールタイムライン
bird mentions                  # あなたにメンションされたツイート
bird mentions --user @handle   # 別のユーザーへのメンション

検索

bird search "query" -n 10
bird search "from:steipete" --all --max-pages 3

ニュースとトレンド

bird news -n 10                # 探索タブから AI キュレーション
bird news --ai-only            # AI キュレーションのみをフィルタ
bird news --sports             # スポーツタブ
bird news --with-tweets        # 関連ツイートを含める
bird trending                  # news のエイリアス

リスト

bird lists                     # あなたのリスト
bird lists --member-of         # メンバーとなっているリスト
bird list-timeline <id> -n 20  # リストからのツイート

ブックマークとライク

bird bookmarks -n 10
bird bookmarks --folder-id <id>           # 特定のフォルダ
bird bookmarks --include-parent           # 親ツイートを含める
bird bookmarks --author-chain             # 作成者の自己リプライチェーン
bird bookmarks --full-chain-only          # 完全なリプライチェーン
bird unbookmark <url-or-id>
bird likes -n 10

ソーシャルグラフ

bird following -n 20           # フォロー中のユーザー
bird followers -n 20           # フォロワー
bird following --user <id>     # 別のユーザーのフォロー一覧
bird about @handle             # アカウント情報と位置情報

エンゲージメント アクション

bird follow @handle            # ユーザーをフォロー
bird unfollow @handle          # ユーザーをアンフォロー

投稿

bird tweet "hello world"
bird reply <url-or-id> "nice thread!"
bird tweet "check this out" --media image.png --alt "description"

⚠️ 投稿のリスク: 投稿はレート制限を受けやすくなります。ブロックされた場合は、ブラウザツールを使用してください。

メディア アップロード

bird tweet "hi" --media img.png --alt "description"
bird tweet "pics" --media a.jpg --media b.jpg  # 最大 4 枚の画像
bird tweet "video" --media clip.mp4            # または 1 個のビデオ

ページネーション

ページネーションをサポートするコマンド: replies、thread、search、bookmarks、likes、list-timeline、following、followers、user-tweets

bird bookmarks --all                    # すべてのページを取得
bird bookmarks --max-pages 3            # ページ数を制限
bird bookmarks --cursor <cursor>        # カーソルから再開
bird replies <id> --all --delay 1000    # ページ間の遅延（ミリ秒）

出力オプション

--json          # JSON 出力
--json-full     # 生 API レスポンス付き JSON
--plain         # 絵文字なし、色なし（スクリプト対応）
--no-emoji      # 絵文字を無効にする
--no-color      # ANSI カラーを無効にする（または NO_COLOR=1 を設定）
--quote-depth n # JSON の引用ツイート最大深度（デフォルト: 1）

グローバルオプション

--auth-token <token>       # auth_token クッキーを設定
--ct0 <token>              # ct0 クッキーを設定
--cookie-source <source>   # ブラウザクッキーのクッキーソース（繰り返し可能）
--chrome-profile <name>    # Chrome プロファイル名
--chrome-profile-dir <path> # Chrome/Chromium プロファイルディレクトリまたはクッキー DB パス
--firefox-profile <name>   # Firefox プロファイル
--timeout <ms>             # リクエストタイムアウト
--cookie-timeout <ms>      # クッキー抽出タイムアウト

設定ファイル

~/.config/bird/config.json5（グローバル）または ./.birdrc.json5（プロジェクト）:

{
  cookieSource: ["chrome"],
  chromeProfileDir: "/path/to/Arc/Profile",
  timeoutMs: 20000,
  quoteDepth: 1,
}

環境変数: BIRD_TIMEOUT_MS、BIRD_COOKIE_TIMEOUT_MS、BIRD_QUOTE_DEPTH

トラブルシューティング

クエリ ID が古い（404 エラー）

bird query-ids --fresh

クッキー抽出が失敗する

• ブラウザが X にログインしているか確認
• 別の --cookie-source を試す
• Arc/Brave の場合: --chrome-profile-dir を使用

---

TL;DR: CLI で読む/検索/エンゲージします。投稿は慎重に、またはブラウザを使用してください。🐦