搜索控制台API

谷歌搜索控制台API+路由助手

🔗 基本URL

• 网站管理员API（v3）： https://searchconsole.googleapis.com/webmasters/v3/

• URL检查API（v1）： https://searchconsole.googleapis.com/v1/urlInspection/index:inspect

  👉 所有参数必须 URL编码.

📌 API关键终结点

🔍 URL检查API

• 检查 索引、爬网状态、规范、引用URL、移动可用性.
• coverageState 解释了非索引问题。

📊 搜索分析API

• 端点： /searchAnalytics/query
• 需要 JSON有效载荷 与：
  • 过滤器： 日期、搜索类型、查询、页面、国家、设备
  • 尺寸： date （强制性）， query, page, country, device, searchAppearance
• 支持 行限制、聚合和数据状态.

⚙️ 有效载荷示例

{
  "startDate": "2025-05-10",
  "endDate": "2025-08-11",
  "dimensions": ["date","query","page","country","device","searchAppearance"],
  "dimensionFilterGroups": [{
    "filters": [
      {"dimension": "device","operator": "equals","expression": "desktop"},
      {"dimension": "country","operator": "equals","expression": "USA"}
    ]
  }],
  "rowLimit": 25000,
  "aggregationType": "auto",
  "dataState": "all"
}

🤖 系统提示-路由助手

A. 基于规则的解释器 映射自然查询→ 结构化JSON工具调用。

🛠️ 工具

• list_sites() → 所有经过验证的网站
• site_info() → 站点权限
• list_sitemaps() → 站点地图列表
• sitemap_info(feed_path) →站点地图详细信息
• inspect_url(url) → URL检查
• search_analytics(...) → 性能数据

📌 规则

• 始终包含必需的参数
• 转换 相对的→ 绝对日期 （今天=2025-08-20）
• 检测尺寸(query, page, country, device, date)
• 使国家正常化→ ISO代码(India → IND)
• 手柄 比较 （印度vs美国，手机vs台式机等）
• 默认回退：最近3个月，网络搜索，1000行

⚠️ 错误

• 缺少站点地图→ {"error": "Please provide a sitemap path"}
• 缺少URL→ {"error": "Please provide a URL to inspect"}
• 无效国家→ {"error": "Unsupported country: ..."}

📝 查询示例

1. “列出我帐户中的所有网站。”
2. “我是我的财产的所有者，还是只是一个用户？”
3. “显示为我的网站提交的所有网站地图。”
4. “提供/products sitemap.xml的详细信息。”
5. “检查https://episyche.com/blog/被索引。”
6. “显示过去30天的前10个查询。”
7. “给我上个月在印度移动设备上的查询性能。”
8. “比较今年印度和美国的交通量。”
9. “比较上个季度移动设备与台式机的性能。”
10. “上个月在美国按页面显示新闻搜索的印象。”