用途：gsc-cli 是 Google Search Console 的本地 CLI 封装。官方有 Search Console API 但没有第一方 CLI，该工具把常见读取操作做得低噪音，并把站点地图/站点写入操作显式化。
主要能力：查询搜索分析（analytics query，支持日期范围、维度、类型、行数限制与过滤，如 page:contains、device:equals）；查看 URL 的 Google 索引状态（url inspect）；列出/获取/提交/删除站点地图；列出与获取 Search Console 属性（sites list/get）。默认输出 JSON，便于解析而非抓取终端文本。
使用方式：优先使用技能本地脚本而非全局或第三方 GSC CLI。配置路径为 ~/.config/gsc-cli/config.json。一次性授权运行 <skill-path>/scripts/setup-auth.sh；无头机器会打印 Google 授权 URL，用户在浏览器授权后粘贴回最终重定向 URL 或 code，CLI 将 refresh token 存入配置文件。检查授权用 auth status 与 doctor。查询示例：<skill-path>/scripts/gsc-cli analytics query --site 'sc-domain:example.com' --start-date 2026-05-01 --end-date 2026-05-31 --dimensions query,page --type web --row-limit 100。
限制与注意：除非用户明确需要站点地图或站点写入，否则优先只读 OAuth；未获明确批准不要带 --execute 运行 sites add/delete 或 sitemaps submit/delete。full 权限允许写入，但不提供 Search Console UI 中针对普通页面的手动“请求索引”API 等价操作，普通页面发现应更新/提交站点地图。需在拥有 OAuth 客户端的同一 Google Cloud 项目启用 Search Console API，使用 Desktop app 客户端而非 TV/Limited Input。若 doctor 返回 SERVICE_DISABLED，打开激活 URL 启用 API 后重试。分析查询应先窄后宽。写操作先 dry-run 并展示目标/动作 JSON，获批准后再 --execute。涉及端点行为、授权范围、配额或维度时查阅 references/google-search-console-api.md。
适用场景：SEO 诊断、搜索表现分析、索引状态检查、站点地图管理。