用途:通过统一的 TypeScript 函数调用 Google Analytics 4、Search Console 与 Indexing API,分析网站流量、页面表现、用户画像、实时访客与搜索查询,并请求 URL 重新收录。
主要能力:GA4 侧提供 siteOverview、trafficAnalysis、contentPerformance、userBehavior、compareDateRanges、liveSnapshot 等高层函数;Search Console 侧提供 searchConsoleOverview、keywordAnalysis、seoPagePerformance;Indexing 提供 reindexUrls、checkIndexStatus;另有 getAvailableFields 及 30+ 底层 API 函数。所有函数接受灵活日期格式(如 "7d"、显式日期、GA4 相对格式),默认 30d。
使用方式:先在 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,并使用有权限的服务账号。可从 scripts/src/index.ts 导入函数,或用 npx tsx scripts/src/index.ts 运行。结果自动以时间戳 JSON 保存到 results 下对应目录,随后可生成 Markdown 摘要。
限制:依赖上述 Google API 与有效凭据,资料未提供费用、平台兼容性等细节。