X Manager - Twitter/X 账户管理

管理 X（前身为 Twitter）账户：发帖、互动、时间线浏览与数据分析。

多用户架构

每位用户的凭据存储在 credentials/{USER_ID}.json 中：

{
  "twitter": {
    "api_key": "",
    "api_secret": "",
    "access_token": "",
    "access_token_secret": "",
    "bearer_token": ""
  }
}

若用户尚未配置 Twitter 凭据，则提示其先绑定 X 账户。

或通过环境变量设置：TWITTER_API_KEY、TWITTER_API_SECRET、TWITTER_ACCESS_TOKEN、TWITTER_ACCESS_TOKEN_SECRET、TWITTER_BEARER_TOKEN。

支持的操作

1. 发送推文

python3 {baseDir}/scripts/post_tweet.py  "" [--media ]

最多 280 个字符。对于 Premium / Enterprise 账户，超长推文将自动分段发送。

2. 互动操作

点赞：

python3 {baseDir}/scripts/like_tweet.py  

回复：

python3 {baseDir}/scripts/reply_tweet.py   ""

转发：

python3 {baseDir}/scripts/retweet.py  

3. 数据获取

获取用户推文：

python3 {baseDir}/scripts/get_user_tweets.py   [--count ]

获取时间线：

python3 {baseDir}/scripts/get_timeline.py  [--count ]

搜索推文：

python3 {baseDir}/scripts/search_tweets.py  "" [--count ]

自动互动工作流

在 state/{USER_ID}.json 中配置：

{
  "auto_reply": {
    "enabled": true,
    "keywords": ["keyword1", "keyword2"],
    "reply_template": "Thanks {username} for {keyword}!"
  }
}

错误处理

• API 调用频率限制：提示用户等待后重试
• 认证失败：提示用户重新绑定 X 账户
• 推文过长：自动分段，或提示用户缩短内容

Twitter API 套餐等级

• 免费版：仅支持只读操作，不可发帖
• Premium（每月 $100）：支持发帖 + 分析功能
• Enterprise：更高配额与限制