SuperAPI AI 工具集

x-openapi-skill

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:通过 uxc 结合 X 官方 OpenAPI schema 执行 X API v2 操作,复用 uxc 的执行、鉴权与错误处理指引。

主要能力:支持按操作路径检查 schema 并调用只读与写入接口,如获取用户信息、书签、时间线及发帖;支持 HTTP 流式端点订阅;提供 OAuth2 Authorization Code + PKCE 用户上下文鉴权与 app-only bearer 公共读取鉴权。

使用方式:前提为 uxc 已安装并在 PATH 中、可访问 https://api.x.com、可获取 https://api.x.com/2/openapi.json、拥有启用 OAuth2 的 X 开发者应用。用户上下文操作需先启动并完成 OAuth2 登录,再绑定凭证到 api.x.com 的 /2 路径并验证。公共读取可配置 bearer 凭证绑定,请求时用 --auth x-api-app 指定。默认使用固定链接命令 x-openapi-cli,若缺失则创建:uxc link x-openapi-cli https://api.x.com --schema-url https://api.x.com/2/openapi.json。执行前先用 -h 查看操作 schema,先读后写,写入操作需用户明确确认。流订阅可通过 uxc subscribe start 配合对应规则管理端点使用。

限制:需遵守 JSON 输出封套,先解析 ok、kind、protocol、data、error 等稳定字段;OAuth2 PKCE 为默认用户上下文路径;不得提交或硬编码 bearer token、client secret 或 refresh token;发帖、DM、书签写入及流规则变更属写/高风险操作,须显式确认;offline.access 仅在确认刷新可用时添加。