sawzhang Twitter/X 一站式 Skill
四种模式，根据用户指令自动判断：
| 触发词 | 模式 | 方式 |
|---|---|---|
| 读推文、read tweet、看推文 + URL | read | fxtwitter API |
| 搜Twitter、twitter research、X上关于 | search | browser-use / fxtwitter |
| 发推、twitter post、发一条 | post | X API v2 OAuth 1.0a |
| 发thread、twitter thread | thread | X API v2 连续 post |
模式一：Read（读推文）
用户分享 Twitter/X 链接时触发。
Step 1: 从 URL 提取用户名和推文 ID
支持的 URL 格式：
https://x.com/{username}/status/{tweet_id}https://twitter.com/{username}/status/{tweet_id}
Step 2: 通过 fxtwitter API 获取
curl -s "https://api.fxtwitter.com/{username}/status/{tweet_id}"
Step 3: 格式化输出
**作者**: {name} (@{handle}) | **时间**: {time}
**互动**: {likes} 赞 | {retweets} 转 | {views} 浏览
{推文正文}
降级方案
fxtwitter 不可用时：
curl -s "https://api.vxtwitter.com/{username}/status/{tweet_id}"- WebSearch 搜索推文 ID
模式二：Search（搜索话题）
用户说"搜Twitter"、"X上关于XX的讨论"时触发。
Step 1: 生成 3-5 组搜索关键词
中英文双搜，包括核心词 + 细分词 + 关联项目名。
Step 2: 尝试 browser-use（首选）
# 定义 wrapper 清除代理
bu() { ALL_PROXY= HTTP_PROXY= HTTPS_PROXY= http_proxy= https_proxy= all_proxy= browser-use "$@"; }
# 安装检测
if ! which browser-use &>/dev/null; then
uv tool install browser-use && browser-use install
fi
# 搜索
bu -b real open "https://x.com/search?q={关键词URL编码}&src=typed_query&f=top"
sleep 3
bu state 2>&1
限速规则：每次搜索间隔 8-10 秒，否则结果会一直转圈。
Step 3: 降级到 fxtwitter
browser-use 不可用时，用 WebSearch 搜 "{关键词} site:x.com"，提取推文 URL 后用 fxtwitter API 获取详情。
Step 4: 汇总输出
按互动量排序，分主题分组，输出结构化报告。
模式三：Post（发帖）
用户说"发推"、"tweet this"、"发一条推文"时触发。
前置条件
需要 X API v2 OAuth 1.0a 凭据（4 个环境变量）：
export X_API_KEY="your_consumer_key"
export X_API_SECRET="your_consumer_secret"
export X_ACCESS_TOKEN="your_access_token"
export X_ACCESS_SECRET="your_access_token_secret"
从 https://console.x.com 创建 App → Keys and Tokens 获取。 App permissions 必须设为 Read and Write。
Step 1: 检查凭据
python3 -c "
from requests_oauthlib import OAuth1Session
import os
session = OAuth1Session(os.environ['X_API_KEY'], os.environ['X_API_SECRET'], os.environ['X_ACCESS_TOKEN'], os.environ['X_ACCESS_SECRET'])
r = session.get('https://api.x.com/2/users/me')
print(r.json() if r.status_code == 200 else f'ERROR {r.status_code}: {r.text[:200]}')
"
如果 401：凭据错误或过期。如果缺少依赖：pip3 install --break-system-packages requests-oauthlib
Step 2: 发帖
使用 skill 目录下的 post.py 脚本：
# 找到 post.py 的路径
SKILL_DIR=$(find ~/.claude -path "*/skills/twitter/post.py" -exec dirname {} \; 2>/dev/null | head -1)
# 发单条
python3 "$SKILL_DIR/post.py" "推文内容"
或者直接用 Python：
python3 -c "
from requests_oauthlib import OAuth1Session
import os, json
session = OAuth1Session(os.environ['X_API_KEY'], os.environ['X_API_SECRET'], os.environ['X_ACCESS_TOKEN'], os.environ['X_ACCESS_SECRET'])
r = session.post('https://api.x.com/2/tweets', json={'text': '推文内容'})
print(json.dumps(r.json(), indent=2))
"
发帖注意事项（实测经验）
| 问题 | 原因 | 解决 |
|---|---|---|
| 403 duplicate content | 与近期推文完全相同 | 修改措辞或加时间戳 |
| 403 not permitted | 长文本含特殊组合触发 spam 检测 | 缩短到 200 字内，去掉 # 和密集 URL |
| 401 unauthorized | API Key 过期或权限不足 | 重新生成 token，确认 Read+Write 权限 |
| 429 rate limit | 15 分钟内发太多 | 等待 reset（查看 x-rate-limit-reset header） |
模式四：Thread（发 thread）
用户说"发thread"、"发9条thread"时触发。
Step 1: 准备 thread 内容
让用户确认 thread 内容（JSON 数组格式），或根据上下文生成。每条控制在 200 字符内（中文）以避免 spam 检测。
Step 2: 写入 JSON 文件
cat > /tmp/thread.json << 'EOF'
[
"1/N 第一条内容",
"2/N 第二条内容",
"..."
]
EOF
Step 3: 发送
SKILL_DIR=$(find ~/.claude -path "*/skills/twitter/post.py" -exec dirname {} \; 2>/dev/null | head -1)
python3 "$SKILL_DIR/post.py" --thread /tmp/thread.json
Thread 策略（实测经验）
X API pay-per-use 层对 reply 操作有限制。post.py 内置了降级逻辑：
- 首选：reply 链（真正的 thread）
- 降级：reply 被 403 时自动切换为独立推文
- 限速：每条间隔 4 秒，避免触发 anti-automation
- 去重：每条推文内容必须唯一，否则 403 duplicate
凭据管理
推荐在 ~/.zshrc 中设置：
# X API v2 (https://console.x.com)
export X_API_KEY="..."
export X_API_SECRET="..."
export X_ACCESS_TOKEN="..."
export X_ACCESS_SECRET="..."
Bearer Token（读取用，可选）：
export X_BEARER_TOKEN="..."
这些凭据不会被写入任何文件或日志。post.py 只从环境变量读取。
组合工作流示例
用户：搜一下 Twitter 上关于 Claude Code 降智的讨论，总结后发一条 thread
→ 模式二 search：搜索 "Claude Code degradation"、"Claude Code 降智"
→ 整理搜索结果为 thread 内容
→ 模式四 thread：发送 thread