Auto-Index — Google 索引 API

通过 Google 索引 API 向 Google 提交 URL，实现快速索引。

前提条件

1. 已启用索引 API 的 Google Cloud 项目
2. 已下载 JSON 密钥文件的服务账号（Service Account）
3. Google Search Console — 将服务账号邮箱添加为该资源的 所有者（Owner）

环境变量

调用方式

使用 uv run 命令并指定脚本的绝对路径运行。脚本目录相对于 skill 根目录。

auto-index — 站点地图（Sitemap）差异比对

获取站点地图，与本地缓存进行比对，仅提交新增的 URL。

uv run scripts/google_index.py auto-index --sitemap "https://example.com/sitemap.xml"

强制重新索引全部 URL（忽略缓存）：

uv run scripts/google_index.py auto-index --sitemap "https://example.com/sitemap.xml" --force

index-now — 立即提交 URL

uv run scripts/google_index.py index-now --url "https://example.com/new-page"

提交多个 URL：

uv run scripts/google_index.py index-now -u "https://example.com/page1" -u "https://example.com/page2"

通知 URL 已删除：

uv run scripts/google_index.py index-now --url "https://example.com/old-page" --delete

CLI 参考

auto-index

index-now

输出格式

两个命令均输出结构化 JSON：

{
  "meta": {
    "action": "auto-index",
    "sitemap": "https://example.com/sitemap.xml",
    "timestamp": "2026-03-02T02:50:00+00:00",
    "total_in_sitemap": 42,
    "new_urls": 5,
    "submitted": 5,
    "success": 5,
    "failed": 0
  },
  "results": [
    {
      "url": "https://example.com/new-page",
      "status": 200,
      "notifyTime": "2026-03-02T02:50:01.123Z"
    }
  ]
}

缓存

站点地图 URL 缓存存储于 ~/.cache/auto-index/sitemap-cache.json。这使得 auto-index 仅提交自上次运行以来新增的 URL。

如需重置缓存，请删除该文件：

rm ~/.cache/auto-index/sitemap-cache.json

配额限制

Google 索引 API 允许每日最多 200 次请求。脚本会自动限制请求次数不超过该上限，并在超出时记录警告日志。

常见失败原因