SuperAPI AI 工具集

google-search-console

通用与其它

查看项目

更新于 10-16 02:29

技能介绍

用途:gsc 是封装 Search Console API(webmasters v3、searchconsole v1)与 PageSpeed Insights API(v5)的 Python CLI,覆盖搜索分析、站点管理、站点地图、URL 检查和 Lighthouse 性能测试。所有命令输出 JSON 到 stdout,错误写到 stderr,便于程序解析。

首次使用:确认已安装 uv(which uv),缺失时需用户决定安装方式;执行 uv sync --project <skill-dir>;完成 OAuth 认证与 PageSpeed API key 配置。调用形式为 uv run --project /path/to/skills/google-search-console gsc <command> [args]。

主要命令:auth 管理认证(gsc auth login --client-secret /path/to/client_secret.json、auth status、auth logout);config 管理设置(仅 pagespeed-api-key 为有效键);query 做搜索分析,支持 -s/-e 日期、-d 分组、--query-filter、--device-filter、--search-type、--row-limit/--start-row,过滤前缀 = 精确、! 非包含、无前缀或 ~ 为包含;inspect 检查 URL 收录;sites 管理资源;sitemaps 列出/获取/提交/删除站点地图;pagespeed 运行审计,支持 --strategy、--category、--locale。

站点格式:域名资源为 sc-domain:example.com,覆盖所有子域、协议与路径;URL 前缀资源为 https://example.com/,仅精确前缀匹配,建议优先用域名资源。

配置与限制:凭据存于 ~/.config/skills/gsc/credentials.json,配置存于 config.json,可用 GSC_CONFIG_DIR 覆盖。无头机器需先建 SSH 隧道再完成 OAuth。PageSpeed 需 API key,实验室测试约 30-60 秒,命令超时 120 秒。API 有每分钟与每日配额,超限需等待 60 秒重试。认证账号须为资源已验证的拥有者或用户。仅能检查已验证资源内的 URL,未收录时 inspect 可能无数据。收费、价格等信息暂未提供。