Agent skill · software engineering · affaan-m
x-api
X/Twitter API集成,用于发布推文、线程、读取时间线、搜索和分析。涵盖OAuth认证模式、速率限制和平台原生内容发布。当用户希望以编程方式与X交互时使用。
Why this skill is useful
Provides specific OAuth integration patterns and API usage examples for X/Twitter that the AI wouldn't reliably generate on its own.
What it needs
Requires x account access. About 2k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
X API 以编程方式与 X(Twitter)交互,用于发布、读取、搜索和分析。 何时激活 用户希望以编程方式发布推文或帖子串 从 X 读取时间线、提及或用户数据 在 X 上搜索内容、趋势或对话 构建 X 集成或机器人 分析和参与度跟踪 用户提及"发布到 X"、"发推"、"X API"或"Twitter API" 认证 OAuth 2.0 Bearer 令牌(仅应用) 最佳适用场景:读取密集型操作、搜索、公开数据。 OAuth 1.0a(用户上下文) 必需用于:发布推文、管理账户、私信。 核心操作 发布一条推文 发布一个帖子串 读取用户时间线 搜索推文 通过用户名获取用户 上传媒体并发布 速率限制 X API 的速率限制因端点、认证方法和账户等级而异,并且会随时间变化。请始终: 在硬编码假设之前,查看当前的 X 开发者文档 在运行时读取 x-rate-limit-remaining 和 x-rate-limit-reset 头部信息 自动退避,而不是依赖代码中的静态表格 错误处理 安全性 切勿硬编码令牌。 使用环境变量或 .env 文件。 切勿提交 .env 文件。 将其添加到 .gitignore。 如果令牌暴露,请轮换令牌。 在 developer.x.com 重新生成。 当不需要写权限时,使用只读令牌。 安全存储 OAuth 密钥 — 不要存储在源代码或日志中。 与内容引擎集成 使用 content-engine 技能生成平台原生内容,然后通过 X API 发布: 1. 使用内容引擎生成内容(X 平台格式) 2. 验证长度(单条推文 280 字符) 3. 使用上述模式通过 X API 发布 4. 通过 public\metrics 跟踪参与度 相关技能 content-engine — 为 X 生成平台原生内容 crosspost — 在 X、LinkedIn 和其他平台分发内容
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/x-api--9203ac