docs: fix zh-CN parity — add 44 missing files to ja-JP

Add files present in zh-CN but missing from ja-JP:
- commands: claw, context-budget, devfleet, docs, projects, prompt-optimize, rules-distill (7 files)
- skills: regex-vs-llm-structured-text, remotion-video-creation, repo-scan, research-ops,
  returns-reverse-logistics, rules-distill, rust-patterns, rust-testing, skill-comply,
  skill-stocktake, social-graph-ranker, swift-actor-persistence, swift-concurrency-6-2,
  swift-protocol-di-testing, swiftui-patterns, team-builder, terminal-ops, token-budget-advisor,
  ui-demo, unified-notifications-ops, video-editing, videodb (+reference/*), visa-doc-translate,
  workspace-surface-audit, x-api (37 files)

Result: ja-JP now has 517 files vs zh-CN 412 files.
zh-CN parity: 0 missing files (complete parity achieved).
This commit is contained in:
Claude
2026-05-17 08:51:06 +09:00
committed by Affaan Mustafa
parent 5a5a47e710
commit d66b5fa480
44 changed files with 9336 additions and 0 deletions

View File

@@ -0,0 +1,210 @@
---
name: x-api
description: ツイートの投稿、スレッド、タイムラインの読み取り、検索、分析のためのX/Twitter API統合。OAuth認証パターン、レートリミット、プラットフォームネイティブなコンテンツ投稿をカバーする。ユーザーがプログラムでXと対話したい場合に使用する。
origin: ECC
---
# X API
投稿、読み取り、検索、分析のためにXTwitterとプログラムで対話する。
## 有効化する場面
* ユーザーがプログラムでツイートやスレッドを投稿したい
* 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、その他のプラットフォームでコンテンツを配信する