网站分析技能
该技能允许代理从 Google 和 Bing 拉取并分析流量数据,提供深入的 SEO 洞察。
环境准备
必要的脚本位于此 SKILL.md 文件所在目录的 scripts/ 子目录中。
请确保安装了以下依赖:
python3 -m pip install -r scripts/gsc-requirements.txt
所需凭据及获取方式
在执行此技能之前,请确保环境已配置完毕。如果用户缺少所需的凭据,代理应指导用户按照以下步骤获取:
1. Google OAuth 客户端密钥 (client_secret.json)
代理需要一个桌面版 OAuth 2.0 客户端 ID 才能访问 Google API。 用户指引:
- 前往 Google Cloud 控制台。
- 创建一个新项目或选择一个已有项目。
- 导航至 API 和服务 > 库,启用 Google Search Console API 和 Google Analytics Data API。
- 导航至 API 和服务 > OAuth 同意屏幕 并进行配置(可以将用户类型设置为“外部”,并将您自己的电子邮件添加为测试用户)。
- 导航至 API 和服务 > 凭据。点击 创建凭据 > OAuth 客户端 ID。
- 选择 桌面应用 作为应用程序类型。
- 点击创建,然后下载 JSON 文件。将其重命名为
client_secret.json,并放置在此技能的scripts/目录中。
2. Google OAuth 令牌 (token.json, google_analytics_token.json)
这些令牌由脚本自动生成。
- 代理说明: 如果脚本输出提示
正在打开浏览器进行授权,请告知用户检查其电脑上是否弹出了新的浏览器窗口,并完成 Google OAuth 登录。登录成功后,脚本会自动将令牌本地保存。
3. Bing API 密钥
用户指引:
- 前往 Bing 站长工具。
- 选择您已验证的网站。
- 点击右上角的 设置 齿轮图标。
- 进入 API 访问 -> API 密钥。
- 点击 生成 API 密钥(或复制现有的密钥)。
- 将其粘贴到
.env文件中,格式为BING_API_KEY=您的密钥。
执行步骤
1. 收集 Google Search Console (GSC) 数据
运行 GSC 分析脚本以获取点击量、展示次数、点击率和平均排名:
cd scripts && python3 analyze_gsc.py
2. 收集 Google Analytics 4 (GA4) 数据
运行 GA4 脚本以分析用户会话、流量来源和页面浏览量:
cd scripts && python3 ga4_both.py
3. 收集 Bing 站长工具数据
运行 Bing 脚本以比较 Bing 与 Google 的搜索表现:
export BING_API_KEY=$(grep BING_API_KEY ../../.env | cut -d '=' -f2)
cd scripts && python3 bing_webmaster.py
4. 综合洞察分析
分析合并后的输出结果并报告:
- 趋势分析:基于14天视图判断总体流量是增长还是下降。
- 平台比例:Bing 流量相对于 Google 流量的比例是多少。
- 关键词与页面机会:突出展示次数高但点击率低的关键词,或者在 Bing 上表现优异但 Google 上不佳的页面。
使用清晰的 Markdown 格式向用户提供最终总结。