Community写作与编辑github.com

SeoToolkit/网站分析代理技能

一款强大的代理技能和Python自动化工具,利用GSC、GA4和Bing站长API实现SEO自动化、流量诊断和跨平台关键词研究。

网站分析代理技能 是什么?

该技能(SEO Toolkit Web Analytics Agent Skill)是一个AI代理驱动的SEO分析与自动化工具包。它允许代理通过Google Search Console (GSC)、Google Analytics 4 (GA4) 和 Bing Webmaster Tools 的API拉取并分析流量数据,从而提供深入的SEO洞察。用户需要配置OAuth客户端密钥和Bing API密钥作为凭据。该工具支持多平台数据对比,通过运行位于 `scripts/` 目录下的Python脚本 (`analyze_gsc.py`, `ga4_both.py`, `bing_webmaster.py`) 执行分析,最终代理会综合输出结果并生成一份包含流量趋势、平台流量占比以及关键词与页面优化机会的Markdown总结报告。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add SeoToolkit/web-analytics-agent-skill

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

网站分析技能

该技能允许代理从 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。 用户指引:

  1. 前往 Google Cloud 控制台。
  2. 创建一个新项目或选择一个已有项目。
  3. 导航至 API 和服务 > 库,启用 Google Search Console API 和 Google Analytics Data API。
  4. 导航至 API 和服务 > OAuth 同意屏幕 并进行配置(可以将用户类型设置为“外部”,并将您自己的电子邮件添加为测试用户)。
  5. 导航至 API 和服务 > 凭据。点击 创建凭据 > OAuth 客户端 ID。
  6. 选择 桌面应用 作为应用程序类型。
  7. 点击创建,然后下载 JSON 文件。将其重命名为 client_secret.json,并放置在此技能的 scripts/ 目录中。

2. Google OAuth 令牌 (token.json, google_analytics_token.json)

这些令牌由脚本自动生成。

  • 代理说明: 如果脚本输出提示 正在打开浏览器进行授权,请告知用户检查其电脑上是否弹出了新的浏览器窗口,并完成 Google OAuth 登录。登录成功后,脚本会自动将令牌本地保存。

3. Bing API 密钥

用户指引:

  1. 前往 Bing 站长工具。
  2. 选择您已验证的网站。
  3. 点击右上角的 设置 齿轮图标。
  4. 进入 API 访问 -> API 密钥。
  5. 点击 生成 API 密钥(或复制现有的密钥)。
  6. 将其粘贴到 .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. 综合洞察分析

分析合并后的输出结果并报告:

  1. 趋势分析:基于14天视图判断总体流量是增长还是下降。
  2. 平台比例:Bing 流量相对于 Google 流量的比例是多少。
  3. 关键词与页面机会:突出展示次数高但点击率低的关键词,或者在 Bing 上表现优异但 Google 上不佳的页面。

使用清晰的 Markdown 格式向用户提供最终总结。

相关技能