数据分析

Google Search Console

试用

通过命令行查询 Google Search Console 数据,获取搜索表现与索引情况。

它能做什么

围绕 Google Search Console API 的只读命令行封装,支持搜索分析、URL 索引状态和站点地图查询。可按 query、page、country、device、date 等维度筛选,返回 clicks、impressions、CTR 和平均排名等指标,适合排查低点击率页面、热门搜索词和站点地图健康度。工具不会修改站点属性,OAuth 凭据也仅在当前会话内使用。

什么时候用它

  • 发现高曝光、低点击率的可优化页面
  • 列出为站点带来流量的搜索词
  • 检查单个 URL 的抓取与索引状态
  • 查看已提交的站点地图是否存在错误

技能文档

Google Search Console Skill

Query GSC for search analytics, indexing status, and SEO insights.

Safety Boundaries

  • This skill only connects to Google Search Console API endpoints.
  • It does NOT modify your Search Console property — read-only queries only.
  • It does NOT store or transmit credentials beyond the current session.
  • It requires OAuth credentials set as environment variables.

Setup

  1. Credentials: Set OAuth credentials in environment variables (or a local .env loaded by your shell)
  2. Scopes: Requires webmasters.readonly scope on your Google Cloud OAuth consent screen
  3. Access: Your Google account must have access to the Search Console properties

Commands

List Available Sites

python scripts/gsc_query.py sites

Top Search Queries

python scripts/gsc_query.py top-queries \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

Top Pages by Traffic

python scripts/gsc_query.py top-pages \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

Find Low-CTR Opportunities

High impressions but low click-through rate = optimization opportunities:

python scripts/gsc_query.py opportunities \
  --site "https://www.nutrient.io" \
  --days 28 \
  --min-impressions 100

Inspect URL Indexing Status

python scripts/gsc_query.py inspect-url \
  --site "https://www.nutrient.io" \
  --url "/sdk/web"

List Sitemaps

python scripts/gsc_query.py sitemaps \
  --site "https://www.nutrient.io"

Raw Search Analytics (JSON)

python scripts/gsc_query.py search-analytics \
  --site "https://www.nutrient.io" \
  --days 28 \
  --dimensions query page \
  --limit 100

Available Dimensions

  • query - Search query
  • page - Landing page URL
  • country - Country code
  • device - DESKTOP, MOBILE, TABLET
  • date - Date

Metrics Returned

  • clicks - Number of clicks from search
  • impressions - Number of times shown in search
  • ctr - Click-through rate (clicks/impressions)
  • position - Average ranking position

SEO Use Cases

  1. Content Optimization: Find high-impression/low-CTR pages → improve titles & descriptions
  2. Keyword Research: See what queries bring traffic → create more content around them
  3. Technical SEO: Check indexing status, find crawl issues
  4. Ranking Tracking: Monitor position changes over time
  5. Sitemap Health: Verify sitemaps are submitted and error-free

Notes

  • Data has ~3 day delay (GSC limitation)
  • Credentials shared with GA4 skill
  • URL inspection requires the page to be in the property

相关技能

GSC Connect - Google Search Console

Connect OpenClaw or another MCP-compatible agent to Google Search Console and retrieve official read-only properties, performance, sitemap, and URL inspection data. Use for clicks, impressions, CTR, average position, queries, pages, countries, devices, dates, and indexing investigations.

1 次安装

seo-google

Google SEO APIs: Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, and GA4 organic traffic. Provides real Google field data for Core Web Vitals, indexation status, search performance, and organic traffic trends. Use when user says "search console", "GSC", "PageSpeed", "CrUX", "field data", "indexing API", "GA4 organic", "URL inspection", or "real CWV data".

Google Analytics 4

Read Google Analytics 4 reporting data through the GA4 Data API. Use for explicit GA4 property metadata, compatible metric/dimension reports, traffic analysis, key events, quotas, and bounded exports.

168 次安装1 星标

google-search-console

通过托管 OAuth 代理接入 Google Search Console,查询搜索分析数据、管理 sitemap 并查看站点表现。

265 次安装10 星标

scraping-google-search-results

Scrapes Google search results for any query using apidojo's Google Search scraper on Apify. Triggers when the user asks to: get Google search results for a keyword, scrape SERP data for a query, export Google results to a dataset, fetch URLs and snippets from Google for a search term, get all results from a Google search, or collect Google SERP data for multiple keywords. Returns URL, title, snippet, position, and SERP feature type per result. Ideal for SEO analysts, researchers, journalists, and competitive intelligence teams.

1 次安装