{
  "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": {
    "downloadMode": "redirect",
    "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",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/google-search-console-cli",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Google Search Console CLI Skill",
        "body": "Use this skill to operate and troubleshoot the gsc CLI in this repository."
      },
      {
        "title": "When To Use",
        "body": "Use this skill when the task involves any of:\n\nsetting up OAuth credentials for Google Search Console\nauthenticating this CLI\nlisting properties, managing sitemaps, URL inspection, or Search Analytics queries\ndiagnosing auth/config/API connectivity issues"
      },
      {
        "title": "Prerequisites",
        "body": "Python environment with this project installed (gsc command available)\nA Google account with access to at least one Search Console property\nSearch Console API enabled for the Google Cloud project used by OAuth"
      },
      {
        "title": "Install This CLI",
        "body": "Recommended (pipx, global gsc command):\n\npython3 -m pip install --user pipx\npython3 -m pipx ensurepath\npipx install google-search-console-cli\ngsc --version\n\nFrom source (development):\n\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -e \".[dev]\"\ngsc --help\n\nFrom source (pipx, editable):\n\npipx install -e /absolute/path/to/google-search-console-cli\ngsc --help"
      },
      {
        "title": "OAuth Client Setup In Google Cloud (Desktop App)",
        "body": "As of February 26, 2026, create OAuth client credentials in Google Cloud Console using these steps:\n\nOpen Google Cloud Console and select/create a project.\nEnable the Search Console API for that project.\nConfigure OAuth consent screen:\n\nchoose External for personal/testing usage (or Internal for Workspace org-only)\nfill required app fields (app name, support email, developer contact)\nadd your Google account as a test user if app is in testing mode\n\n\nGo to APIs & Services -> Credentials.\nClick Create credentials -> OAuth client ID.\nChoose application type Desktop app.\nCreate and download the OAuth client JSON (client_secret_*.json).\n\nNotes:\n\nUI labels can shift, but you must end with a Desktop OAuth client JSON file.\nKeep the downloaded JSON private."
      },
      {
        "title": "Authenticate This CLI",
        "body": "Preferred login flow:\n\ngsc auth login --client-secret /absolute/path/to/client_secret.json\n\nUseful auth options:\n\n--readonly: request readonly scope only (webmasters.readonly)\n--no-launch-browser: print the auth URL without auto-opening a browser\n\nVerify credentials:\n\ngsc auth whoami\ngsc doctor\n\nDefault storage paths:\n\ncredentials: ~/.config/gsc-cli/credentials.json\napp config: ~/.config/gsc-cli/config.json\n\nEnv overrides:\n\nGSC_CREDENTIALS_FILE\nGSC_APP_CONFIG_FILE\nGSC_CONFIG_DIR"
      },
      {
        "title": "Optional: Set Default Property",
        "body": "gsc config set default-site sc-domain:example.com\ngsc config get default-site\n\nWhen set, commands that accept --site can omit it."
      },
      {
        "title": "Command Reference",
        "body": "Top-level:\n\ngsc --version\ngsc --help\ngsc doctor"
      },
      {
        "title": "auth",
        "body": "gsc auth login --client-secret FILE [--readonly] [--no-launch-browser]\ngsc auth whoami [--output table|json]"
      },
      {
        "title": "config",
        "body": "gsc config set default-site SITE_URL\ngsc config get default-site"
      },
      {
        "title": "site",
        "body": "gsc site list [--output table|json|csv] [--csv-path FILE]\ngsc site get [--site SITE] [--output table|json|csv] [--csv-path FILE]\ngsc site add [--site SITE]\n\nSITE example: sc-domain:example.com."
      },
      {
        "title": "sitemap",
        "body": "gsc sitemap list [--site SITE] [--sitemap-index TEXT] [--output table|json|csv] [--csv-path FILE]\ngsc sitemap get [--site SITE] --feedpath TEXT [--output table|json|csv] [--csv-path FILE]\ngsc sitemap submit [--site SITE] --feedpath TEXT\ngsc sitemap delete [--site SITE] --feedpath TEXT\n\n--feedpath alias: --path."
      },
      {
        "title": "url",
        "body": "gsc url inspect [--site SITE] --url URL [--language-code CODE] [--output table|json|csv] [--csv-path FILE]\n\nDefaults:\n\n--language-code en-US"
      },
      {
        "title": "analytics",
        "body": "gsc analytics query --start-date YYYY-MM-DD --end-date YYYY-MM-DD [options]\n\nOptions:\n\n--site SITE\n--dimension country|date|device|hour|page|query|searchAppearance (repeatable)\n--type discover|googleNews|image|news|video|web\n--aggregation-type auto|byNewsShowcasePanel|byPage|byProperty\n--row-limit 1..25000\n--start-row >=0\n--data-state all|final|hourly_all\n--filter dimension:operator:expression (repeatable)\n--output table|json|csv\n--csv-path FILE\n\nSupported filter dimensions:\n\ncountry, device, page, query, searchAppearance\n\nSupported filter operators:\n\ncontains, equals, notContains, notEquals, includingRegex, excludingRegex\n\nConstraint:\n\n--aggregation-type byProperty cannot be combined with page dimension or page filter."
      },
      {
        "title": "Quick Examples",
        "body": "# List properties\ngsc site list\n\n# Get one property\ngsc site get --site sc-domain:example.com\n\n# List sitemaps\ngsc sitemap list --site sc-domain:example.com\n\n# Inspect one URL\ngsc url inspect --site sc-domain:example.com --url https://example.com/page --output json\n\n# Analytics query\ngsc analytics query \\\n  --site sc-domain:example.com \\\n  --start-date 2026-01-01 \\\n  --end-date 2026-01-31 \\\n  --dimension date \\\n  --dimension query \\\n  --filter query:contains:brand"
      },
      {
        "title": "Troubleshooting",
        "body": "Auth error: Stored credentials do not include required scope ...\n\nRe-run login with needed scope. For write commands, run login without --readonly.\n\n\n\nNo local OAuth credentials found...\n\nRun: gsc auth login --client-secret <path>\n\n\n\nNo site specified. Pass --site or set one...\n\npass --site or set default via gsc config set default-site ...\n\n\n\nAPI failures / uncertain setup state\n\nrun gsc doctor first, then address failing checks."
      }
    ],
    "body": "Google Search Console CLI Skill\n\nUse this skill to operate and troubleshoot the gsc CLI in this repository.\n\nWhen To Use\n\nUse this skill when the task involves any of:\n\nsetting up OAuth credentials for Google Search Console\nauthenticating this CLI\nlisting properties, managing sitemaps, URL inspection, or Search Analytics queries\ndiagnosing auth/config/API connectivity issues\nPrerequisites\nPython environment with this project installed (gsc command available)\nA Google account with access to at least one Search Console property\nSearch Console API enabled for the Google Cloud project used by OAuth\nInstall This CLI\n\nRecommended (pipx, global gsc command):\n\npython3 -m pip install --user pipx\npython3 -m pipx ensurepath\npipx install google-search-console-cli\ngsc --version\n\n\nFrom source (development):\n\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -e \".[dev]\"\ngsc --help\n\n\nFrom source (pipx, editable):\n\npipx install -e /absolute/path/to/google-search-console-cli\ngsc --help\n\nOAuth Client Setup In Google Cloud (Desktop App)\n\nAs of February 26, 2026, create OAuth client credentials in Google Cloud Console using these steps:\n\nOpen Google Cloud Console and select/create a project.\nEnable the Search Console API for that project.\nConfigure OAuth consent screen:\nchoose External for personal/testing usage (or Internal for Workspace org-only)\nfill required app fields (app name, support email, developer contact)\nadd your Google account as a test user if app is in testing mode\nGo to APIs & Services -> Credentials.\nClick Create credentials -> OAuth client ID.\nChoose application type Desktop app.\nCreate and download the OAuth client JSON (client_secret_*.json).\n\nNotes:\n\nUI labels can shift, but you must end with a Desktop OAuth client JSON file.\nKeep the downloaded JSON private.\nAuthenticate This CLI\n\nPreferred login flow:\n\ngsc auth login --client-secret /absolute/path/to/client_secret.json\n\n\nUseful auth options:\n\n--readonly: request readonly scope only (webmasters.readonly)\n--no-launch-browser: print the auth URL without auto-opening a browser\n\nVerify credentials:\n\ngsc auth whoami\ngsc doctor\n\n\nDefault storage paths:\n\ncredentials: ~/.config/gsc-cli/credentials.json\napp config: ~/.config/gsc-cli/config.json\n\nEnv overrides:\n\nGSC_CREDENTIALS_FILE\nGSC_APP_CONFIG_FILE\nGSC_CONFIG_DIR\nOptional: Set Default Property\ngsc config set default-site sc-domain:example.com\ngsc config get default-site\n\n\nWhen set, commands that accept --site can omit it.\n\nCommand Reference\n\nTop-level:\n\ngsc --version\ngsc --help\ngsc doctor\nauth\ngsc auth login --client-secret FILE [--readonly] [--no-launch-browser]\ngsc auth whoami [--output table|json]\nconfig\ngsc config set default-site SITE_URL\ngsc config get default-site\nsite\ngsc site list [--output table|json|csv] [--csv-path FILE]\ngsc site get [--site SITE] [--output table|json|csv] [--csv-path FILE]\ngsc site add [--site SITE]\n\nSITE example: sc-domain:example.com.\n\nsitemap\ngsc sitemap list [--site SITE] [--sitemap-index TEXT] [--output table|json|csv] [--csv-path FILE]\ngsc sitemap get [--site SITE] --feedpath TEXT [--output table|json|csv] [--csv-path FILE]\ngsc sitemap submit [--site SITE] --feedpath TEXT\ngsc sitemap delete [--site SITE] --feedpath TEXT\n\n--feedpath alias: --path.\n\nurl\ngsc url inspect [--site SITE] --url URL [--language-code CODE] [--output table|json|csv] [--csv-path FILE]\n\nDefaults:\n\n--language-code en-US\nanalytics\ngsc analytics query --start-date YYYY-MM-DD --end-date YYYY-MM-DD [options]\n\nOptions:\n\n--site SITE\n--dimension country|date|device|hour|page|query|searchAppearance (repeatable)\n--type discover|googleNews|image|news|video|web\n--aggregation-type auto|byNewsShowcasePanel|byPage|byProperty\n--row-limit 1..25000\n--start-row >=0\n--data-state all|final|hourly_all\n--filter dimension:operator:expression (repeatable)\n--output table|json|csv\n--csv-path FILE\n\nSupported filter dimensions:\n\ncountry, device, page, query, searchAppearance\n\nSupported filter operators:\n\ncontains, equals, notContains, notEquals, includingRegex, excludingRegex\n\nConstraint:\n\n--aggregation-type byProperty cannot be combined with page dimension or page filter.\nQuick Examples\n# List properties\ngsc site list\n\n# Get one property\ngsc site get --site sc-domain:example.com\n\n# List sitemaps\ngsc sitemap list --site sc-domain:example.com\n\n# Inspect one URL\ngsc url inspect --site sc-domain:example.com --url https://example.com/page --output json\n\n# Analytics query\ngsc analytics query \\\n  --site sc-domain:example.com \\\n  --start-date 2026-01-01 \\\n  --end-date 2026-01-31 \\\n  --dimension date \\\n  --dimension query \\\n  --filter query:contains:brand\n\nTroubleshooting\n\nAuth error: Stored credentials do not include required scope ...\n\nRe-run login with needed scope. For write commands, run login without --readonly.\n\nNo local OAuth credentials found...\n\nRun: gsc auth login --client-secret <path>\n\nNo site specified. Pass --site or set one...\n\npass --site or set default via gsc config set default-site ...\n\nAPI failures / uncertain setup state\n\nrun gsc doctor first, then address failing checks."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/NmadeleiDev/google-search-console-cli",
    "publisherUrl": "https://clawhub.ai/NmadeleiDev/google-search-console-cli",
    "owner": "NmadeleiDev",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}