google-search-console

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Google Search Console Skill

Google Search Console Skill

Monitor and optimize search performance with Google Search Console.
使用Google Search Console监控并优化搜索性能。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/google-search-console/install.sh | bash
Or manually:
bash
cp -r skills/google-search-console ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/google-search-console/install.sh | bash
或者手动安装:
bash
cp -r skills/google-search-console ~/.canifi/skills/

Setup

配置

Configure via canifi-env:
bash
undefined
通过canifi-env进行配置:
bash
undefined

First, ensure canifi-env is installed:

首先,确保已安装canifi-env:

canifi-env set GOOGLE_CLIENT_ID "your_client_id" canifi-env set GOOGLE_CLIENT_SECRET "your_client_secret" canifi-env set GOOGLE_REFRESH_TOKEN "your_refresh_token" canifi-env set GSC_SITE_URL "your_site_url"
undefined
canifi-env set GOOGLE_CLIENT_ID "your_client_id" canifi-env set GOOGLE_CLIENT_SECRET "your_client_secret" canifi-env set GOOGLE_REFRESH_TOKEN "your_refresh_token" canifi-env set GSC_SITE_URL "your_site_url"
undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
您的凭据,由您掌控。 Canifi LifeOS尊重您的隐私。

Option 1: Manual Browser Login (Recommended)

选项1:手动浏览器登录(推荐)

If you prefer not to share credentials with Claude Code:
  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password
如果您不想与Claude Code共享凭据:
  1. 使用CDP模式完成浏览器自动化设置
  2. 在Playwright控制的Chrome窗口中手动登录该服务
  3. Claude将使用您的已认证会话,全程不会获取您的密码

Option 2: Environment Variables

选项2:环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果您愿意共享凭据,可以将其存储在本地:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意:存储在canifi-env中的凭据仅可在您的本地机器上访问,绝不会被传输。

Capabilities

功能

  1. Performance Analysis: Track search impressions, clicks, and positions
  2. Index Coverage: Monitor indexing status and errors
  3. URL Inspection: Check specific URL indexing and crawl status
  4. Sitemap Management: Submit and monitor sitemaps
  5. Mobile Usability: Check mobile-friendly issues
  1. 性能分析:追踪搜索展示次数、点击量和排名位置
  2. 索引覆盖:监控索引状态和错误
  3. URL检查:查看特定URL的索引和抓取状态
  4. 站点地图管理:提交并监控站点地图
  5. 移动端可用性:检查移动端适配问题

Usage Examples

使用示例

Get Search Performance

获取搜索性能数据

User: "Show me search performance for the last 28 days"
Assistant: Returns clicks, impressions, CTR, and position
用户:“展示过去28天的搜索性能数据”
助手:返回点击量、展示次数、点击率(CTR)和排名位置

Check Top Queries

查看热门搜索查询

User: "What are my top search queries?"
Assistant: Returns top queries by clicks and impressions
用户:“我的热门搜索查询有哪些?”
助手:返回按点击量和展示次数排序的热门查询

Index Status

索引状态检查

User: "Are there any indexing issues?"
Assistant: Returns index coverage report
用户:“存在索引问题吗?”
助手:返回索引覆盖报告

Inspect URL

检查URL索引情况

User: "Is this page indexed by Google?"
Assistant: Returns indexing status for URL
用户:“这个页面被谷歌收录了吗?”
助手:返回该URL的索引状态

Authentication Flow

认证流程

  1. Create project in Google Cloud Console
  2. Enable Search Console API
  3. Set up OAuth 2.0 credentials
  4. Verify site ownership in Search Console
  1. 在Google Cloud Console中创建项目
  2. 启用Search Console API
  3. 设置OAuth 2.0凭据
  4. 在Search Console中验证网站所有权

Error Handling

错误处理

ErrorCauseSolution
401 UnauthorizedToken expiredRefresh access token
403 ForbiddenNo site accessVerify site ownership
404 Not FoundSite not foundCheck site URL
429 Rate LimitedQuota exceededWait for quota reset
错误原因解决方案
401 Unauthorized令牌过期刷新访问令牌
403 Forbidden无网站访问权限验证网站所有权
404 Not Found未找到网站检查网站URL
429 Rate Limited配额超限等待配额重置

Notes

说明

  • Free tool from Google
  • 16 months of historical data
  • Core Web Vitals reporting
  • Rich results reporting
  • Manual actions visibility
  • Integrates with Analytics
  • 谷歌官方免费工具
  • 提供16个月的历史数据
  • 核心网页指标(Core Web Vitals)报告
  • 富媒体结果报告
  • 手动操作记录可见
  • 可与Analytics集成