SuperAPI AI 工具集

use-graphql-api

编程与开发

查看项目

更新于 10-16 03:43

技能介绍

用途:从命令行发现、构造、执行并串联 GraphQL 操作,适合查询或变更 GraphQL 端点(如 GitHub、Hasura、Apollo),自动化需要 GraphQL 的 GitHub 操作(Discussions、Projects v2),以及编写获取结构化数据的 shell 脚本。

主要能力:通过内省查询列出可用类型、字段、查询与变更;区分 query(读)、mutation(写)、subscription(流);用变量构造操作;用 gh api graphql 或 curl 执行;用 jq 解析响应并赋值给 shell 变量;将一次调用的输出作为下一次调用的输入进行串联。

使用方式:先内省 schema,例如 gh api graphql -f query='{ __schema { queryType { fields { name description } } } }';通用端点可用 curl -s -X POST 加 Authorization 头。构造操作时使用变量(如 $owner: String!),只请求所需字段,分页用 first: N 与 nodes,并为每个对象选择 id 以便串联。执行时 GitHub 用 gh api graphql -f query=... -f 变量,通用端点用 curl 配合 jq -n 生成请求体。解析用 --jq 或管道 jq,串联时先查询 id 再作为 ID! 变量传给后续 mutation。

适用场景:GitHub Discussions 创建、仓库与议题数据获取、多步 API 工作流自动化。

限制与注意:需有效认证令牌,GitHub 默认用 gh CLI 认证;部分端点禁用内省,需查阅文档;GraphQL 使用不透明 node ID,不能手动构造或复用 REST ID;注意分页、错误数组与速率限制;变量类型需匹配 schema 可空性。资料未提供具体收费、价格或平台支持范围。