SuperAPI AI 工具集

ai-referrals

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:该报告用于查看哪些已知 AI 引荐域名作为 GA4 会话来源出现、这些会话落在哪些落地页,以及活动按天的变化。它适合做已观测到的引荐分析,不适合衡量每一次提及或引用。引荐来源可能被剥离、重新归类,或被记为直接/未分配流量,因此空结果不能证明没有 AI 系统发送或引用该站点。

主要能力:输出会话来源、落地页和按天活动;提供 dataStatus、range、methodology、dataSource.partialReasons、possiblyTruncated、查询级状态、警告、返回行数等元信息,便于判断数据完整性。summary.sessions 与 summary.eventCount 可累加;summary.totalUsers 可能不可用,不得用各来源或各页面数值相加重建。sources[].observedSessionSources 保留精确归因证据,shareOfAiSessions 仅在检测到的 AI 会话内使用,landingPages 可用于挑选页面做定性审查。

使用方式:MCP 流程为调用 seo_list_reports 并传 {"category":"ai-search"},再调用 seo_describe_report 传 {"id":"ai-referrals"} 查看当前 schema,最后调用 seo_run_report 传 {"id":"ai-referrals","params":{"property":"123456789","startDate":"28daysAgo","endDate":"yesterday","limit":25}}。CLI 使用同一注册表与处理器:seo reports describe ai-referrals --json 和 seo reports run ai-referrals --params '{"property":"123456789","startDate":"28daysAgo","endDate":"yesterday","limit":25}' --json。property 必填;日期接受 YYYY-MM-DD 或 GA4 相对日期如 28daysAgo;maxRows 限制保留的提供方行数,limit 是其旧别名,不要同时传两者。

适用场景与限制:可检查高流量落地页是否回应引荐上下文、比较完整且同口径的时段、标注重大变化。不要声称引荐会话导致了转化,不要将其代表全部 AI 流量,也不要声称能揭示产生访问的提示词、回答、引用或用户意图。比较总量前需检查 GA4 时区。