Skip to main content
xurl は X API 向けの curl 風コマンドラインツールです。OAuth 認証を自動的に処理するため、トークンを手動で管理したりリクエストに署名したりすることなく API リクエストを実行できます。

GitHub repository

ソースコード、リリース、ドキュメント。

​
インストール

Go でインストールするか、releases からビルド済みバイナリをダウンロードします。

​
セットアップ

​
1. X アプリを作成する

xurl はあなた自身の開発者アプリを使って認証します。X 開発者ポータル で:
  1. OAuth 2.0 を有効にしたアプリを作成(または既存のものを開く)します。
  2. リダイレクト URI http://localhost:8080/callback をアプリに登録します。
  3. アプリの “Keys and tokens” ページから Client ID と Client Secret をコピーします。

​
2. 資格情報を設定する

xurl を実行するのと同じシェルで、資格情報をエクスポートします:

​
3. 認可する

これによりブラウザベースの OAuth フローが開きます。認可が完了すると、xurl はトークンをローカルの ~/.xurl に保存するため、再度認証する必要はありません。
ブラウザに “Something went wrong — You weren’t able to give access to the App” と表示された場合、xurl は有効な資格情報のないままログインを開始してしまっています。xurl auth oauth2 を実行したシェルで CLIENT_ID と CLIENT_SECRET がエクスポートされていること、また http://localhost:8080/callback がアプリのリダイレクト URI として登録されていることを確認してください。

​
使い方

​
生の API リクエスト

curl と同じように xurl を使えます — 認証ヘッダーは自動的に処理されます:

​
ショートカットコマンド

xurl には一般的な操作用の組み込みショートカットが含まれています:

​
なぜ xurl を使うのか?

​
xurl を AI エージェントとともに使う

xurl には、その機能を機械可読な形式で記述する SKILL.md ファイルが含まれています。AI エージェントはこれを利用して、あなたに代わって xurl コマンドを実行する方法を理解できます。

​
関連情報

最初のリクエストを送信する

cURL または SDK を使って X API を始めましょう。

API Playground

モックデータを使ってローカルでエンドポイントをテスト — API クレジット不要。