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"] ``` ### スレッドを投稿する ```python def post_thread(oauth, tweets: list[str]) -> list[str]: ids = [] reply_to = None for text in tweets: payload = {"text": text} if reply_to: payload["reply"] = {"in_reply_to_tweet_id": reply_to} resp = oauth.post("https://api.x.com/2/tweets", json=payload) tweet_id = resp.json()["data"]["id"] ids.append(tweet_id) reply_to = tweet_id return ids ``` ### ユーザーのタイムラインを読み取る ```python resp = requests.get( f"https://api.x.com/2/users/{user_id}/tweets", headers=headers, params={ "max_results": 10, "tweet.fields": "created_at,public_metrics", } ) ``` ### ツイートを検索する ```python resp = requests.get( "https://api.x.com/2/tweets/search/recent", headers=headers, params={ "query": "from:affaanmustafa -is:retweet", "max_results": 10, "tweet.fields": "public_metrics,created_at", } ) ``` ### ユーザー名でユーザーを取得する ```python resp = requests.get( "https://api.x.com/2/users/by/username/affaanmustafa", headers=headers, params={"user.fields": "public_metrics,description,created_at"} ) ``` ### メディアをアップロードして投稿する ```python # Media upload uses v1.1 endpoint # Step 1: Upload media media_resp = oauth.post( "https://upload.twitter.com/1.1/media/upload.json", files={"media": open("image.png", "rb")} ) media_id = media_resp.json()["media_id_string"] # Step 2: Post with media resp = oauth.post( "https://api.x.com/2/tweets", json={"text": "Check this out", "media": {"media_ids": [media_id]}} ) ``` ## レートリミット X APIのレートリミットはエンドポイント、認証方法、アカウントティアによって異なり、時間とともに変化する。常に： * ハードコードされた仮定を立てる前に現在のX開発者ドキュメントを確認する * 実行時に `x-rate-limit-remaining` と `x-rate-limit-reset` ヘッダーを読み取る * コード内の静的テーブルに頼らず、自動的にバックオフする ```python import time remaining = int(resp.headers.get("x-rate-limit-remaining", 0)) if remaining < 5: reset = int(resp.headers.get("x-rate-limit-reset", 0)) wait = max(0, reset - int(time.time())) print(f"Rate limit approaching. Resets in {wait}s") ``` ## エラーハンドリング ```python resp = oauth.post("https://api.x.com/2/tweets", json={"text": content}) if resp.status_code == 201: return resp.json()["data"]["id"] elif resp.status_code == 429: reset = int(resp.headers["x-rate-limit-reset"]) raise Exception(f"Rate limited. Resets at {reset}") elif resp.status_code == 403: raise Exception(f"Forbidden: {resp.json().get('detail', 'check permissions')}") else: raise Exception(f"X API error {resp.status_code}: {resp.text}") ``` ## セキュリティ * **トークンをハードコードしない。** 環境変数または `.env` ファイルを使用する。 * **`.env` ファイルをコミットしない。** `.gitignore` に追加する。 * **トークンが漏洩した場合はローテーションする。** developer.x.comで再生成する。 * **書き込み権限が不要な場合は読み取り専用トークンを使用する。** * **OAuthシークレットを安全に保管する** — ソースコードやログに保存しない。 ## コンテンツエンジンとの統合 `content-engine` スキルを使用してプラットフォームネイティブなコンテンツを生成し、X API経由で投稿する： 1. コンテンツエンジンを使用してコンテンツを生成する（Xプラットフォームフォーマット） 2. 長さを検証する（ツイート1件あたり280文字） 3. 上記のパターンを使用してX API経由で投稿する 4. public\_metricsでエンゲージメントを追跡する ## 関連スキル * `content-engine` — X向けのプラットフォームネイティブコンテンツを生成する * `crosspost` — X、LinkedIn、その他のプラットフォームでコンテンツを配信する