用途:面向 X.com 前端 Web API 的技能,用于 GraphQL 操作(https://x.com/i/api/graphql)与 REST 式 Web 端点(https://x.com/i/api)及所需浏览器请求头/Cookie。仅手动加载,必须显式点名 x-undocumented-api 或 x-api-skill。
主要能力与用法:先对照当前 X Web bundle 校验 operationName 与 queryId(queryId 会轮换),再提取变量、feature flags、字段开关和响应路径;参考文档按需读取 runtime-and-auth.md、graphql-discovery.md、endpoint-patterns.md、community-timelines.md、trends-and-explore.md 等。附带脚本 scripts/extract-x-graphql-endpoints.ts 可抓取当前 bundle 并输出 JSON/CSV 端点清单。GraphQL 路径形如 https://x.com/i/api/graphql/<queryId>/<operationName>?variables=<json>&features=<json>,部分操作使用 fieldToggles。鉴权读取常用请求头包括 authorization、x-csrf-token、cookie、x-client-transaction-id(需含 query ID 路径)等。
适用场景:端点盘点、请求结构确认、只读探测、时间线/搜索/社区/趋势与地理检索研究、分页游标行为记录与可复现的证据留存。
限制:不得打印原始 Cookie、auth_token、ct0、bearer token、代理凭据或完整上游载荷;除非用户明确要求并理解后果,不要对真实账号测试 mutation。Query ID 为带日期的临时事实,复用前须重新生成。返回或变化的 cursor 不代表有更多数据。地理搜索计数为观测下界。资料中未提供收费、价格与平台支持信息。