X API

# X API

投稿、読み取り、検索、分析のためにX（Twitter）とプログラムで対話する。

## 有効化する場面

* ユーザーがプログラムでツイートやスレッドを投稿したい
* Xのタイムライン、メンション、またはユーザーデータを読み取る
* X上でコンテンツ、トレンド、または会話を検索する
* X統合またはボットを構築する
* 分析とエンゲージメント追跡
* ユーザーが「Xに投稿する」「ツイートする」「X API」または「Twitter API」と言及している

## 認証

### OAuth 2.0 Bearerトークン（アプリのみ）

最適な用途：読み取り集中の操作、検索、公開データ。

```bash
# Environment setup
export X_BEARER_TOKEN="your-bearer-token"
```

```python
import os
import requests

bearer = os.environ["X_BEARER_TOKEN"]
headers = {"Authorization": f"Bearer {bearer}"}

# Search recent tweets
resp = requests.get(
    "https://api.x.com/2/tweets/search/recent",
    headers=headers,
    params={"query": "claude code", "max_results": 10}
)
tweets = resp.json()
```

### OAuth 1.0a（ユーザーコンテキスト）

以下に必要：ツイートの投稿、アカウント管理、DM。

```bash
# Environment setup — source before use
export X_API_KEY="your-api-key"
export X_API_SECRET="your-api-secret"
export X_ACCESS_TOKEN="your-access-token"
export X_ACCESS_SECRET="your-access-secret"
```

```python
import os
from requests_oauthlib import OAuth1Session

oauth = OAuth1Session(
    os.environ["X_API_KEY"],
    client_secret=os.environ["X_API_SECRET"],
    resource_owner_key=os.environ["X_ACCESS_TOKEN"],
    resource_owner_secret=os.environ["X_ACCESS_SECRET"],
)
```

## コア操作

### ツイートを1件投稿する

```python
resp = oauth.post(
    "https://api.x.com/2/tweets",
    json={"text": "Hello from Claude Code"}
)
resp.raise_for_status()
tweet_id = resp.json()["data"]["id"]
```

### スレッドを投稿する