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

GitHub repository

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

​
インストール

Go でインストールするか、releases からビルド済みバイナリをダウンロードします。 
go install github.com/xdevplatform/xurl@latest

​
セットアップ

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

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

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

xurl を実行するのと同じシェルで、資格情報をエクスポートします: 
export CLIENT_ID="your-x-app-client-id"
export CLIENT_SECRET="your-x-app-client-secret"

​
3. 認可する

xurl auth oauth2
これによりブラウザベースの 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 /2/users/by/username/xdevelopers

# 最近のポストを検索する
xurl "/2/tweets/search/recent?query=from:xdevelopers&max_results=10"

# ポストを作成する
xurl -X POST /2/tweets -d '{"text": "Hello from xurl!"}'

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

xurl には一般的な操作用の組み込みショートカットが含まれています: 
# ユーザー名でユーザーを検索する
xurl user xdevelopers

# 最近のポストを検索する
xurl search "X API"

# ツイートを投稿する
xurl post "Hello from xurl!"

​
なぜ xurl を使うのか?

機能curlxurl
認証手動での OAuth ヘッダー設定自動 — xurl auth を一度実行するだけ
トークン管理更新やローテーションを自分で行うトークンの保存と更新を内蔵
API ショートカット完全な URL が必要一般的な操作の短縮コマンド
リクエスト署名手動での OAuth 1.0a 署名すべてのリクエストで自動

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

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

​
関連情報

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

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

API Playground

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