mcpField
X
xurl

xurl

github.com/steipeteその他7.4k106 回インストール1 週間前に更新
リポジトリ

xurl について

xurlは、X APIの公式コマンドラインツールで、ユーザーやエージェントが認証付きリクエストを実行できます。投稿や読み取りのショートカットに加え、APIエンドポイントへの直接リクエストと複数の認証方式に対応します。

主な機能

  1. 01投稿、返信、引用、削除、投稿の読み取り
  2. 02投稿の検索と現在のアカウントの確認
  3. 03APIエンドポイントへの直接リクエスト
  4. 04OAuth 1.0a、OAuth 2.0、アプリ認証の選択
  5. 05登録済みアプリとアカウントの選択
  6. 06ストリーミングエンドポイントへのアクセス

活用シーン

  1. 01コマンドラインから投稿や返信
  2. 02クエリによるX投稿の検索
  3. 03選択した認証方式でX APIエンドポイントを呼び出し
  4. 04X APIのストリーミングデータを読み取り

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/steipete/agent-scripts --skill xurl

インストール後、Claude Code で/xurlを入力して読み込まれたか確認します。

詳細

xurl

X API の公式 CLI です。

主なアップストリーム：https://github.com/xdevplatform/xurl

インストール

Homebrew：

brew install --cask xdevplatform/tap/xurl

npm：

npm install -g @xdevplatform/xurl

シェルスクリプト：

curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash

Go：

go install github.com/xdevplatform/xurl@latest

安全性

  • ~/.xurl を読み取ったり、表示、要約、アップロードしたり、LLM のコンテキストに貼り付けたりしないでください。
  • クライアントシークレット、ベアラートークン、OAuth トークンをチャットに貼り付けるよう、ユーザーに求めないでください。
  • エージェントの実行中に --verbose を使用しないでください。認証ヘッダーが露出する可能性があります。
  • エージェントセッション中に、シークレットをインラインで指定する認証コマンドを実行しないでください。
  • ユーザーはエージェントセッションの外で、自分のマシン上でアプリの認証情報を手動で登録する必要があります。

認証

現在の状態を確認します：

xurl auth status

アプリがすでに登録されている場合は、OAuth 2.0 を完了します：

xurl auth oauth2

複数のアプリ：

xurl auth apps list
xurl auth default my-app
xurl auth default my-app alice
xurl --app dev-app /2/users/me

注意事項：

  • xurl はアプリの設定とトークンを ~/.xurl に保存します。
  • X 開発者ポータルでの OAuth 2.0 リダイレクト URI は http://localhost:8080/callback にしてください。
  • シークレットをインラインで指定するアプリ登録の例は、意図的に省略しています。エージェントセッションの外で行ってください。

よく使うショートカット

xurl post "Hello world!"
xurl reply 1234567890 "Nice post"
xurl quote 1234567890 "My take"
xurl delete 1234567890

xurl read 1234567890
xurl search "from:elonmusk" -n 10
xurl whoami
xurl user @XDevelopers
xurl timeline -n 20
xurl mentions -n 10

xurl like 1234567890
xurl unlike 1234567890
xurl repost 1234567890
xurl unrepost 1234567890

xurl bookmark 1234567890
xurl unbookmark 1234567890
xurl bookmarks -n 10
xurl likes -n 10

xurl follow @handle
xurl unfollow @handle
xurl following -n 20
xurl followers -n 20

xurl dm @handle "message"
xurl dms -n 10

xurl media upload path/to/file.mp4
xurl media status MEDIA_ID

POST_ID には、X の投稿の完全な URL も指定できます。

生のエンドポイントモード

GET：

xurl /2/users/me

POST JSON：

xurl -X POST /2/tweets -d '{"text":"Hello world!"}'

ヘッダー：

xurl -H "Content-Type: application/json" /2/tweets

認証タイプを選択します：

xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me

OAuth2 アカウントを選択します：

xurl --username alice /2/users/me

ストリーミング：

xurl /2/tweets/search/stream
xurl -s /2/users/me

簡単な確認

インストール：

xurl version

認証：

xurl auth status

認証後のライブリクエスト：

xurl whoami

コメント

Markdown 対応