Swagger API 读取器
读取 Swagger URL，解析 API 定义，本地缓存供模型使用。
命令
| 命令 | 说明 |
|---|---|
add | 添加 API |
list | 列出已缓存 |
read | 读取文档 |
refresh | 刷新 |
remove | 删除 |
使用
脚本路径: scripts/swagger_reader.py
添加
# 直接 URL
python scripts/swagger_reader.py add --url "URL" --alias "别名"
# HTML 页面（自动提取）
python scripts/swagger_reader.py add --url "https://xxx/swagger-ui/index.html" --alias "别名"
# 认证
--auth-type bearer --token "TOKEN"
--auth-type basic --username "USER" --password "PASS"
--auth-type apikey --key-name "X-API-Key" --key-value "KEY" --key-in header
# 浏览器模式（SSO/内网）
--browser --browser-timeout 180
# 跳过 SSL
--no-verify
其他
python scripts/swagger_reader.py list
python scripts/swagger_reader.py read --alias "别名"
python scripts/swagger_reader.py refresh --alias "别名"
python scripts/swagger_reader.py remove --alias "别名"
缓存位置
~/.cursor/skills/swagger-api-reader/cache/
依赖
pip install requests pyyaml selenium