用途:doctor 是 SEO Skills CLI 中的一项自检报告,用于在排查报告失败前先确认本地环境。它读取本地设置状态,把缺失凭据、缺少 Google 授权范围、缺少默认配置与真实 SEO 证据区分开。通过只说明本地前置条件看起来已具备,并不证明令牌仍被 Google 接受,也不证明账号能访问某个具体资源。
主要能力:返回 ok 状态与 checks 列表。每项包含 status(区分阻塞性 fail 与非阻塞 warn)、detail(观察到的内容)、fix(对应的本地修复建议)。generatedAt 表示检查文件系统与令牌元数据的时间。缺少已保存的 GSC 或 GA4 默认值通常只是警告,因为可在报告中显式传参替代。
使用方式:通过 MCP 时,先调用 seo_list_reports 并传 {"category":"setup"},再调用 seo_describe_report 传 {"id":"doctor"} 使用返回的 schema,最后调用 seo_run_report 传 {"id":"doctor","params":{}}。该报告不接受参数,不要自行添加 site、project 或 refresh 字段。CLI 暴露同一注册表与 schema:seo reports describe doctor --json 与 seo reports run doctor --params '{}' --json。以 MCP 的 structuredContent 或 CLI 的 JSON 作为机器契约,文本响应仅作简短展示。
限制与安全:不要将账号邮箱、令牌内容、OAuth 客户端值、私钥或本地凭据文件复制到回答中,只概括检查 id、状态与安全的修复方式。对失败的检查应用最小修复,例如重新登录或恢复存储令牌所用的同一 OAuth 客户端,然后重跑 doctor,再对目标资源运行一个小型只读报告。不要把自检通过当作排名、索引、分析准确性或站点健康的证据。