> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# xurl — X API 向けの curl スタイルのコマンドラインクライアント

> X API 向けの curl スタイル CLI である xurl をインストールして利用します。OAuth を内蔵しており、ターミナルからエンドポイントのテスト、リクエストの署名、プロトタイピングを行えます。

[xurl](https://github.com/xdevplatform/xurl) は X API 向けの curl 風コマンドラインツールです。OAuth 認証を自動的に処理するため、トークンを手動で管理したりリクエストに署名したりすることなく API リクエストを実行できます。

<Card title="GitHub repository" icon="github" href="https://github.com/xdevplatform/xurl">
  ソースコード、リリース、ドキュメント。
</Card>

***

## インストール

Go でインストールするか、[releases](https://github.com/xdevplatform/xurl/releases) からビルド済みバイナリをダウンロードします。

```bash theme={null}
go install github.com/xdevplatform/xurl@latest
```

***

## セットアップ

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

xurl はあなた自身の開発者アプリを使って認証します。[X 開発者ポータル](https://developer.x.com) で:

1. **OAuth 2.0** を有効にしたアプリを作成(または既存のものを開く)します。
2. リダイレクト URI `http://localhost:8080/callback` をアプリに登録します。
3. アプリの "Keys and tokens" ページから **Client ID** と **Client Secret** をコピーします。

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

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

```bash theme={null}
export CLIENT_ID="your-x-app-client-id"
export CLIENT_SECRET="your-x-app-client-secret"
```

### 3. 認可する

```bash theme={null}
xurl auth oauth2
```

これによりブラウザベースの OAuth フローが開きます。認可が完了すると、xurl はトークンをローカルの `~/.xurl` に保存するため、再度認証する必要はありません。

<Warning>
  ブラウザに **"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 として登録されていることを確認してください。
</Warning>

***

## 使い方

### 生の API リクエスト

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

```bash theme={null}
# ユーザーを検索する
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 には一般的な操作用の組み込みショートカットが含まれています:

```bash theme={null}
# ユーザー名でユーザーを検索する
xurl user xdevelopers

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

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

***

## なぜ xurl を使うのか?

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

***

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

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

```bash theme={null}
npx skills add https://github.com/xdevplatform/xurl
```

***

## 関連情報

<CardGroup cols={2}>
  <Card title="最初のリクエストを送信する" icon="rocket" href="/make-your-first-request">
    cURL または SDK を使って X API を始めましょう。
  </Card>

  <Card title="API Playground" icon="flask" href="https://github.com/xdevplatform/playground">
    モックデータを使ってローカルでエンドポイントをテスト — API クレジット不要。
  </Card>
</CardGroup>