X (Twitter) 推文发布工具

使用官方 Tweepy 库发布推文，支持纯文本、图片、视频等多种媒体类型。

功能特性

• - 📝 纯文本推文 - 快速发布文字内容
• 🖼️ 图片支持 - 支持 JPG、PNG、GIF、WebP 格式（最多4张）
• 🎬 视频支持 - 支持 MP4、MOV、AVI、WebM 格式
• 📊 返回结果 - 返回推文 ID、链接、发布时间等详细信息
• ✅ 认证验证 - 支持验证 API 凭证是否有效

前提条件

1. 安装依赖

bash
pip3 install tweepy --user

2. 获取 X API 凭证

1. 1. 访问 https://developer.twitter.com/en/portal/dashboard
2. 创建项目并生成 API 密钥
3. 获取以下凭证：

- API Key - API Secret - Access Token - Access Token Secret

3. 配置环境变量

bash

添加到 ~/.zshrc

export XAPIKEY=your-api-key
export XAPISECRET=your-api-secret
export XACCESSTOKEN=your-access-token
export XACCESSTOKEN_SECRET=your-access-token-secret
export XBEARERTOKEN=your-bearer-token # 可选

然后执行：
bash
source ~/.zshrc

使用方法

验证认证信息

首次使用前，建议先验证凭证：

bash
python3 scripts/x_publisher.py verify

输出示例：

✅ 认证成功!
👤 用户名: @your_username
📛 显示名: Your Name
👥 粉丝: 1,234
📝 推文: 5,678

发布纯文本推文

bash
python3 scripts/x_publisher.py tweet Hello, X! This is my first tweet.

发布带图片的推文

bash

单张图片

python3 scripts/x_publisher.py tweet Check out this photo! --media /path/to/image.jpg

多张图片（最多4张）

python3 scripts/x_publisher.py tweet My photo collection: \ --media /path/to/photo1.jpg \ --media /path/to/photo2.png \ --media /path/to/photo3.gif

发布带视频的推文

bash
python3 scripts/x_publisher.py tweet Watch this video! --media /path/to/video.mp4

输出结果

发布成功后会返回：

============================================================
✅ 推文发布成功!
============================================================
📝 推文 ID: 1234567890123456789
🔗 链接: https://twitter.com/user/status/1234567890123456789
⏰ 发布时间: 2024-02-03T15:30:45.123456
📄 内容预览: Hello, X! This is my first tweet.
============================================================

📋 JSON 输出:
{
success: true,
tweet_id: 1234567890123456789,
text: Hello, X! This is my first tweet.,
created_at: 2024-02-03T15:30:45.123456,
url: https://twitter.com/user/status/1234567890123456789
}

命令参考

命令	功能	示例
verify	验证认证	xpublisher.py verify
tweet

发布推文 | xpublisher.py tweet Hello --media photo.jpg |

tweet 命令参数

参数	简写	说明	必填
text	-	推文内容	是
--media

-m | 媒体文件路径 | 否 |

支持的媒体格式

图片

• - JPG/JPEG - 推荐格式
• PNG - 支持透明背景
• GIF - 支持动画
• WebP - 现代格式

限制：

• - 最多 4 张图片
• 单张图片最大 5MB

视频

• - MP4 - 推荐格式
• MOV - QuickTime 格式
• AVI - 常见格式
• WebM - 现代格式

限制：

• - 单个视频最大 512MB
• 最长 2 分 20 秒

错误处理

认证失败

❌ 认证失败: 无法获取用户信息

解决方法：

• - 检查 API 密钥和令牌是否正确
• 确认令牌未过期
• 检查网络连接

权限不足

❌ 推文发布失败
错误类型: 权限不足
错误信息: You are not allowed to create a Tweet with these settings

解决方法：

• - 确认应用有 Write 权限
• 检查是否违反 X 平台规则

请求过于频繁

❌ 推文发布失败
错误类型: 请求过于频繁
错误信息: Rate limit exceeded

解决方法：

• - 等待几分钟后重试
• X API 有速率限制（每15分钟300条推文）

媒体上传失败

❌ 媒体文件不存在: /path/to/image.jpg

解决方法：

• - 检查文件路径是否正确
• 确认文件格式支持
• 检查文件大小是否超限

使用场景

场景1：自动化发布

bash

发布每日摘要

python3 scripts/x_publisher.py tweet 📊 今日市场摘要：BTC $43,250 (+2.3%)

场景2：带图发布

bash

发布截图或图表

python3 scripts/xpublisher.py tweet 📈 今日走势图 --media ~/charts/btctoday.png

场景3：批量发布脚本

python
#!/bin/bash

publish_news.sh

CONTENT=🚀 重大新闻：...
IMAGE=/path/to/news_image.jpg

python3 scripts/x_publisher.py tweet $CONTENT --media $IMAGE

场景4：集成到其他工具

python
import subprocess
import json

result = subprocess.run(
[python3, scripts/x_publisher.py, tweet, Hello!, --media, photo.jpg],
capture_output=True,
text=True
)

解析 JSON 输出

output_lines = result.stdout.split(\n) for line in output_lines: if line.strip().startswith({): tweet_info = json.loads(line) print(fTweet ID: {tweetinfo[tweetid]}) print(fURL: {tweet_info[url]})

API 限制

限制类型	数值	说明
推文长度	280 字符	超过将自动截断
媒体数量

4 个 | 图片或视频混合 | | 图片大小 | 5 MB | 单张图片 | | 视频大小 | 512 MB | 单个视频 | | 视频时长 | 2分20秒 | 最大时长 | | 发布频率 | 300条/15分钟 | 速率限制 |

注意事项

1. 1. 凭证安全 - 不要泄露 API 密钥，使用环境变量存储
2. 内容合规 - 遵守 X 平台规则，避免发布违规内容
3. 频率控制 - 注意 API 速率限制，避免频繁发布
4. 媒体版权 - 确保上传的媒体文件有版权或使用授权

参考

• - Tweepy 文档: https://docs.tweepy.org/
• X API 文档: https://developer.twitter.com/en/docs/twitter-api
• X Developer Portal: https://developer.twitter.com/en/portal/dashboard