twitter-cli：从终端掌控 Twitter/X（无需 API 密钥）

在一个 Twitter/X API 访问每月花费数千美元的世界中，twitter-cli 提供了一个免费、强大的替代方案。这个 Python CLI 使用您的浏览器 Cookie 进行身份验证，使请求与真实浏览器流量无法区分。无需 API 密钥，无官方限制的速率限制——纯终端力量。

🚀 主要特性

读取操作

• 时间线：为您推荐和关注动态（twitter feed）
• 书签：列出您的保存推文（twitter bookmarks）
• 搜索：关键词搜索，支持热门/最新/照片标签
• 用户资料：推文、点赞、粉丝、关注
• 推文详情：查看推文 + 线程回复
• JSON 导出：完美适用于脚本/自动化
• 智能过滤：基于互动的推文评分

写入操作

• 发布推文和回复
• 删除您的推文
• 点赞/取消点赞，转发/取消转发
• 书签/取消书签推文

反检测魔法

• 完整 Cookie 转发：提取所有浏览器 Cookie
• TLS 指纹：动态伪装 Chrome
• 请求抖动：随机时机以规避模式
• 代理支持：TWITTER_PROXY 环境变量
• 速率限制：内置延迟和重试

🎯 快速开始

# 安装（1 条命令）
uv tool install twitter-cli

# 您的时间线
twitter feed

# 仅关注
twitter feed -t following

# Elon Musk 的最近帖子
twitter user-posts elonmusk --max 20

# 带排名过滤的搜索
twitter search "AI agents" --filter

# 导出到 JSON
twitter bookmarks --json > my_bookmarks.json

🔐 身份验证（零设置）

自动：登录您的默认浏览器（Chrome/Arc/Edge/Firefox/Brave）

手动：设置 TWITTER_AUTH_TOKEN + TWITTER_CT0 环境变量

⚙️ 配置

创建 config.yaml：

fetch:
  count: 50
filter:
  mode: "topN"
  topN: 20
  weights:
    likes: 1.0
    retweets: 3.0
    bookmarks: 5.0
rateLimit:
  requestDelay: 2.5
  maxRetries: 3

🛡️ 保持安全（反封禁最佳实践）

1. ✅ 使用代理：export TWITTER_PROXY=socks5://127.0.0.1:1080
2. ✅ 限制请求：使用 --max 20 而非 --max 500
3. ✅ 浏览器 Cookie：完整指纹保护
4. ✅ 住宅代理 > 数据中心 IP
5. ✅ 内置随机延迟

🤖 AI 代理集成

包含 SKILL.md 用于 Claude Code、OpenClaw 和其他 AI 框架：

# 用于 Claude/Antigravity
mkdir -p .agents/skills
curl -o .agents/skills/twitter-cli/SKILL.md https://raw.githubusercontent.com/jackwener/twitter-cli/main/SKILL.md

📦 安装选项

# 最快：uv tool（推荐）
uv tool install twitter-cli

# pipx
pipx install twitter-cli

# 从源码
git clone https://github.com/jackwener/twitter-cli.git
cd twitter-cli
uv sync

为什么 twitter-cli 与众不同

星标：1.1k+ | Apache 2.0 许可 | 积极维护

立即获取 twitter-cli，从终端重新掌控您的 Twitter/X 体验！🚀

GitHub 仓库 | PyPI