Visibly AI — SEO MCP Server

Claude Code — SEO 代理机构与自由职业者入门模板

一套功能齐备的 Claude Code 蓝图，专为 SEO 自由职业者和代理机构打造。接入 Visibly AI MCP，使用覆盖完整客户工作流的现成斜杠命令——现状分析 → 潜力分析 → 服务方案 → 符合 CI 规范的 PDF——还有一个智能钩子，引导 Claude 使用真实 SEO 数据，而不是凭空猜测。

由 Antonio Blago 打造并经过实战验证——SEO 自由职业者及 Neuro-SEO System® 的创作者。

快速入门 • 包含内容 • 工作流 • CTR 模型 • 自定义 • 获取免费密钥 • 预约通话

---

为什么要做这个项目

SEO 咨询反复围绕同样的五项工作：获取真实排名数据，将其与客户的关键词集对应起来，量化机会，将其转化为服务方案，然后交付一份体面的 PDF。只要提供数据源、方法论和防护措施，Claude Code 就能完成所有这些工作。

这个仓库正是为此而打包——而且无需任何 API 密钥即可运行。安装后，内置的 .mcp.json 会免密连接到 Visibly AI MCP，为你提供免费的知识工具（关键词分类、SEO 检查清单、Google 指南、URL 结构分析）以及完整的本地方法论；导入你自己的 Search Console 数据，整个现状分析 → 潜力分析 → 服务方案 → PDF 流程就能离线运行。需要随时调用数据引擎时，再添加 Visibly AI 密钥——通过一个 MCP，即可使用实时 GSC/GA（0 积分）、关键词、反向链接、竞争对手数据和页面 SEO 审核。默认免费，需要时升级专业版。

✨ 包含内容

部分	功能
.mcp.json	预先配置好的 Visibly AI MCP 连接——默认免密（免费知识工具）；添加密钥即可解锁实时 GSC、关键词、反向链接、竞争对手数据、页面 SEO 审核和爬取功能。
/visibly-seo-status-quo	梳理客户的实时自然搜索可见度：GSC × 目标关键词、分类、快速见效机会。
/visibly-seo-potential	潜力分析：经验 CTR 模型 → 切实可行的 12 个月目标 → 流量、潜在客户与 ROI 计算。
/visibly-seo-offer	根据你的分析和客户背景，起草量身定制、分阶段实施的 SEO 咨询服务方案。
/visibly-seo-pdf-build	将任意分析脚本转换为整洁、符合品牌规范的 PDF。
SEO 钩子	一个 UserPromptSubmit 钩子，可检测 SEO 意图，并引导 Claude 使用 Visibly AI MCP 工具，而不是通用抓取工具。
CLAUDE.md	项目指令模板，涵盖完整工作流和文件夹规范。
docs/	完整的方法论文档：工作流、CTR 模型和最佳实践。

🚀 快速入门

有两种使用方式——任选一种。

选项 A — 安装为插件（最快）

/plugin marketplace add AntonioBlago/claude-code-seo-starter
/plugin install seo-starter@antonioblago

你将获得 /visibly-seo-status-quo、/visibly-seo-potential、/visibly-seo-offer、/visibly-seo-pdf-build 命令、自动调用的 SEO 技能、SEO 意图钩子，以及已接入的免密 Visibly AI MCP。 无需密钥即可开始——批准 MCP 服务后，即可使用免费的知识工具和完整的本地工作流。

想使用完整的数据引擎（实时 GSC、关键词、反向链接、页面 SEO）？ 添加 Visibly AI 密钥——前往 visibly-ai.com 获取（约 30 秒，无需银行卡），然后连接一次即可（在写入时解析，不会进入 git）：

claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp --header "Authorization: Bearer lc_xxxxxxxxxxxxxxxx"

如有需要，使用 /reload-plugins 重启。关于专业版、Google-OAuth（0 积分）和可选的 DataForSEO 接入，请参阅 docs/setup.md。

选项 B — 克隆模板

使用完整仓库（文档、PDF 模板、安装脚本）作为项目脚手架。

1. 前置条件

• 安装了原生安装程序版 Claude Code：curl -fsSL https://claude.ai/install.sh | bash（macOS、Linux、WSL）或 irm https://claude.ai/install.ps1 | iex（Windows PowerShell）。刚开始使用 Claude Code？从 claude-homebase 开始：/homebase 会设置全局 CLAUDE.md 和项目结构，然后选择 SEO 路径即可来到这里。
• （可选） pro 层级需要 Visibly AI 账户——免费注册。非必需：入门配置无需密钥即可运行。
• Python 3.11+（仅 PDF / 数据处理辅助工具需要）

2. 获取蓝图

# Use it as a GitHub template, or just clone:
git clone https://github.com/AntonioBlago/claude-code-seo-starter.git
cd claude-code-seo-starter

3. （可选）添加 Visibly AI 密钥

免费层级可跳过此步骤——无需密钥的 .mcp.json 已可正常使用。要启用 完整数据引擎，请在 visibly-ai.com 免费创建账户， 复制你的 lc_... 密钥，然后连接一次（写入时解析，不会进入 git）：

claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp --header "Authorization: Bearer lc_xxxxxxxxxxxxxxxx"

完整层级说明、Google-OAuth（实时 GSC/GA，0 积分）和可选的 DataForSEO 接入方式：docs/setup.md。

4. 启动

claude

首次运行时，Claude Code 会要求你批准 Visibly AI MCP 服务。批准后，尝试：

/visibly-seo-status-quo example.com

就是这样。免费层级下，将 GSC 导出数据提供给 Python 模板；使用密钥时， 则会实时获取数据。无论哪种方式，你都可以运行完整的 SEO 工作流。

🔁 工作流

每个斜杠命令都对应实际客户合作中的一个阶段。它们会依次衔接：

/visibly-seo-status-quo <domain>   →   /visibly-seo-potential <domain>   →   /visibly-seo-offer <domain>   →   /visibly-seo-pdf-build <script.py>
   (where do we           (what's the upside,        (what should the          (hand the client a
    rank today?)           in clicks & €?)            client buy?)              polished PDF)

完整方法说明见 docs/workflows.md。

📈 CTR 模型

潜力分析的质量取决于其点击率曲线。本仓库提供 Keyword Study 2026——基于Google Search Console 第一方数据（130 万个关键词、94 个域名）得出的各排名 CTR，而非大多数模板仍在使用的虚高教科书数据。

其差异化之处在于：这条曲线会考虑搜索意图。排名第 1 的导航型关键词 CTR 约为 8.9%；信息型关键词约为 3.2%。用一个混合数值进行预测，会悄然夸大预期收益。各意图及排名的完整表格，以及应用它的 Python 代码，请参阅 docs/ctr-model.md。输入真实可靠 → 预测经得起推敲 → 方案经得住审视。

🔍 透明度——数据在哪里处理

数据流向一目了然：

• 无需密钥（默认）：.mcp.json 无需账户即可连接到 mcp.visibly-ai.com。只有免费的知识工具会响应（检查清单、指导、Google 指南、关键词分类、URL 结构检查）——不涉及客户数据。
• 使用密钥：数据工具（query_search_console、query_analytics、关键词、反向链接、页面内分析）会经由托管在欧盟 Railway 上的 Visibly AI 后端进行路由。你的 GSC/GA 数据会经过该后端传给 Claude——这是产品本身的工作方式，并非附带影响。在单条 GSC 数据流动之前，你必须明确选择加入三次：创建 Visibly 账户、添加 API 密钥，以及在 Visibly 中通过 OAuth 连接 Google 账户。未授权 Google 访问时，query_search_console 没有可读取的网站资源。如果这不符合客户要求，不要添加密钥：改用本地 Python 模板处理 GSC 导出数据——完整工作流仍可运行。
• 权限：.claude/settings.json 仅自动允许读取元数据和使用免费的知识工具。所有读取客户数据的工具（GSC、GA、关键词、反向链接、页面内分析、爬取）均设为 ask——Claude 会在使用前征求许可。
• 钩子（.claude/hooks/seo-check.sh）在本地运行，不会向任何地方发送数据；当你的提示词看起来与 SEO 相关时，它只会提醒你使用真实数据，而不是凭空猜测。不想收到提醒？删除这个钩子即可。

🎨 自定义

所有内容都是纯 Markdown 和 shell — 可直接 fork 并调整：

• 品牌 — 编辑 CLAUDE.md 和 templates/pdf_example.py，换成你的颜色、字体和联系信息。
• 数据源 — 默认无需密钥；添加 Visibly 密钥即可使用完整引擎，或在 .mcp.json 中接入你自己的数据源（GSC 导出 → Python 模板、DataForSEO、GA4、Ahrefs 等）。请参阅 docs/setup.md。从零开始构建自己的 GSC 访问权限的免费教程：Indexing Checker für die Google Search Console（德语）。
• 工作流 — .claude/commands/*.md 文件就是工作流。用你自己的语言改写。
• 防护措施 — 在 .claude/hooks/seo-check.sh 中添加你自己的关键词触发条件。

更详细的指南请参阅 docs/setup.md，已总结实践经验的内容请参阅 docs/best-practices.md。

📂 仓库结构

claude-code-seo-starter/
├── .claude-plugin/           # makes this repo an installable plugin + marketplace
│   ├── plugin.json           # plugin manifest
│   └── marketplace.json      # marketplace catalog (one repo = both)
├── .mcp.json                 # Visibly AI MCP connection — keyless (free tools); add key for pro
├── server.json               # MCP-registry manifest (publish via mcp-publisher)
├── .env.example              # copy → .env — optional key + separate data sources
├── CLAUDE.md                 # project instructions Claude reads on every run
├── .claude/
│   ├── commands/             # /visibly-seo-status-quo /visibly-seo-potential /visibly-seo-offer /visibly-seo-pdf-build
│   ├── skills/               # auto-invoked SEO skills (status-quo, potential, offer, pdf)
│   ├── hooks/                # seo-check.sh + hooks.json — SEO-intent nudge
│   └── settings.json         # hook registration + permissions (free tools allowed, data tools ask)
├── docs/
│   ├── setup.md              # detailed setup
│   ├── workflows.md          # the 4-phase methodology
│   ├── ctr-model.md          # empirical CTR curve
│   ├── folder-structure.md   # client knowledge base + CI base conventions
│   ├── best-practices.md     # lessons learned
│   └── promote.md            # discoverability checklist (registry, awesome lists)
├── templates/
│   ├── ci/                       # CI base — brand.py (constants) + CI.md (reference)
│   ├── client-template/          # copy → clients/<domain>/ (CLAUDE.md + _knowledge/)
│   ├── status-quo-template.md    # fill-in status-quo skeleton (classification, quick wins)
│   ├── potential-template.md     # fill-in potential skeleton (deltas, clusters, ROI scenarios)
│   ├── offer-template.md         # fill-in offer skeleton (phases, pricing, ROI, terms, CTA)
│   └── pdf_example.py            # minimal CI-PDF starter (fpdf2)
└── scripts/
    └── check-setup.sh        # verify your env is wired correctly

相关仓库

仓库	提供的内容
claude-homebase	从头开始设置 Claude Code：/homebase 会询问你的角色，并生成 CLAUDE.md、文件夹、技能和经验总结
claude-context-guard	当上下文成本变高时发出警告，并在 /clear 后保留交接简报
delegate-audit	根据 DELEGATE-52 卫生规范检查 Claude Code 技能和 LLM 流水线
visiblyai-mcp-server	本项目入门模板背后的 Visibly AI MCP 服务
peec-ai-skills	用于提升品牌在 ChatGPT、Perplexity 和 Google AI Overviews 中曝光度的技能

了解更多方法：面向开发者的最佳 Claude Code 技能。

🤝 贡献

欢迎提交 PR — 请参阅 CONTRIBUTING.md。觉得这个项目有用？点个 ⭐，帮助更多人发现它。

📜 许可证

MIT — 请参阅 LICENSE。可用于商业用途，也可以 fork 后为自己的客户提供服务。

💬 需要帮助进行设置吗？

如果你希望将其调整为适合你代理机构的工作流，或者想聊聊 SEO、Claude Code 或氛围编程，预约咨询。

---

由 Antonio Blago 创建 — SEO 自由职业者与 Neuro-SEO System®
📅 预约咨询
_{如果这能让你为每位客户节省一个下午的时间，那它就发挥了作用。}