mturac X API
投稿、読み取り、検索、分析のためにX（Twitter）とプログラムで対話する。
有効化する場面
- ユーザーがプログラムでツイートやスレッドを投稿したい
- Xのタイムライン、メンション、またはユーザーデータを読み取る
- X上でコンテンツ、トレンド、または会話を検索する
- X統合またはボットを構築する
- 分析とエンゲージメント追跡
- ユーザーが「Xに投稿する」「ツイートする」「X API」または「Twitter API」と言及している
認証
OAuth 2.0 Bearerトークン（アプリのみ）
最適な用途：読み取り集中の操作、検索、公開データ。
# Environment setup
export X_BEARER_TOKEN="your-bearer-token"
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": "openai codex", "max_results": 10}
)
tweets = resp.json()
OAuth 1.0a（ユーザーコンテキスト）
以下に必要：ツイートの投稿、アカウント管理、DM。
# 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"
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件投稿する
resp = oauth.post(
"https://api.x.com/2/tweets",
json={"text": "Hello from OpenAI Codex"}
)
resp.raise_for_status()
tweet_id = resp.json()["data"]["id"]
スレッドを投稿する
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
ユーザーのタイムラインを読み取る
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",
}
)
ツイートを検索する
resp = requests.get(
"https://api.x.com/2/tweets/search/recent",
headers=headers,
params={
"query": "from:mehmet_turac -is:retweet",
"max_results": 10,
"tweet.fields": "public_metrics,created_at",
}
)
ユーザー名でユーザーを取得する
resp = requests.get(
"https://api.x.com/2/users/by/username/mehmet_turac",
headers=headers,
params={"user.fields": "public_metrics,description,created_at"}
)
メディアをアップロードして投稿する
# 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ヘッダーを読み取る - コード内の静的テーブルに頼らず、自動的にバックオフする
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")
エラーハンドリング
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経由で投稿する：
- コンテンツエンジンを使用してコンテンツを生成する（Xプラットフォームフォーマット）
- 長さを検証する（ツイート1件あたり280文字）
- 上記のパターンを使用してX API経由で投稿する
- public_metricsでエンゲージメントを追跡する
関連スキル
content-engine— X向けのプラットフォームネイティブコンテンツを生成するcrosspost— X、LinkedIn、その他のプラットフォームでコンテンツを配信する