核心功能
x-twitter 是一款面向个人用户的 X (Twitter) 数据分析与内容管理工具,通过 X API v2 实现账号全景监控与成本可控的日常简报。其核心能力覆盖六大模块:
| 模块 | 功能 | 典型场景 |
|------|------|---------|
| **简报 (Briefing)** | 24小时综合摘要(发帖+提及+资料) | 晨间社交速览 |
| **时间线 (Timeline)** | 近期发帖、互动数据、历史高互动帖 | 内容表现追踪 |
| **提及 (Mentions)** | 回复与@提及监控,可选上下文展开 | 社交互动管理 |
| **阅读 (Read)** | 任意推文/串文抓取,URL或ID直读 | 外链内容归档 |
| **书签 (Bookmarks)** | 本地存储的收藏管理 | 稍后阅读体系 |
| **用户资料 (User)** | 个人资料统计、粉丝变化追踪 | 账号成长监测 |
显著优点
1. 成本精细化管控:每项操作明码标价($0.005–$0.02),内置 --dry-run 预览、--budget-mode 分级(guarded/relaxed/unlimited)及日预算硬上限(lite/standard/intense 三档),彻底解决 API 费用不可控痛点
2. 智能本地缓存:top、--spend-report、bookmarks add/remove 等操作完全免费;跨会话缓存避免重复付费,配合 "Never call the same command twice" 规则实现零浪费
3. 场景化工作流:x_briefing.py 一键替代多命令组合(节省 30%+ 成本),activity 子命令专为「工作 accountability」场景设计
4. 技术栈现代:基于 uv 运行环境,Python 脚本即取即用,无复杂依赖
潜在局限
- 付费门槛:核心功能依赖 X API v2 付费层级,零预算用户无法使用
- 平台绑定:深度耦合 X 生态,无多平台(Bluesky/Mastodon)适配
- 隐私集中:需存储 API 密钥于本地
~/.openclaw/.env,单点凭据泄露风险 - 反爬依赖:若 X 调整 API 定价或限流,现有成本模型可能失效
适合人群
- 内容创作者/运营者:需量化帖子表现、追踪粉丝增长
- 社交戒断实践者:通过
activity检查实现数字健康 accountability - 信息策展人:结合
read+bookmarks构建个人推文知识库 - 成本敏感开发者:API 预算可控、拒绝惊喜账单的自动化需求
常规风险
- 预算超限:尽管有
guarded模式,用户仍可能通过--force或--no-budget绕过限制 - 数据滞留:本地缓存缺乏加密说明,设备丢失可能导致推文阅读历史泄露
- API 服务变更:X 平台历史上有突发调价、封号先例,技能可持续性存外部依赖