x-api

x-api 技能概览

x-api 的作用

x-api 技能帮助你以程序化方式使用 X/Twitter API，完成发帖、读取、搜索和基础分析等任务。当你需要一个 x-api 技能，把“发一下这条更新”或“拉取最近的提及”这类模糊需求，落到正确的认证模型、端点选择和请求结构时，它尤其有用。

适合谁安装

如果你要构建机器人、社交自动化、内容发布流水线，或需要 X 数据的内部工具，就应该安装 x-api。它尤其适合 API Development 任务，因为这类工作常常要先判断：是只读、用户上下文写入，还是偏搜索密集型。

它为什么有用

x-api 的核心价值在于实用的路由判断：它会区分仅应用读取时使用的 bearer token，以及发帖和账号操作所需的 OAuth 1.0a。这样可以减少在权限、rate limit 以及真正发起请求前 API 到底需要哪些输入上的猜测。

如何使用 x-api 技能

安装并加载该技能

按目录里的安装流程安装 x-api，然后先阅读 SKILL.md。如果你的环境支持，可以这样安装：

npx skills add affaan-m/everything-claude-code --skill x-api

接着查看该技能提供的任何关联仓库上下文。在这个仓库里，主源文件是 skills/x-api/SKILL.md，并没有配套的 rules/、resources/ 或辅助脚本来补全缺失行为。

给技能正确的问题形状

x-api usage 最适合你一开始就明确三件事：动作、访问级别和目标对象。比如可以直接说：“用 bearer token 搜索最近关于 Claude Code 的帖子”或“用 OAuth 1.0a 以用户上下文发一个 thread。”这比“帮我用 X API”好得多，因为技能可以把你的意图映射到正确的认证方式和 endpoint 路径。

提供合适的输入细节

对于读取流程，请提供搜索 query、时间窗口、结果数量限制，以及你需要的是公开数据还是账号相关数据。对于写入流程，请提供确切的帖子内容、是否需要 thread，以及任何媒体或回复限制。如果你是在做 x-api for API Development，还要说明运行时、密钥存储方式，以及你是否需要 Python、JavaScript 或 shell 的示例代码。

按这个顺序阅读源码

先看 SKILL.md，再查看认证部分和 “When to Activate” 指引。这些内容会告诉你，这个请求到底应不应该归到这个技能里。如果你要把它改造成自己的工作流，先复制决策逻辑，而不是代码示例，因为对大多数 x-api 安装尝试来说，认证选择才是主要卡点。

x-api 技能 FAQ

x-api 只是用来发推文的吗？

不是。x-api 技能覆盖发帖、读取时间线、搜索近期内容，以及面向分析的检索。如果你的工作只是起草文案，普通写作提示就够了；如果你需要内容通过 API 真正发到 X 上，x-api 才是更合适的选择。

使用前必须懂 OAuth 吗？

你不需要成为 OAuth 专家，但你必须知道你的任务属于仅应用读取，还是用户上下文写入。这是这个 x-api guide 的核心边界，也决定了在请求能跑通之前，你必须提供哪些凭证。

什么时候不该用这个技能？

如果你只是想手动发一次社交帖子、你的组织还没有批准 X API 访问，或者你无法提供安全的环境变量，就不应该用 x-api。如果你的需求是跨平台的广义 social listening，它也不合适，因为这个技能只针对 X。

如何改进 x-api 技能

先说结果，不要只说 endpoint

更好的输入会带来更好的 x-api 输出。与其问“给我一个 API 调用”，不如直接要：“一个 Python 示例，搜索 claude code 的最近帖子，返回 10 条结果，并从 env vars 里读取 bearer token。”明确的成功标准能帮助技能避免给出泛泛而谈或不完整的示例。

提供认证与权限约束

大多数失败都来自缺少访问细节。要告诉技能你是否有 bearer-token 访问、OAuth 1.0a 用户上下文，或者两者都有，并说明任何限制，比如不能保存密钥、不能发 DMs，或只有只读权限。这样可以避免它推荐你实际上无法使用的认证流程。

从第一个可工作的请求开始迭代

先从一个 endpoint 和一个窄场景开始，再逐步扩展。一个稳妥的 x-api 工作流是：先验证认证，再跑一个小型读取请求，确认 rate limit 行为，然后再加发帖或分析。如果第一次输出太抽象，就让它给出精确请求、预期响应结构和最小错误处理，而不是要求它做更大范围的重写。