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 new URLs) and "index-now" (submit specific URLs immediately). Requires a Google Cloud service account JSON key with Indexing API enabled and Search Console ownership.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/geoly-geo/auto-indexAuto-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
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-geoly-geo-auto-index": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
geo-human-editor
Audit and rewrite content to remove AI-generated feel by stripping markdown artifacts, eliminating AI vocabulary patterns, flagging hallucination risks, and restoring natural human voice. Use whenever the user mentions content sounding like AI, removing AI tone, making content more human, checking for AI feel, fixing mechanical writing patterns, or scanning for hallucinations and unverified claims in content.
geo-competitor-scanner
Analyze competitor GEO (Generative Engine Optimization) strategies by examining their content structure, Schema markup, llms.txt, and AI citation signals. Benchmark your brand against competitors and identify strategic gaps and opportunities. Use whenever the user mentions scanning competitor GEO strategies, comparing AI search performance, analyzing competitor content for AI citations, finding GEO gaps, or wants to understand how competitors win AI citations.
geo-report-builder
Build comprehensive GEO performance reports with executive summaries, platform breakdowns, competitive analysis, and strategic action plans. Use whenever the user mentions creating GEO reports, analyzing AI search performance, building performance dashboards, or generating insights from GEO metrics.
geo-studio
Master GEO content orchestrator that understands user goals and intelligently routes tasks across specialized GEO skills. Automatically selects the right workflow from strategy and audit to content creation, optimization, and human editing. Use as the default starting point for any GEO-related task including creating GEO content, ranking in AI search, auditing content for AI visibility, building GEO strategies, writing AI-citable articles, or when unsure which specific GEO skill to use.
geo-schema-gen
Generate complete, validated Schema.org JSON-LD markup for any content type to boost AI citation rates. Creates structured data for Organization, FAQPage, Article, BlogPosting, Product, HowTo, BreadcrumbList, WebSite, VideoObject, and ImageObject schemas. Use whenever the user mentions adding schema markup, generating structured data, creating JSON-LD, implementing Schema.org, optimizing for rich snippets, or wants to improve how AI understands and cites their content. Also trigger for requests about Organization schema, FAQ schema, Article markup, Product schema, or any structured data implementation.