twitter-cli

twitter-cli skill の概要

twitter-cli skill でできること

twitter-cli は、タイムライン、ブックマーク、検索結果、プロフィール、ツイート詳細をターミナル中心で扱う Twitter/X skill です。認証済みであれば投稿やその他の書き込み操作にも対応します。Webアプリの代わりに CLI ワークフローを使いたい人、特に Social Media 調査、アカウント監視、軽量な投稿作業に向いています。

どんな人に向いているか

twitter-cli skill は、コマンドラインから Twitter/X のデータを確認したい人、定型的な読み取り作業を自動化したい人、後続処理向けに構造化された出力を作りたい人に向いています。目的が「素早く取得してターミナルで見ること」であって、フル機能のソーシャルメディアダッシュボードではない場合に強い選択肢です。

この skill が他と違う理由

導入判断でいちばん重要なのは認証です。twitter-cli は API keys がなくても動作しますが、書き込み操作は有効なブラウザ cookies に依存し、部分的な env vars だけでは失敗することがあります。つまり、twitter-cli の install 判断は、ユーザーがきれいに認証できるかどうか、そして読み取り専用か読み書き両方か、に大きく左右されます。

twitter-cli skill の使い方

twitter-cli をインストールする

twitter-cli skill のインストールは次のコマンドで行います:
npx skills add public-clis/twitter-cli --skill twitter-cli

インストール後に実際に見るべき twitter-cli install の判断材料は、対象環境で Python 3.10+、uv、または pipx が使えるかどうかです。リポジトリのセットアップ方針は、ブラウザ拡張やホスト型サービスではなく、Python の CLI インストールを前提にしています。

まず認証を確認する

本格的に twitter-cli usage を始める前に、最初に status を確認してください。リポジトリのワークフローは明確で、まず認証情報の有無を確認してから進めます。

最初の確認コマンド:
twitter status --yaml

status が unauthenticated を返した場合は、投稿・返信・いいねを試す前に、ブラウザ cookies の抽出や、対応している別の認証手段へ案内してください。これは、twitter-cli の書き込み操作こそが、認証の弱さで導入が止まりやすいからです。

タスクを良いプロンプトに落とし込む

良い twitter-cli guide のプロンプトは、次の要素をはっきり指定しているべきです:

• 対象アクション: read, search, post, reply, quote, like, retweet, follow, lookup
• 対象オブジェクト: username、tweet ID、keyword、list、timeline type
• 出力形式: terminal view、--yaml、--json
• 条件: date range、search tab、full text、retweets を除外するかどうか

リクエストの形の例:
“twitter-cli を使って open source LLM を Latest で検索し、--yaml で返し、上位5件を authors と URLs 付きで要約してください。”

先に読むべきファイル

リポジトリを素早く把握するには、以下を優先してください:

• SKILL.md — コマンドと認証ルール
• README.md — 機能範囲と使用例
• SCHEMA.md — 構造化出力の形
• AGENTS.md — 開発・テストの文脈
• twitter_cli/cli.py と twitter_cli/auth.py — コマンドの入口とログイン挙動

twitter-cli skill のFAQ

twitter-cli は Twitter/X の読み取り専用ですか？

いいえ。twitter-cli skill は読み取りと書き込みの両方をサポートしていますが、書き込み操作は認証品質の影響を受けやすく、env vars だけでなくブラウザ cookies が必要になることがあります。

API keys は必要ですか？

基本的な twitter-cli ワークフローでは、通常 API keys は不要です。リポジトリは browser-cookie ベースの認証と CLI 主導のアクセスを前提にしており、開発者向けアプリのセットアップなしで素早く Social Media 操作をしたい人に向いています。

どんな場合は twitter-cli を使わないほうがいいですか？

高頻度・大量の自動化、API の安定性保証、ターミナル以外のワークフローが必要なら、twitter-cli は避けたほうがいいです。対応ブラウザで認証できないアカウントや、無人での書き込みアクセスが前提のタスクにも向きません。

初心者でも使いやすいですか？

はい、タスクがシンプルで、対応ブラウザで X にログインできるなら使いやすいです。初心者がつまずきやすいのは、認証確認の前にコマンドが動く前提で進めてしまうことです。最初に auth を確認すれば、かなり扱いやすくなります。

twitter-cli skill を改善するには

最小限で完結する対象を伝える

twitter-cli の出力品質を上げるコツは、who、what、how many を明確にすることです。たとえば “Find recent posts about AI agents from @example” は “search Twitter” よりもずっと良い指定です。これなら、skill が適切な command path を選びやすくなり、ノイズも減らせます。

出力条件を先に指定する

より良い twitter-cli usage を求めるなら、全文が必要か、構造化出力が必要か、簡潔なターミナル要約で十分かを先に伝えてください。たとえば、結果を後で parse するなら --yaml が向いており、画面で確認するならリッチな table 出力のほうが見やすいです。

認証と環境の制約を共有する

セッションがすでにログイン済みか、browser cookies が使えるか、対応ブラウザを開けるかを伝えてください。そうした制約は、ツイート内容そのもの以上に、推奨される twitter-cli install と実行経路を左右します。

コマンドの形より結果の質で調整する

最初の実行で欲しい結果に届かない場合は、リクエスト全体を書き直すのではなく、検索語、著者フィルター、時間範囲、出力形式を調整してください。twitter-cli skill では、たいてい scope を絞り、欲しい data shape を明確にすることが、いちばん大きな改善につながります。