用途:该工具包用于通过 Google Analytics 4、Search Console 和 Indexing API 分析网站数据,覆盖流量、页面表现、用户画像、实时访客、搜索查询与索引状态。
主要能力:GA4 侧提供 siteOverview、trafficAnalysis、contentPerformance、userBehavior、compareDateRanges、liveSnapshot 等函数,分别获取站点概览、流量来源、热门页面、互动行为、时段对比与实时数据;Search Console 侧提供 searchConsoleOverview、keywordAnalysis、seoPagePerformance;索引侧提供 reindexUrls 与 checkIndexStatus;另有 getAvailableFields 列出可用维度与指标。所有结果自动保存为带时间戳的 JSON 到 results/{category}/,可再生成 markdown 摘要。
使用方式:先安装依赖 cd scripts && npm install,并在项目根目录创建 .env,配置 GA4_PROPERTY_ID、GA4_CLIENT_EMAIL、GA4_PRIVATE_KEY、SEARCH_CONSOLE_SITE_URL、GA4_DEFAULT_DATE_RANGE。前置条件为 Google Cloud 项目启用 Analytics Data API、Search Console API 与 Indexing API,且服务账号拥有对应 GA4 媒体资源和 Search Console 的访问权限。可从 scripts/src/index.ts 导入函数调用,或用 npx tsx scripts/src/index.ts 直接运行。日期范围支持 "7d"、"30d" 等简写、显式日期对象或 GA4 相对格式,默认 30d。
适用场景:网站流量与 SEO 分析、内容表现评估、关键词与设备/国家细分、实时监控、周期对比、批量重新索引。
限制:需自行准备 Google Cloud 凭据与服务账号权限;具体收费、价格、平台支持范围及效果资料暂未提供。