# Google 搜索控制台技能 **由[归零公司]()创建** Claude Code 的全面 Google Search Console API 技能，提供搜索分析、URL 检查、站点地图管理和站点验证功能。 ## 何时使用 * 用户提及“Google Search Console”、“GSC”、“搜索控制台” * 用户询问搜索效果、点击次数、展示次数、点击率 * 用户需要URL索引状态或检查 * 用户想要管理站点地图 * 用户询问搜索排名或索引状态 * 用户需要来自Google的SEO分析数据 ## 特点 ### 1\. **搜索分析** ⭐ * 查询搜索效果数据（点击次数、展示次数、CTR、排名） * 按日期范围、页面、查询、国家/地区、设备过滤 * 按维度分组（查询、页面、国家/地区、设备、日期） * 比较时间段 * 导出为 CSV/JSON ### 2\. **网址检查** * 检查特定 URL 的索引状态 * 查看抓取信息 * 检查移动可用性 * 识别索引问题 * 请求为 URL 建立索引 ### 3\. **站点地图管理** * 列出站点的所有站点地图 * 提交新的站点地图 * 删除站点地图 * 检查站点地图状态和错误 ### 4\. **现场管理** * 列出所有经过验证的网站 * 添加新站点 * 删除网站 * 检查验证状态 ## 环境变量该技能使用由“jelly-dotenv”管理的环境变量。有关配置详细信息，请参阅“skills/jelly-dotenv/SKILL.md”。 ### 选项 1：服务帐户（推荐） # 服务帐户 JSON 密钥文件路径 GOOGLE_SERVICE_ACCOUNT_KEY_FILE=/path/to/service-account.json # 或内联 JSON（适用于 CI/CD 环境） GOOGLE_SERVICE_ACCOUNT_KEY_JSON='{"type":"service_account","project_id":"...","private_key":"..."}' ### 选项 2：OAuth 2.0 客户端凭据 GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=您的客户秘密 GOOGLE_REFRESH_TOKEN=您的刷新令牌 ### 常用设置 # 默认站点 URL（可选，可以根据请求指定） GOOGLE_SEARCH_CONSOLE_SITE_URL=https://your-site.com # 替代命名模式（自动检测） GSC_SITE_URL=https://your-site.com SEARCH_CONSOLE_SITE=sc-domain:your-site.com 变量可以配置为： * `skills/jelly-dotenv/.env` （技能通用，最高优先级） * 项目根 `/.env` （项目特定，后备） ## 配置 ### 设置服务帐户 1. 前往 [Google Cloud Console]() 2. 创建一个新项目或选择现有项目 3.启用“Google搜索控制台API” 4. 创建服务帐户： * 转到 IAM 和管理 → 服务帐户 * 创建服务帐户 * 下载 JSON 密钥文件 5. 将服务帐户电子邮件添加到 Search Console： * 转到 [搜索控制台]() * 设置 → 用户和权限 * 使用服务帐户电子邮件添加用户 * 授予“完全”或“受限”访问权限 ### 设置 OAuth 2.0 1. 前往 [Google Cloud Console]() 2. 创建 OAuth 2.0 凭证（Web 应用程序） 3. 设置授权重定向URI 4. 使用 OAuth Playground 或您的应用程序获取刷新令牌 5. 所需范围：`https://www.googleapis.com/auth/webmasters.readonly` ## 使用场景 ### 场景 1：搜索性能概述 **用户请求**：“显示过去 7 天的搜索效果” **技能动作**： 1. 从环境加载凭证 2. 带有日期范围的查询搜索分析 API 3. 聚合点击次数、展示次数、CTR、排名 4. 格式化为包含趋势的 Markdown 表格 **输出**： ## 搜索效果（过去 7 天） |公制|价值|改变 | |--------|--------|--------| |点击次数 | 1,234 | 1,234 +12% | |印象 | 45,678 | +8% | |点击率| 2.7% | +0.3% | |平均排名 | 15.2 | 15.2 -2.1 | -2.1 ### 热门查询 |查询 |点击次数 |印象 |点击率|职位| |--------|--------|-------------|-----|----------| |关键词 1 | 234 | 234 5,678 | 5,678 4.1% | 8.5 | |关键词 2 | 189 | 189 4,321 | 4,321 4.4% | 12.3 | 12.3 ### 场景 2：URL 检查 **用户请求**：“检查的索引状态” **技能动作**： 1. 调用URL检查API 2. 解析索引结果 3. 检查覆盖状态 4. 显示移动可用性 **输出**： ## URL 检查：https://example.com/page |物业 |状态 | |----------|--------| |指数状态 | ✅ 索引 | |爬行| 2024-01-15 | |规范| https://example.com/page | |移动可用性 | ✅ 移动友好 | |丰富的结果 | ⚠️ 2 条警告 | ### 场景 3：站点地图管理 **用户请求**：“显示所有站点地图并提交新站点地图” **技能动作**： 1. 列出现有站点地图 2. 显示状态和最后提交日期 3. 提交新的站点地图 URL 4.确认提交 ### 场景 4：热门页面分析 **用户请求**：“我的表现最好的页面是什么？” **技能动作**： 1. 按页面分组的查询搜索分析 2.按点击次数排序 3. 包括展示次数、点击率、排名 4.突出展示次数高但点击率低的页面 ## API 参考 ### 搜索分析查询接口搜索分析请求{ 开始日期：字符串； // 年-月-日结束日期：字符串； // 年-月-日尺寸？: ('查询' | '页面' | '国家' | '设备' | '日期')[]; 搜索类型？： '网络' | '图像' | '视频' | '消息'; 维度过滤器组？：过滤器组[]；聚合类型？： '自动' | '按页' | '按属性'； rowLimit？：数字； // 最大 25000 开始行？：数字； } ### URL检查接口 UrlInspectionRequest { 检查网址：字符串；站点网址：字符串；语言代码？：字符串； } ### 站点地图操作运营|方法|端点 ---|---|--- 列表 |获取 | `/webmasters/v3/sites/{siteUrl}/sitemaps` 获取 |获取 | `/webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}` 提交 |放置 | `/webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}` 删除 |删除 | `/webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath}` ## 输出格式 ### Markdown（默认） * 带有指标的格式化表格 * 趋势指标(↑↓) * 状态图标 (✅⚠️❌) * 总结见解 ### JSON * 原始API响应 * 完整的数据结构 * 程序化访问 ### CSV * 电子表格兼容导出 * 所有数据行 * 供进一步分析 ## 错误处理 ### 身份验证错误错误 |原因 |解决方案 ---|---|--- 401 未经授权 |凭证无效 |检查服务帐户密钥或 OAuth 令牌 403 禁止无法访问网站 |将服务帐号添加到 Search Console 无效范围 |错误的 OAuth 范围 |使用“webmasters.readonly”范围 ### API 错误错误 |原因 |解决方案 ---|---|--- 404 未找到 |网站不在 Search Console 中 |首先将网站添加到 Search Console 400 错误请求 |无效参数 |检查日期格式 (YYYY-MM-DD) 429 速率限制 |请求过多 |等待并通过退避重试 ### 常见问题 **“配置错误：找不到 Google 凭据”** # 解决方案：将凭据添加到 .env GOOGLE_SERVICE_ACCOUNT_KEY_FILE=/path/to/key.json **“找不到站点或无法访问”** # 解决方案：将服务帐户电子邮件添加到 Search Console # 转到：Search Console → 设置 → 用户和权限 **“日期范围无效”** # 解决方案：使用YYYY-MM-DD格式，最多16个月历史数据 ## 安全策略 ### 身份验证 * **服务帐户** ：推荐用于服务器端使用 * **OAuth 2.0** ：用于用户验证的请求 * **凭据** ：仅从环境变量加载 * **日志记录**：私钥和令牌自动编辑 ### 数据访问 * **默认只读** ：使用 `webmasters.readonly` 范围 * **写入操作**：站点地图提交/删除需要完整范围 * **站点范围**：访问仅限于授权站点 ### 速率限制 * **自动**：尊重 Google API 配额 * **重试**：429 错误时指数退避 * **每日配额**：每天 1,200 个查询（默认） ## 限制 * **历史数据** ：最多 16 个月的搜索数据 * **数据新鲜度**：搜索分析有 2-3 天的延迟 * **URL 检查**：每个站点每天 2,000 个请求 * **行限制** ：每个查询最多 25,000 行 * **维度** ：每个查询最多 3 个维度 ## 与 Claude 代码集成当用户提到以下内容时，该技能会自动激活： *“谷歌搜索控制台”，“gsc”，“搜索控制台” *“搜索性能”、“搜索分析” *“url检查”、“索引状态” *“站点地图”、“站点地图管理” *“seo 分析”、“seo 数据” 该技能将： 1. 从 .env 加载 Google 凭据 2. 执行请求的查询/操作 3. 将结果格式化为 Markdown 表格 4. 提供可行的见解和建议 ## 参考文献 * [Google Search Console API 文档]() * [搜索分析 API 参考]() * [URL 检查 API 参考]() * [OAuth 2.0 设置]() * [API 配额和限制]()

谷歌搜索控制台

包含技能