xurl

• AIエージェントや自動化スクリプトを使って、Xにツイート、リプライ、または引用投稿を行いたい場合。
• プログラムで最近の投稿を検索したり、タイムラインを読んだり、メンションを監視したりしたい場合。
• スクリプトを通じてソーシャルグラフのアクション（フォロー、フォロー解除、ブロック、ミュート）を管理したり、ダイレクトメッセージを送信したりする必要がある場合。
• カスタムAPIクライアントコードを書かずに、メディア（画像、動画）をアップロードして投稿に添付したい場合。

• レガシーな X API v1.1 エンドポイントを操作する必要がある場合 — xurl は v2 のみを対象としています。
• ~/.xurl への認証情報の保存が安全でない、または実行不可能なサンドボックス環境や共有環境にいる場合。
• X アカウントを管理するためのグラフィカルまたはノーコードのインターフェースが必要な場合。

投稿、返信、引用、削除、検索、いいね、リポスト、ブックマーク、フォロー、ブロック、ミュート、DM送信、メディアアップロードに対応した既製のワンライナーコマンドを提供します。日常的なタスクのために生のAPIペイロードを構築する必要はありません。

ショートカット機能にとどまらず、xurl は汎用的な X API クライアントとして機能します。xurl /2/some/endpoint を -X、-d、-H フラグと組み合わせることで、認証を自動的に処理しながら、curl と同じ感覚であらゆる v2 エンドポイントにアクセスできます。

複数のXアプリを登録し、アプリごとに複数のOAuth 2.0アカウントを認証できます。xurl auth default で切り替えるか、--app および --username フラグでリクエストごとに上書きすることができます。

xurl media upload を使用して画像または動画をアップロードし、返された media_id を投稿または返信に直接添付します。動画の処理ステータスは xurl media status --wait でポーリングできます。

既知のストリーミングエンドポイント（例：/2/tweets/search/stream、/2/tweets/sample/stream）は自動検出され、正しく処理されます。任意のエンドポイントは -s フラグを使用してストリーミングモードに強制することができます。

認証情報は ~/.xurl にローカル保存され、インラインで渡す必要は一切ありません。このツールはインラインシークレットの厳格な禁止ポリシーを適用しており、プロンプトやコンテキストの漏洩リスクが存在するAIエージェントやLLMワークフロー内での使用をより安全にします。

エージェントは xurl search でトピックに関する投稿を検索し、xurl read でコンテキストを読み取り、最も関連性の高い結果に返信またはいいねをすることができます。これらすべてが、各ステップで構造化されたJSONを使用した単一の連鎖ワークフローとして実行されます。

xurl media upload を使って準備した画像をアップロードし、JSONレスポンスから media_id を取得したら、すぐに新しい投稿に添付します — これにより、メディアリッチな完全自動化パブリッシングパイプラインが実現できます。

xurl mentions、xurl timeline、xurl followers、xurl dms を使用して、メンション、ホームタイムライン、新しいフォロワー、DM を定期的に確認し、監視ダッシュボードや通知ボットを構築しましょう。

開発用と本番用のアプリを個別に登録し、それぞれ独立して認証を行い、xurl auth default またはリクエストごとの --app オーバーライドを使って切り替えることができます。認証情報が混在することはありません。