Xitter Φ x-cli 経由で X/Twitter を利用

ターミナルから公式 X/Twitter API を操作するために x-cli を使用します。

このスキルは以下の用途に対応しています：

• ツイート、返信、引用ツイートの投稿
• ツイートの検索とタイムラインの閲覧
• ユーザー、フォロワー、フォロー中のユーザーの検索
• ツイートのいいね とリツイート
• メンションとブックマークの確認

このスキルは IO に独立した CLI 実装を含めません。代わりに、アップストリーム x-cli をインストール・使用してください。

重要：コスト / アクセスに関する注意

X API のアクセスは、実際の利用ではほぼ無料ではありません。有料またはプリペイドの X デベロッパーアクセスが必要になることを想定してください。コマンドが権限またはクォータエラーで失敗する場合は、まず X デベロッパープランを確認してください。

インストール

uv を使用してアップストリーム x-cli をインストールします：

uv tool install git+https://github.com/Infatoshi/x-cli.git

後で以下でアップグレードします：

uv tool upgrade x-cli

検証：

x-cli --help

認証情報

X デベロッパーポータルから以下の 5 つの値が必要です：

• X_API_KEY
• X_API_SECRET
• X_BEARER_TOKEN
• X_ACCESS_TOKEN
• X_ACCESS_TOKEN_SECRET

以下から取得できます：

• https://developer.x.com/en/portal/dashboard

X がなぜ 5 つのシークレットを必要とするのか？

残念ながら、公式 X API は、アプリレベルとユーザーレベルの認証情報に分かれています：

• X_API_KEY + X_API_SECRET はアプリを識別します
• X_BEARER_TOKEN はアプリレベルの読み取りアクセスに使用されます
• X_ACCESS_TOKEN + X_ACCESS_TOKEN_SECRET は、CLI があなたのユーザーアカウントとして書き込みと認証アクションを実行することを可能にします

つまり、1 つの統合に対して多くのシークレットになりますが、これは安定した公式 API パスであり、クッキー/セッションスクレイピングより優れています。

ポータルでのセットアップ要件：

1. アプリを作成するか、既存のアプリを開きます
2. ユーザー認証設定で、権限を Read and write に設定します
3. 書き込み権限を有効にした後、アクセストークンとアクセストークンシークレットを生成または再生成します
4. 5 つの値すべてを慎重に保存します Φ 1 つ欠けていると通常、混乱した認証または権限エラーが発生します

注：アップストリーム x-cli は、認証情報の完全なセットが存在することを期待しているため、主に読み取り専用コマンドに関心がある場合でも、5 つすべてを設定するのが最も簡単です。

コスト / 手間の現実チェック

このセットアップが思ったより重く感じられるなら、それはそうだからです。X の公式デベロッパーフローは手間がかかり、多くの場合有料です。このスキルは公式 API パスを選択します。これはブラウザクッキー/セッションアプローチより安定性と保守性が高いためです。

ユーザーが長期的に最も堅牢なセットアップを望む場合は、このスキルを使用してください。ゼロセットアップまたは非公式なパスを望む場合は、それは異なるトレードオフであり、このスキルの対象ではありません。

認証情報を保存する場所

x-cli は ~/.config/x-cli/.env で認証情報を探します。

X の認証情報を既に ~/.io/.env に保存している場合、最もシンプルなセットアップは以下です：

mkdir -p ~/.config/x-cli
ln -sf ~/.io/.env ~/.config/x-cli/.env

または専用ファイルを作成します：

mkdir -p ~/.config/x-cli
cat > ~/.config/x-cli/.env <<'EOF'
X_API_KEY=your_consumer_key
X_API_SECRET=your_secret_key
X_BEARER_TOKEN=your_bearer_token
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret
EOF
chmod 600 ~/.config/x-cli/.env

クイック検証

x-cli user get openai
x-cli tweet search "from:NousResearch" --max 3
x-cli me mentions --max 5

読み取りは動作するが書き込みが失敗する場合は、Read and write 権限を確認した後、アクセストークンを再生成してください。

よく使うコマンド

ツイート

x-cli tweet post "hello world"
x-cli tweet get https://x.com/user/status/1234567890
x-cli tweet delete 1234567890
x-cli tweet reply 1234567890 "nice post"
x-cli tweet quote 1234567890 "worth reading"
x-cli tweet search "AI agents" --max 20
x-cli tweet metrics 1234567890

ユーザー

x-cli user get openai
x-cli user timeline openai --max 10
x-cli user followers openai --max 50
x-cli user following openai --max 50

自分 / 認証済みユーザー

x-cli me mentions --max 20
x-cli me bookmarks --max 20
x-cli me bookmark 1234567890
x-cli me unbookmark 1234567890

クイックアクション

x-cli like 1234567890
x-cli retweet 1234567890

出力モード

エージェントがプログラムでフィールドを検査する必要がある場合は、構造化出力を使用します：

x-cli -j tweet search "AI agents" --max 5
x-cli -p user get openai
x-cli -md tweet get 1234567890
x-cli -v -j tweet get 1234567890

推奨デフォルト：

• -j は機械可読出力用
• -v はタイムスタンプ、メトリクス、メタデータが必要な場合
• プレーン/デフォルトモードは人間による素早い確認用

エージェントワークフロー

1. x-cli がインストールされていることを確認します
2. 認証情報が存在することを確認します
3. 読み取りコマンド（user get、tweet search、me mentions）から始めます
4. 後のステップで使用するためのフィールド抽出時に -j を使用します
5. ユーザーの意図とターゲットツイート/ユーザーを確認した後、書き込みアクションのみを実行します

落とし穴

• 有料 API アクセス：多くの失敗はコード問題ではなく、プラン/権限の問題です。
• 403 oauth1-permissions：Read and write を有効にした後、アクセストークンを再生成してください。
• 返信制限：X は多くのプログラム的な返信を制限しています。tweet quote は tweet reply より信頼性が高いことがよくあります。
• レート制限：エンドポイントごとのリミットとクールダウンウィンドウを予想してください。
• 認証情報のドリフト：~/.io/.env でトークンをローテーションする場合は、~/.config/x-cli/.env が現在のファイルを指していることを確認してください。

注釈

• クッキー/セッションスクレイピングより公式 API ワークフローを優先します。
• ツイート URL と ID は相互に使用できます Φ x-cli は両方を受け入れます。
• ブックマーク動作がアップストリームで変更された場合は、まずアップストリーム README を確認してください： https://github.com/Infatoshi/x-cli