← 返回 Skills 市场
geoly-geo

Google SEO GEO Auto Index

作者 GEOLY AI · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
284
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install 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...
使用说明 (SKILL.md)

Auto-Index — Google Indexing API

Submit URLs to Google for fast indexing via the Google Indexing API.

Prerequisites

  1. Google Cloud Project with the Indexing API enabled
  2. Service Account with a downloaded JSON key file
  3. 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
安全使用建议
This skill appears to implement exactly what it claims (submitting sitemap URLs to Google's Indexing API), but there are two things to consider before installing: 1) Metadata mismatch: The registry metadata says no credentials are needed, but the SKILL.md and the script require a Google service-account JSON key (GOOGLE_INDEX_SA_KEY or --sa-key). Treat that as an authoring error and verify the skill's requirements before proceeding. 2) Sensitive key handling: You must provide a Google service-account JSON file. Only supply a key from a service account scoped down to the Indexing API and nothing else; avoid using a high-privilege project owner key. Prefer creating a dedicated service account with the minimum permissions and add only the SA email as an Owner in Search Console as documented. Consider using ephemeral keys or rotating/revoking the key after use. 3) Network behavior: The tool will fetch whatever sitemap URL you provide and will follow redirects. If run on a machine with access to internal networks, a malicious or misconfigured sitemap URL could cause requests to internal hosts. Run in an environment you control, or inspect the sitemap contents before running. 4) Review and isolation: The included script is short and readable; you (or a trusted admin) should review it (it only talks to indexing.googleapis.com and to the provided sitemap URLs). If you proceed, run it in an isolated environment (container or dedicated machine) and ensure Python dependencies installed by uv come from trusted registries. 5) Ask the publisher to fix metadata: Request that the skill owner update registry metadata to declare the required env var (GOOGLE_INDEX_SA_KEY) and document the exact permissions the service account needs. If these precautions are acceptable, the skill's behavior is coherent with its purpose; if you cannot safely supply a minimal service-account key or cannot run it in an isolated environment, do not install or run it.
功能分析
Type: OpenClaw Skill Name: auto-index Version: 1.0.0 The skill provides a legitimate tool for interacting with the Google Indexing API. It correctly handles Google service account credentials, fetches sitemap URLs using standard HTTP libraries, and manages a local cache in a standard user cache directory. There is no evidence of intentional malicious behavior such as data exfiltration, unauthorized command execution, persistence mechanisms, or prompt injection attempts against the agent. The dependencies are standard and reputable. The script includes basic input validation for the service account key path and error handling for API interactions and sitemap parsing.
能力评估
Purpose & Capability
The SKILL.md and the included script clearly implement a Google Indexing API client that needs a Google service account JSON key (GOOGLE_INDEX_SA_KEY). However the registry metadata claims 'Required env vars: none' and 'Primary credential: none' — that's an incoherence. The credential is required for the stated purpose, so the metadata is incorrect or incomplete.
Instruction Scope
The runtime instructions are narrowly scoped to fetching a user-supplied sitemap, diffing against a local cache (~/.cache/auto-index/sitemap-cache.json), and calling the Google Indexing API. The script reads a local service-account JSON file and makes outbound HTTP requests (to the sitemap URL(s) and to https://indexing.googleapis.com). Fetching arbitrary sitemap URLs means the tool will follow redirects and can contact arbitrary hosts (including intranet addresses) if such URLs are provided — expected for this tool but worth noting.
Install Mechanism
There is no install spec (instruction-only skill) and no remote download. The script declares Python dependencies in its uv-inline metadata (google-auth, google-auth-httplib2, google-api-python-client, httpx). That is proportionate to the stated purpose and not unusual.
Credentials
The code and SKILL.md require a sensitive environment input (path to a Google service-account JSON key via GOOGLE_INDEX_SA_KEY or --sa-key). That is appropriate for the Indexing API, but the registry metadata fails to declare this requirement. The service account key is powerful — if the service account has broader permissions than intended, the key is highly sensitive. No other unrelated secrets are requested.
Persistence & Privilege
The skill does not request always: true and does not modify other skills or global agent config. It creates a cache at ~/.cache/auto-index/sitemap-cache.json and only stores sitemap URL lists and timestamps — expected behavior for caching.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install auto-index
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /auto-index 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of the auto-index Google Indexing API tool. - Supports two modes: "auto-index" (fetches sitemap, submits only new URLs), and "index-now" (immediate submission or deletion of specified URLs). - Requires a Google Cloud service account JSON key with Indexing API enabled and Google Search Console ownership. - Caches sitemap URLs locally to avoid duplicate submissions and allows easy cache reset. - Enforces Google Indexing API quota of 200 requests/day with built-in warning. - Outputs detailed structured JSON results for all actions.
元数据
Slug auto-index
版本 1.0.0
许可证
累计安装 0
当前安装数 0
历史版本数 1
常见问题

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。

💬 留言讨论