mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-18 06:43:05 +08:00
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:
210
docs/ja-JP/skills/x-api/SKILL.md
Normal file
210
docs/ja-JP/skills/x-api/SKILL.md
Normal file
@@ -0,0 +1,210 @@
|
||||
---
|
||||
name: x-api
|
||||
description: ツイートの投稿、スレッド、タイムラインの読み取り、検索、分析のためのX/Twitter API統合。OAuth認証パターン、レートリミット、プラットフォームネイティブなコンテンツ投稿をカバーする。ユーザーがプログラムでXと対話したい場合に使用する。
|
||||
origin: ECC
|
||||
---
|
||||
|
||||
# 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、その他のプラットフォームでコンテンツを配信する
|
||||
Reference in New Issue
Block a user