GA4网站分析工具包

技能简介

该工具包整合Google Analytics 4、Search Console和Indexing API，用于获取网站流量数据、页面表现、用户画像、实时访客信息、搜索关键词及SEO指标。

业务背景

GA4网站分析工具包帮助运营与营销团队一站式掌握网站健康度。无需切换多个后台，即可透视流量来源、用户画像及搜索表现，快速定位SEO优化机会。数据自动归档与报告生成，让日常监测从手工整理升级为自动化洞察，支撑敏捷决策。

落地案例：电商运营人员每周需向管理层汇报网站表现。通过该工具包，设定日期范围后自动拉取GA4流量数据与Search Console热门搜索词，对比上周期变化趋势；同时检查新品页面索引状态，对未收录URL批量提交重新抓取请求。最终生成Markdown汇总报告，直接用于周会演示。

能做什么

• 查看指定时间段内的网站整体流量概况
• 分析流量来源渠道与用户构成
• 获取实时在线访客数量与当前浏览页面
• 查询Search Console中的热门搜索词与点击数据
• 对比两个时间段的指标变化
• 批量提交URL重新索引请求并检查收录状态

使用说明

安装依赖

cd scripts && npm install

配置凭证

在项目根目录创建.env文件：

GA4_PROPERTY_ID=123456789
GA4_CLIENT_EMAIL=service-account@project.iam.gserviceaccount.com
GA4_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
SEARCH_CONSOLE_SITE_URL=https://your-domain.com
GA4_DEFAULT_DATE_RANGE=30d

前置条件：Google Cloud项目需启用Analytics Data API、Search Console API和Indexing API；服务账号需具备GA4资产和Search Console的访问权限。

运行方式

导入函数调用：

import { siteOverview, searchConsoleOverview } from './scripts/src/index.js';
const overview = await siteOverview('30d');

或直接执行：

npx tsx scripts/src/index.ts

工作流程：执行API函数 → 结果自动保存为带时间戳的JSON文件至results/{category}/ → 生成markdown汇总报告至results/summaries/。

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管服务账号私钥，避免泄露导致数据安全风险
• API调用存在配额限制，高频请求可能触发限流
• 日期范围格式错误将导致查询失败
• 索引API仅支持已验证所有权的网站URL

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/adamkristopher/ga4-analytics/SKILL.md
来源类型：GitHub仓库