# Send Google Search Console CLI to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "google-search-console-cli",
    "name": "Google Search Console CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/NmadeleiDev/google-search-console-cli",
    "canonicalUrl": "https://clawhub.ai/NmadeleiDev/google-search-console-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/google-search-console-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-search-console-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "google-search-console-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T23:06:15.391Z",
      "expiresAt": "2026-05-10T23:06:15.391Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-search-console-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-search-console-cli",
        "contentDisposition": "attachment; filename=\"google-search-console-cli-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "google-search-console-cli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/google-search-console-cli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/google-search-console-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/google-search-console-cli",
    "agentUrl": "https://openagent3.xyz/skills/google-search-console-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/google-search-console-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/google-search-console-cli/agent.md"
  }
}
```
## Documentation

### Google Search Console CLI Skill

Use this skill to operate and troubleshoot the gsc CLI in this repository.

### When To Use

Use this skill when the task involves any of:

setting up OAuth credentials for Google Search Console
authenticating this CLI
listing properties, managing sitemaps, URL inspection, or Search Analytics queries
diagnosing auth/config/API connectivity issues

### Prerequisites

Python environment with this project installed (gsc command available)
A Google account with access to at least one Search Console property
Search Console API enabled for the Google Cloud project used by OAuth

### Install This CLI

Recommended (pipx, global gsc command):

python3 -m pip install --user pipx
python3 -m pipx ensurepath
pipx install google-search-console-cli
gsc --version

From source (development):

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
gsc --help

From source (pipx, editable):

pipx install -e /absolute/path/to/google-search-console-cli
gsc --help

### OAuth Client Setup In Google Cloud (Desktop App)

As of February 26, 2026, create OAuth client credentials in Google Cloud Console using these steps:

Open Google Cloud Console and select/create a project.
Enable the Search Console API for that project.
Configure OAuth consent screen:

choose External for personal/testing usage (or Internal for Workspace org-only)
fill required app fields (app name, support email, developer contact)
add your Google account as a test user if app is in testing mode


Go to APIs & Services -> Credentials.
Click Create credentials -> OAuth client ID.
Choose application type Desktop app.
Create and download the OAuth client JSON (client_secret_*.json).

Notes:

UI labels can shift, but you must end with a Desktop OAuth client JSON file.
Keep the downloaded JSON private.

### Authenticate This CLI

Preferred login flow:

gsc auth login --client-secret /absolute/path/to/client_secret.json

Useful auth options:

--readonly: request readonly scope only (webmasters.readonly)
--no-launch-browser: print the auth URL without auto-opening a browser

Verify credentials:

gsc auth whoami
gsc doctor

Default storage paths:

credentials: ~/.config/gsc-cli/credentials.json
app config: ~/.config/gsc-cli/config.json

Env overrides:

GSC_CREDENTIALS_FILE
GSC_APP_CONFIG_FILE
GSC_CONFIG_DIR

### Optional: Set Default Property

gsc config set default-site sc-domain:example.com
gsc config get default-site

When set, commands that accept --site can omit it.

### Command Reference

Top-level:

gsc --version
gsc --help
gsc doctor

### auth

gsc auth login --client-secret FILE [--readonly] [--no-launch-browser]
gsc auth whoami [--output table|json]

### config

gsc config set default-site SITE_URL
gsc config get default-site

### site

gsc site list [--output table|json|csv] [--csv-path FILE]
gsc site get [--site SITE] [--output table|json|csv] [--csv-path FILE]
gsc site add [--site SITE]

SITE example: sc-domain:example.com.

### sitemap

gsc sitemap list [--site SITE] [--sitemap-index TEXT] [--output table|json|csv] [--csv-path FILE]
gsc sitemap get [--site SITE] --feedpath TEXT [--output table|json|csv] [--csv-path FILE]
gsc sitemap submit [--site SITE] --feedpath TEXT
gsc sitemap delete [--site SITE] --feedpath TEXT

--feedpath alias: --path.

### url

gsc url inspect [--site SITE] --url URL [--language-code CODE] [--output table|json|csv] [--csv-path FILE]

Defaults:

--language-code en-US

### analytics

gsc analytics query --start-date YYYY-MM-DD --end-date YYYY-MM-DD [options]

Options:

--site SITE
--dimension country|date|device|hour|page|query|searchAppearance (repeatable)
--type discover|googleNews|image|news|video|web
--aggregation-type auto|byNewsShowcasePanel|byPage|byProperty
--row-limit 1..25000
--start-row >=0
--data-state all|final|hourly_all
--filter dimension:operator:expression (repeatable)
--output table|json|csv
--csv-path FILE

Supported filter dimensions:

country, device, page, query, searchAppearance

Supported filter operators:

contains, equals, notContains, notEquals, includingRegex, excludingRegex

Constraint:

--aggregation-type byProperty cannot be combined with page dimension or page filter.

### Quick Examples

# List properties
gsc site list

# Get one property
gsc site get --site sc-domain:example.com

# List sitemaps
gsc sitemap list --site sc-domain:example.com

# Inspect one URL
gsc url inspect --site sc-domain:example.com --url https://example.com/page --output json

# Analytics query
gsc analytics query \\
  --site sc-domain:example.com \\
  --start-date 2026-01-01 \\
  --end-date 2026-01-31 \\
  --dimension date \\
  --dimension query \\
  --filter query:contains:brand

### Troubleshooting

Auth error: Stored credentials do not include required scope ...

Re-run login with needed scope. For write commands, run login without --readonly.



No local OAuth credentials found...

Run: gsc auth login --client-secret <path>



No site specified. Pass --site or set one...

pass --site or set default via gsc config set default-site ...



API failures / uncertain setup state

run gsc doctor first, then address failing checks.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: NmadeleiDev
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T23:06:15.391Z
- Expires at: 2026-05-10T23:06:15.391Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/google-search-console-cli)
- [Send to Agent page](https://openagent3.xyz/skills/google-search-console-cli/agent)
- [JSON manifest](https://openagent3.xyz/skills/google-search-console-cli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/google-search-console-cli/agent.md)
- [Download page](https://openagent3.xyz/downloads/google-search-console-cli)