Google Search Console
连接 Search Console，顺便完成站点验证，按真实搜索流量给问题排序，发现差一步上首页的机会，并在 Loomaly 里管理 sitemap。
Loomaly 不依赖 Search Console 也能扫描你的页面，连接与否由你决定。连上之后，Loomaly 能拿到真实的 Google 搜索数据，出在真正有流量的页面上的问题会排得更靠前，你还能在对话里用 google 或在 /account 管理 sitemap。这也是验证站点最快的办法，验证后会开启每周自动复查。
连接后能用什么
| 位置 | 内容 |
|---|---|
visibility（view: google） | 7 / 28 / 90 天的点击、展示、点击率和平均排名，以及变动最大的页面、差一步上首页的搜索和标题缺口 |
| 修复顺序 | todo 里的推荐顺序会参考受影响页面的搜索流量。没连 Search Console 时，流量按「未知」处理，而不是按 0 |
todo（view: opportunities） | Pro 和 Agency：最近 28 天的搜索机会（见下文） |
focus | 焦点页的点击、展示、点击率、排名和收录状态，以及改动日志里所有前后对比。页面没有你自己设的词时，展示次数最多的搜索词会成为它的目标搜索词 |
| 每周报告邮件 | 最近一周数据里网站获得的 Google 点击数，以及与前一周的对比 |
| 站点验证 | 如果你的 Google 账号是该资源的所有者或完整用户，连接即完成站点验证，并开启每周自动复查 |
google | 修好后向 Google 提交或刷新 sitemap |
标题缺口
标题缺口是人们已经用来找到某个页面的搜索：28 天内展示不少于 50 次，平均排名不差于 20，但标题和 H1 都没有提到。每个页面最多列三个。你自己设置目标搜索词也不会把它们藏起来。品牌词不会被选成目标搜索词；当它不是该页的目标词时，仍可能作为标题缺口出现。
同一份列表在 visibility（view: google）的 titleGaps 里。那里每一条「差一步上首页」的搜索也会标明是否在标题（inTitle）和 H1（inH1）里。
搜索机会
Pro 和 Agency 用 todo（view: opportunities）能看到最近 28 天 Search Console 数据里的页面。三类：
- 差一点上首页：平均排名 5–20，展示不少于 100 次。
- 点击率偏低：排名 1–20，展示不少于 50 次，点击率低于该排名常见水平的 60%。通常要改标题和描述。
- 点击下滑：点击比前 28 天少至少 30%，但展示仍不少于前一窗口的 70%。
每条会带上背后的搜索词、展示、点击和排名，以及建议改什么。可用 set_goals 把该页设成焦点页。同一页面、同一类机会 90 天内不会再提，除非数字明显更差。
本周计划在 Pro 和 Agency 上最多会占一到两条这类机会。排序权重：展示 × 向典型第 8 名点击率靠拢的提升，或展示 × 点击率低于常见水平的幅度，或相对前 28 天损失的点击。焦点页关键词问题优先，然后是这些，再是其余队列。Free 和 Starter 只看到有多少条以及升级到 Pro 的提示，看不到明细。
历史保留 90 天。已连接的站点按每天 14 天的切片补齐，已经存过的日期不会重写。
连接之前
请用已经拥有该站点已验证 Search Console 资源的 Google 账号连接：域名资源，或站点的 https URL 前缀资源。Loomaly 会用这个资源，并能提交 sitemap。如果账号还没有资源，连接时也会向 Google 申请站点验证；Loomaly 会返回首页 meta 标签（常以 handoff 形式），标签上线后再确认。
要从 Loomaly 提交 sitemap，以及让连接算作验证站点，你需要该资源的所有者或完整用户权限。只读（受限）权限足够拉取搜索数据。
连接
通过助手（推荐）
让 Loomaly 连接 Google Search Console。google（action: connect）在需要浏览器授权时会给出 handoff URL。也可以在 /account 的站点 Google 设置里开始。
在 Google 的页面上批准访问
Google 会请你允许 Loomaly 查看和管理 Search Console 数据，并看到你的邮箱。权限说明见权限。
核对 Loomaly 选中的资源
你不用自己挑资源。Loomaly 会列出该 Google 账号能访问的资源，只保留覆盖本站点的：域名资源（也覆盖子域名），或同一主机（带或不带 www）的 URL 前缀资源。如果没有匹配的，就不会连上。匹配里优先你是所有者或完整用户的，然后是：
- 域名资源（
sc-domain:example.com）， - 再是
https://URL 前缀资源， - 再是其他匹配资源。
如果选错了，在 /account 断开，再用有正确资源权限的 Google 账号重连。
连接后，Loomaly 会在后台导入最近 28 天的搜索数据，visibility 很快就会有数。之后每天拉一次新数据。页面和站点合计里包含 Google 匿名化的搜索，这些不会出现在查询列表里：小站点上它们可能占大部分流量。Search Console 数据通常落后 2–3 天，最近几天会在随后几天补齐。
连接属于站点，不属于个人。项目里所有人看到同一份数据，任何成员都可以连接或断开。
连接即验证站点
域名上的 Search Console 资源，且你是所有者或完整用户，效力等同于 DNS 记录。必须是域名资源，或站点根路径的 URL 前缀资源（不能是 /blog/ 这类子路径）。账号已有这样的资源时，连接即完成验证。每周复查和周报会自动打开，第一次复查在一周后，部署 Webhook 也会可用。若还不能验证，Loomaly 会申请站点验证权限（新的 Search Console 连接已包含），并返回要加的首页 meta 标签——通常通过 google（action: verify）和 handoff。只有受限（只读）权限，或只有子路径资源时，连接仍能拉搜索数据，但不会验证站点。详见验证站点。
权限
连接 Search Console 会向 Google 要两样东西。登录 Loomaly 本身只要邮箱、资料和 openid，不包含 Search Console。
- Search Console（
webmasters范围）：查看和管理你已验证站点的 Search Console 数据。Loomaly 要完整范围而不是只读，因为提交和删除 sitemap 需要写权限。 - 你的邮箱：只用来显示连的是哪个 Google 账号。
一次 Search Console 连接会请求 webmasters、email，以及 https://www.googleapis.com/auth/siteverification.verify_only。Google 的站点验证文档把该范围描述为验证新站点的能力，不能读取你已经验证过的站点。API 发现文档允许它用于 webResource.getToken 和 webResource.insert，也就是签发 meta 标签并确认的两次调用。列出或编辑已验证站点需要更宽的 siteverification 范围，Loomaly 不会请求。登录仍只要邮箱、资料和 openid。缺少验证权限的旧 Google 连接可以在 /account 用一次额外的 Google 提示升级。
以当前请求的权限，Loomaly 只会做这些调用：
- 读搜索分析（查询、页面、日期，以及点击、展示、点击率和排名），
- 连接时列出你的资源，选出匹配本站的那一个，
- 列出你的 sitemap，并在你通过
google要求或 sitemap 修复验证后提交或删除。
Loomaly 不会替你请求收录，也不使用 Google 的 Indexing API。Google 只允许该 API 用于职位发布和直播。Google token 加密存储。
请求重新抓取
修好页面后，你可以让 Google 更快再抓一次。在 Search Console 的网址检查里打开该页对应资源，自行点请求编入索引。Loomaly 自己的复查（check，target: fix）是另一回事，不依赖 Google 重新抓取。
Sitemap
让助手用 google 提交 sitemap，或在 /account 管理。你可以：
- 查看每个 sitemap 的状态（有效、待处理、警告或错误）以及上次提交和抓取时间，
- 提交新的（例如
/sitemap.xml或完整 URL）， - 从 Google 删除某一个。
Google 处理新 sitemap 可能要几小时到几天。
访问过期时重连
如果 Loomaly 读不到数据，visibility / google 会返回可恢复错误并指向重连。例如你在 Google 账号里撤掉了 Loomaly 的访问。通过 handoff URL 或 /account 重新授权即可。
断开连接
在 /account 断开该站点的 Google Search Console。Loomaly 会删除存储的 Google token、忘掉资源并停止每日导入。站点仍保持已验证，每周复查的设置不变。
在 Loomaly 里断开不会撤销 Google 侧的授权。要一并撤销，请到 myaccount.google.com/permissions 移除 Loomaly。
连接失败时
常见提示与处理：
| 提示 | 怎么办 |
|---|---|
| 你的 Google 账号没有该域名的 Search Console 资源 | 若提供站点验证就允许，加上首页 meta 标签后再检查；或连接已经拥有该资源的账号 |
| 你的 Google 账号没有 Search Console 访问权限 | 从 Loomaly 连接该 Google 账号。同意屏幕即可，不必先打开 Search Console |
| 你取消了 Google 授权 | 重新开始并批准访问 |
| 没有返回 refresh token | 在 myaccount.google.com/permissions 移除 Loomaly，再连一次 |
| Google API 限流 | 稍等再试 |
Search Console 与 MCP
通过 MCP 连接助手时，同意屏幕会列出 gsc:read 和 gsc:write，默认都勾选。
gsc:read—visibility（view: google）：7 / 28 / 90 天的点击和展示、变动、差一步上首页的搜索和标题缺口。没有它时，助手仍可通过focus看到焦点页数字。gsc:write—google（connect/verify/ 提交 sitemap）。验证优先用已有资源；否则返回handoffURL 和首页 meta 标签。
如果 token 缺某个范围，到 /account/agents 重连，并勾选两个 Search Console 选项。