x-api

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# X API

与 X（Twitter）的编程交互，用于发布、阅读、搜索和分析。

## 何时激活

- 用户想要以编程方式发布推文或线程
- 从 X 阅读时间线、提及或用户数据
- 搜索 X 内容、趋势或对话
- 构建 X 集成或机器人
- 分析和参与跟踪
- 用户说"发布到 X"、"tweet"、"X API"或"Twitter API"

## 认证

### OAuth 2.0 持有者令牌（仅应用）

最适合：重度读取操作、搜索、公共数据。

```bash
# 环境设置
export X_BEARER_TOKEN="your-bearer-token"
```

```python
import os
import requests

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

# 搜索最近的推文
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
# 环境设置 — 使用前获取
export X_CONSUMER_KEY="your-consumer-key"
export X_CONSUMER_SECRET="your-consumer-secret"
export X_ACCESS_TOKEN="your-access-token"
export X_ACCESS_TOKEN_SECRET="your-access-token-secret"
```

旧设置中的遗留别名如 `X_API_KEY`、`X_API_SECRET` 和 `X_ACCESS_SECRET` 可能存在。在记录或连接新流时，优先使用 `X_CONSUMER_*` 和 `X_ACCESS_TOKEN_SECRET` 名称。

```python
import os
from requests_oauthlib import OAuth1Session

oauth = OAuth1Session(
    os.environ["X_CONSUMER_KEY"],
    client_secret=os.environ["X_CONSUMER_SECRET"],
    resource_owner_key=os.environ["X_ACCESS_TOKEN"],
    resource_owner_secret=os.environ["X_ACCESS_TOKEN_SECRET"],
)
```

## 核心操作

### 发布推文

```python
resp = oauth.post(
    "https://api.x.com/2/tweets",
    json={"text": "来自 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",

From aaione/everything-claude-code-zh, MIT.

More from aaione/everything-claude-code-zh