/install auto-index
Auto-Index — Google Indexing API
Submit URLs to Google for fast indexing via the Google Indexing API.
Prerequisites
- Google Cloud Project with the Indexing API enabled
- Service Account with a downloaded JSON key file
- Google Search Console — add the service account email as an Owner of the property
Environment
| Variable | Required | Description |
|---|---|---|
GOOGLE_INDEX_SA_KEY |
Yes (or --sa-key) |
Absolute path to service account JSON key file |
How to Invoke
Run using uv run with the script's absolute path. The script directory is relative to the skill root.
auto-index — Sitemap diff
Fetches a sitemap, compares against a local cache, and submits only new URLs.
uv run scripts/google_index.py auto-index --sitemap "https://example.com/sitemap.xml"
Force re-index all URLs (ignore cache):
uv run scripts/google_index.py auto-index --sitemap "https://example.com/sitemap.xml" --force
index-now — Submit URL(s) immediately
uv run scripts/google_index.py index-now --url "https://example.com/new-page"
Multiple URLs:
uv run scripts/google_index.py index-now -u "https://example.com/page1" -u "https://example.com/page2"
Notify URL deletion:
uv run scripts/google_index.py index-now --url "https://example.com/old-page" --delete
CLI Reference
auto-index
| Flag | Description |
|---|---|
--sitemap, -s |
(required) Sitemap URL to fetch |
--sa-key, -k |
Path to service account JSON key (overrides env) |
--force, -f |
Re-index all URLs, ignoring cache |
index-now
| Flag | Description |
|---|---|
--url, -u |
(required) URL to submit — repeatable for multiple URLs |
--sa-key, -k |
Path to service account JSON key (overrides env) |
--delete, -d |
Notify deletion instead of update |
Output Format
Both commands output structured 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"
}
]
}
Cache
Sitemap URL cache is stored at ~/.cache/auto-index/sitemap-cache.json. This allows auto-index to only submit URLs that are new since the last run.
Delete the cache file to reset:
rm ~/.cache/auto-index/sitemap-cache.json
Quota
Google Indexing API allows 200 requests/day. The script auto-caps at this limit and logs a warning if exceeded.
Common Failures
| Error | Fix |
|---|---|
No service account key provided |
Set GOOGLE_INDEX_SA_KEY env or pass --sa-key |
Service account key file not found |
Check the file path |
403 / Permission denied |
Ensure the SA email is an Owner in Search Console |
429 / Quota exceeded |
Wait 24h or request quota increase in Cloud Console |
No URLs found in sitemap |
Check the sitemap URL is valid and accessible |
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install auto-index - 安装完成后,直接呼叫该 Skill 的名称或使用
/auto-index触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Google SEO GEO Auto Index 是什么?
Google Indexing API tool. Use when user wants to submit URLs for Google indexing. Supports two modes: "auto-index" (fetch sitemap, diff against cache, submit... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 284 次。
如何安装 Google SEO GEO Auto Index?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install auto-index」即可一键安装,无需额外配置。
Google SEO GEO Auto Index 是免费的吗?
是的,Google SEO GEO Auto Index 完全免费(开源免费),可自由下载、安装和使用。
Google SEO GEO Auto Index 支持哪些平台?
Google SEO GEO Auto Index 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Google SEO GEO Auto Index?
由 GEOLY AI(@geoly-geo)开发并维护,当前版本 v1.0.0。