直连 X 官方 API 的社交发布工具

基于官方 X API v2 的 OAuth 1.0a 客户端，支持免费层级的推文发布、线程管理和账户操作，无需第三方代理。

基本信息

• 技能名称?x-oauth-api
• 中文名称?直连 X 官方 API 的社交发布工具
• 作者?ngmeyer
• 分类?专业技能
• 版本?v1.0.0
• 标签?content-media, api, automation, social-media, productivity

使用方法

使用说明
核心用法
x-oauth-api 是一个直接对接 X (原 Twitter) 官方 API 的命令行工具，通过 OAuth 1.0a 认证实现推文发布、线程创建、提及查询和搜索等功能。用户只需配置四个环境变量（X_API_KEY、X_API_SECRET、X_ACCESS_TOKEN、X_ACCESS_TOKEN_SECRET）即可开始使用，无需搭建代理服务器或依赖第三方服务。
该 Skill 支持多种实用场景：单条推文发布（ x post ）、多推文线程（ x thread ）、回复与引用（ --reply-to 、 、 --quote ）、媒体附件上传（ --media ），以及账户信息查询（ x me ）。对于付费层级用户，还可使用搜索（ x search ）和提及监控（ x mentions`）功能。
显著优点
官方直连，无中间商 ：直接调用 api.twitter.com，数据不经过任何第三方服务器，隐私可控。免费层级即可满足基础发帖需求，适合个人用户和小型项目。
功能完整，接口统一 ：覆盖发帖、删帖、线程、回复、搜索、提及等核心场景，命令设计遵循 CLI 直觉，学习成本低。依赖 twitter-api-v2 官方 SDK，API 兼容性和稳定性有保障。
透明开源，可审计 ：代码完全开源，依赖包（commander、dotenv、twitter-api-v2）均为社区广泛验证的成熟库，无黑盒操作。
潜在缺点与局限性
功能分层限制 ：免费层级仅支持发帖、删帖和账户查询；搜索、提及监控、媒体上传等常用功能需升级至 Basic+ 付费层级，对预算敏感用户不够友好。
速率限制严格 ：发帖接口 15 分钟仅 200 次请求，高频自动化场景易触发限流。且完全依赖 X 平台的政策稳定性，API 条款变更可能导致功能突然受限。
无内置重试与缓存 ：网络波动或 API 临时故障时缺乏智能退避机制，需用户自行处理异常。
适合的目标群体
个人开发者/技术博主 ：需要自动化发布技术动态、构建个人内容工作流
小型运营团队 ：管理品牌账号日常发帖，对成本敏感且需求集中在基础发布功能
AI Agent 构建者 ：为智能体赋予社交媒体交互能力，实现自动回复、内容同步等场景
使用风险
凭证泄露风险 ：OAuth 凭证以环境变量形式存储，若配置不当（如误提交到 Git、日志打印）可能导致账户被盗用。建议专用 API 应用、最小权限原则、定期轮换密钥。
平台依赖风险 ：X API 政策历史上多次调整，免费层级功能可能进一步收缩；账户封禁或 API 访问被撤销将直接导致 Skill 失效。
网络与性能风险 ：国内网络环境访问 api.twitter.com 可能存在连通性问题；无本地缓存机制，频繁调用易触发速率限制。
数据隐私边界 ：虽然直连官方 API，但推文内容、搜索关键词等仍会被 X 平台记录，敏感信息需谨慎发布。