接入 AI 助手（MCP）
把 Claude、Claude Code、Cursor、Codex 或 ChatGPT 接到 Loomaly。十二个意图工具覆盖排名、AI 搜索、修复和报告——都在对话里完成。
Loomaly 的 MCP 服务在 https://loomaly.com/mcp（插件 2.2.0，MCP 2.0）。助手连上一次之后，日常工作都在对话里完成。Loomaly 不会改你的网站：助手改代码（或起草给开发的任务），你审阅，Loomaly 再复查线上页面。
你：这周 example.com 最该先修什么？
→ status · todo
say：/products/* 缺 meta description（1,200 个页面）。置顶项已带 fixPrompt。
next：在仓库里改（或 send_to_dev），开 PR，再用 check target fix，附上 PR 链接
你：PR https://github.com/acme/site/pull/42 — 复查。
→ check（target: fix，ref: PR 链接）
say：等待上线——Loomaly 会自行复查。下次 status 会宣布结果。账号设置、账单、Google 连接和已连接的助手都在 /account。日常 SEO 不靠网页后台。
每次回复长什么样
每个工具结果都是同一套信封：
| 字段 | 含义 |
|---|---|
say | 给你看的白话说明。助手应转述，不要编造数字。 |
next | 下一步该调的工具（名称 + 参数）；结束时为 null。 |
errors | 可恢复错误：{ error, say, recover }。按 recover 做。 |
handoff | 只有人能在浏览器里完成的步骤：{ url, say, resume }，指向 /account/...。 |
有的结果还带文本 chart（Markdown 表和/或火花图）。付费排名和 AI 提及只有在套餐有数据预算、并且已经拉取过时才出现——不要编造。
接入助手
claude mcp add --transport http loomaly https://loomaly.com/mcp加 --scope user 可在所有项目里用。启动 Claude Code，运行 /mcp，选 loomaly，在浏览器里登录。
访客演示（免登录）
无法完成 OAuth 的沙箱可用只读演示端点 https://loomaly.com/mcp/demo（无需登录）。仅开放 status 与 check，走与 /check/<host> 相同的免费站点预览（优先问题、基础项、内链建议）。按 IP / 域名限流，拒绝私网地址。完整账号工具仍在 https://loomaly.com/mcp（OAuth）。
{
"mcpServers": {
"loomaly-demo": {
"url": "https://loomaly.com/mcp/demo"
}
}
}登录与权限
- 浏览器打开。用拥有站点的账号登录（或注册免费账号）。
- 核对授权页上的 You will be sent to——本地工具一般是
localhost。 - 选择权限。读问题始终开启；添加站点、扫描、修复后复查，以及 Search Console 读写默认勾选。
| 权限 | 允许的工具 |
|---|---|
findings:read | status、todo、problem、focus、visibility、report |
findings:write | triage、set_goals、send_to_dev |
audit:run | add_site、check（含付费目标） |
gsc:read | visibility（view: google） |
gsc:write | google（连接 / 验证 / 提交 sitemap） |
在 /account/agents 管理连接。断开后，助手下一次调用即失效。
十二个工具
| 工具 | 作用 |
|---|---|
status | 套餐、用量、角色、站点与扫描阶段。可选 domain 在空账号时加站。可选 setRole（solo | ops | product | dev）。 |
add_site | 添加域名并开始首次扫描。用 status 轮询直到 scan.phase 为 done 或 failed。 |
todo | 本周计划和其余队列。置顶待办已带 fixPrompt、证据、url、verify。view：plan（默认）、queue、links、opportunities。 |
problem | 可选详情：一条问题的证据与修复说明（findingId），或按规则列出页面。 |
triage | 动作：ignore、restore、decide_link。确认修复用 check（target: fix），不用 triage。 |
send_to_dev | 给开发粘贴的任务正文。 |
check | 复查修复（target: fix + PR ref）、整站扫描、预览 URL，或付费的 rankings / ai / competitors / backlinks。不传 maxCost 只估价；传入则花预算。 |
visibility | 只读 Search Console（view: google）或已存的付费数据。不花预算。 |
focus | 本周焦点页：简介、搜索数字、待修问题、改动结论。 |
set_goals | 简介、焦点页、conversionValue、追踪列表、memberRole，或记录一次上线改动。 |
google | connect、verify，或提交 sitemap。可能返回浏览器 handoff。 |
report | weekly、compare、public（分享链接 /r/<token>）、pdf、roi。 |
ID 来自前一步结果。还没有站点时，status / todo 会返回 needsSite 并指向 add_site。
triage 的动作
ignore— 需要原因。restore— 重新打开已忽略的问题。decide_link— 对todo（view: links）里的内链建议设为accepted或dismissed。
典型修复循环
接入并加站
调用 status。若 needsSite，用域名调用 add_site。轮询 status 直到扫描结束。
本周工作
todo——置顶待办已带 fixPrompt、证据、url、verify。只有需要更多细节时才调 problem。solo / dev：在仓库里改。ops / product：send_to_dev 再粘贴任务。
开 PR 并复查
开 PR。立刻 check（target: fix，ref = PR 链接）。Loomaly 会稍等；页面未变则进入等待上线并自行复查。下次 status 会宣布结果。
付费数据：set_goals 存 trackKeywords / competitors / aiPrompts → visibility 读已存数据 → check 不带 maxCost 估价 → 带 maxCost 花当月预算。免费版预算为 $0。详见套餐与角色。
可以这样说
用 Loomaly 检查 example.com。在这个仓库里修最重要的问题，开 PR，再用 check target fix，ref 填 PR 链接。排查
- 连不上。 客户端须支持远程 Streamable HTTP + OAuth（不能只支持 SSE）。
- 缺少权限。 到
/account/agents重新连接并勾选对应权限。 - 没有这个站点。 ID 错了，或你不是成员——再调一次
status。 check显示等待上线。 线上页面还没变；Loomaly 会自行复查。稍后再调status看宣布。