用途:该技能让 AI 智能体整合 Google Search Console(GSC)、Google Analytics 4(GA4)与 Bing Webmaster Tools 三类 API,进行 SEO 自动化与流量分析,面向跨平台搜索表现监测与诊断。
主要能力:从 GSC 获取索引状态、关键词排名、点击与展示;从 GA4 获取会话、跳出率与流量来源;从 Bing Webmaster Tools 拉取搜索统计以做跨引擎对比;汇总三平台数据生成结构化文本报告。支持 Google 服务的 OAuth 2.0 与 Bing 的 API key 认证。
使用方式:克隆仓库并建立 Python 虚拟环境后安装依赖:python3 -m venv .venv;source .venv/bin/activate;pip install -r requirements.txt。随后配置认证:Bing 在 Webmaster Tools 的 Settings → API Access → API Key 获取密钥;Google 在 Cloud Console 建项目并启用 GSC API 与 Analytics Data API,配置 OAuth 同意屏幕(外部类型、加入测试用户、添加 webmasters.readonly 与 analytics.readonly 作用域),创建桌面应用 OAuth 客户端并下载 JSON,重命名为 client_secret.json 置于项目根目录。再创建 .env 配置 BING_API_KEY、BING_SITE_URL、GSC_SITE_URL、SITE_LAUNCH_DATE、GA4_PROPERTIES。可运行 ./run_all.sh 顺序执行全部脚本,或单独运行 python3 scripts/auth_google.py、analyze_gsc.py、ga4_both.py、bing_webmaster.py。
适用场景:关键词跨引擎对比、流量来源归因、每周自动化报告(fetch_gsc_summary、fetch_ga4_summary、fetch_bing_summary 等模式),以及为 SEO 诊断提供多平台数据汇总。
限制与注意事项:GSC_SITE_URL 对域属性用 sc-domain:example.com,对 URL 前缀属性用 https://example.com/ 并保留末尾斜杠;GA4_PROPERTIES 格式为 PropertyID=Label,Property ID 在 GA4 后台属性设置中查看;OAuth 使用的 Google 账号需对 GSC 与 GA4 均有读取权限。403 权限错误需检查角色与作用域并重新授权;token 过期出现 invalid_grant 时删除 token.json 后重跑授权。Bing API 约每日 10,000 次调用上限,超限返回 429,可采指数退避。需 Python 3.7+。其他平台支持、收费与价格资料暂未提供。