用途:在爬虫已识别出某项技术模式后,把规则计数转化为可执行的 URL 清单。规则计数只适合分诊,实施修复需要确切 URL、观测证据和稳定的源爬虫快照。
主要能力:每行结果把 URL 与规则、类别、严重度和爬虫证据关联;可选的 clicks、impressions、sessions 用于排序工作优先级。结果按严重度、关联需求信号和 URL 确定性排序。selection 对象报告 totalMatchedRows、returnedRows、limit 和 truncated,URL 数组向下游传递时应保留该对象。
使用方式:MCP 下仅在需要发现时调用 seo_list_reports 且 category 为 crawl,然后调用 seo_describe_report 传入 {"id":"affected-urls"},最后调用 seo_run_report,参数示例为 {"id":"affected-urls","params":{"reportId":"crawl_example_20260710","ruleId":"missing_title","severity":"high","limit":50}}。读取 MCP structuredContent 作为契约,使用前检查 isError;文本结果只是简要说明,不是数据源。CLI 提供同一报告:seo reports describe affected-urls --json 与 seo reports run affected-urls --params '{"reportId":"crawl_example_20260710","ruleId":"missing_title","severity":"high","limit":50}' --json。
限制与注意:优先使用 reportId,使后续操作引用同一快照;仅在有意发起新爬虫时才传 url。先检查 dataSources,不可用的提供方数据不能当作真实的零。调用完成前需核对请求的过滤器、selection 元数据、原始爬虫上限、警告和注意事项;truncated: true 表示还有更多匹配问题行未返回。有上限或不完整的爬虫只能支持“已评估页面中的受影响情况”。修复应基于观测证据,抽样多个 URL 模板,并用 explain-issue 获取规则指引。部署后重新运行同一有界爬虫以验证规则不再触发;从不同范围的爬虫中消失不算验证。