Visibly AI — SEO MCP Server

io.github.AntonioBlago由 GitHub 帳號 AntonioBlago 發布v0.1.0更新於 Oct 26, 2026

Remote SEO/GEO MCP: Search Console, keyword research, backlinks, competitor & on-page audits.

已驗證Streamable HTTP可網頁執行效率與工作流網頁搜尋與抓取資料與分析

概覽

AI 產生的概覽

遠端 SEO/GEO MCP 伺服器,讓助理進行關鍵字分類、取得 SEO 檢查清單與指南、分析網址結構,並可在設定金鑰後查詢 Search Console 與反向連結資料。

可以做什麼
  • 依意圖、漏斗階段、品牌類型與主題分類關鍵字
  • 依網站類型取得 SEO 檢查清單,依主題取得最佳實務指南及 Google 官方搜尋指南
  • 分析網址的 SEO 友善度,並列出可用於 SEO 資料查詢的國家/地區
  • 從伺服器目錄取得逐步 SEO 工作流程技能
  • 設定 API 金鑰後可查詢 Search Console 與分析資料、關鍵字研究、反向連結、競爭對手及頁面稽核
適用情境
適合 SEO 自由工作者、代理商與網站經營者,希望助理依據真實排名資料與成熟 SEO 方法論工作,而非憑空猜測,涵蓋從關鍵字規劃到客戶稽核與報告的流程。
執行需求
遠端 streamable HTTP 端點 mcp.visibly-ai.com,不需本機執行環境。免費知識類工具無需帳號即可使用。資料類工具需要 Visibly AI API 金鑰,透過 Authorization bearer 標頭傳送;即時 Search Console/分析資料還需在 Visibly 內以 OAuth 連結 Google 帳號。
安裝前請注意
Authorization bearer 金鑰屬於機密,不應提交到程式碼儲存庫。設定金鑰後,Search Console 與分析資料會經由託管於歐盟的 Visibly AI 後端傳輸,客戶資料會離開本機。資料類工具可能消耗額度,README 說明在 GSC 資料可讀取前需三次明確授權。未設定金鑰時僅免費知識類工具可用。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Visibly AI — SEO MCP Server,將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.AntonioBlago%2Fvisibly-ai/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "visibly-ai-seo": {
      "type": "http",
      "url": "https://mcp.visibly-ai.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Claude Code — SEO Agency & Freelancer Starter

A batteries-included Claude Code blueprint for SEO freelancers and agencies. Wire up the Visibly AI MCP, get ready-made slash commands for the full client workflow — Status-Quo → Potential Analysis → Offer → CI-compliant PDF — and a smart hook that nudges Claude toward real SEO data instead of guessing.

Built and battle-tested by Antonio Blago — SEO Freelancer & creator of the Neuro-SEO System®.

Quickstart • What's inside • Workflows • CTR Model • Customise • Get a free key • Book a call


Why this exists

SEO consulting is the same five jobs over and over: pull the real ranking data, map it against the client's keyword set, quantify the opportunity, turn that into an offer, and ship a presentable PDF. Claude Code can do all of it — if you give it the data sources, the methodology, and the guardrails.

This repo packages exactly that — and it runs without any API key. Install it and the bundled .mcp.json connects to the Visibly AI MCP keyless, giving you the free knowledge tools (keyword classification, SEO checklists, Google guidelines, URL-structure analysis) plus the full local methodology; bring your own Search Console export and the entire Status-Quo → Potential → Offer → PDF chain runs offline. Add a Visibly AI key when you want the data engine on tap — live GSC/GA at 0 credits, keywords, backlinks, competitors and on-page audits through one MCP. Free by default, pro when you need it.

✨ What's inside

PieceWhat it does
.mcp.jsonPre-wired Visibly AI MCP connection — keyless by default (free knowledge tools); add a key to unlock live GSC, keywords, backlinks, competitors, on-page audits, crawling.
/visibly-seo-status-quoMaps a client's live organic visibility: GSC × target keywords, classification, quick wins.
/visibly-seo-potentialPotential analysis: empirical CTR model → realistic 12-month targets → traffic, lead & ROI math.
/visibly-seo-offerDrafts a tailored, phased SEO consulting offer from your analysis + client context.
/visibly-seo-pdf-buildTurns any analysis script into a clean, brand-compliant PDF.
SEO hookA UserPromptSubmit hook that detects SEO intent and steers Claude to Visibly AI MCP tools instead of generic scraping.
CLAUDE.mdA project-instruction template encoding the whole workflow + folder conventions.
docs/The methodology written out: workflows, the CTR model, and best practices.

🚀 Quickstart

There are two ways to use this — pick one.

Option A — Install as a plugin (fastest)

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

You get the /visibly-seo-status-quo, /visibly-seo-potential, /visibly-seo-offer, /visibly-seo-pdf-build commands, the auto-invoked SEO skills, the SEO-intent hook, and the keyless Visibly AI MCP — wired in. No key needed to start — approve the MCP server and you have the free knowledge tools plus the full local workflow.

Want the full data engine (live GSC, keywords, backlinks, on-page)? Add a Visibly AI key — grab one at visibly-ai.com (~30s, no card), then connect it once (resolves at write time, stays out of git):

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

Restart with /reload-plugins if needed. See docs/setup.md for the pro tier, Google-OAuth (0 credits) and optional DataForSEO wiring.

Option B — Clone the template

Use the full repo (docs, PDF template, setup script) as a project scaffold.

1. Prerequisites

  • Claude Code installed with the native installer: curl -fsSL https://claude.ai/install.sh | bash (macOS, Linux, WSL) or irm https://claude.ai/install.ps1 | iex (Windows PowerShell). New to Claude Code? Start with claude-homebase: /homebase sets up your global CLAUDE.md and project structure, then pick the SEO path to land here.
  • (Optional) a Visibly AI account for the pro tier — sign up free. Not required: the starter runs keyless.
  • Python 3.11+ (only needed for the PDF / data-crunching helpers)

2. Get the blueprint

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

3. (Optional) add your Visibly AI key

Skip this for the free tier — the keyless .mcp.json already works. To unlock the full data engine, create a free account at visibly-ai.com, copy your lc_... key, and connect it once (resolves at write time, stays out of git):

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

Full tier breakdown, Google-OAuth (live GSC/GA at 0 credits) and optional DataForSEO wiring: docs/setup.md.

4. Launch

bash
claude

On first run, Claude Code will ask you to approve the Visibly AI MCP server. Approve it, then try:

/visibly-seo-status-quo example.com

That's it. On the free tier, feed a GSC export to the Python templates; with a key, data is pulled live. Either way you're running the full SEO workflow.

🔁 The workflows

Each slash command corresponds to one phase of a real client engagement. They chain:

/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)

Full methodology is documented in docs/workflows.md.

📈 The CTR model

The potential analysis is only as good as its click-through-rate curve. This repo ships the Keyword Study 2026 — CTR by position from first-party Google Search Console data (1.3M keywords, 94 domains) — instead of the inflated textbook numbers most templates still use.

The differentiator: the curve is intent-aware. A navigational keyword at position 1 earns ~8.9% CTR; an informational one ~3.2%. Forecasting with one blended number quietly mis-states the upside. See docs/ctr-model.md for the full intent-by-position table and the Python to apply it. Honest inputs → defensible forecasts → offers that survive scrutiny.

🔍 Transparency — what runs where

No surprises about data flow:

  • Keyless (default): .mcp.json connects to mcp.visibly-ai.com without an account. Only the free knowledge tools respond (checklists, guidance, Google guidelines, keyword classification, URL-structure checks) — no client data involved.
  • With a key: the data tools (query_search_console, query_analytics, keywords, backlinks, on-page) route through the Visibly AI backend, hosted on Railway in the EU. Your GSC/GA data passes through that backend to reach Claude — that's the product, not a side effect. And it takes three explicit opt-ins before a single GSC row can flow: create a Visibly account, add your API key, and connect your Google account via OAuth inside Visibly. Without the Google consent, query_search_console has no property to read. Not acceptable for a client? Don't add the key: feed a GSC export to the local Python templates instead — the full workflow still runs.
  • Permissions: .claude/settings.json auto-allows only metadata and the free knowledge tools. Every tool that reads client data (GSC, GA, keywords, backlinks, on-page, crawling) sits in ask — Claude prompts before using it.
  • The hook (.claude/hooks/seo-check.sh) runs locally, sends nothing anywhere, and only injects a reminder to use real data instead of guessing when your prompt looks SEO-related. Don't want the nudge? Delete the hook.

🎨 Customise it

Everything is plain Markdown and shell — fork and adapt:

  • Branding — edit CLAUDE.md and templates/pdf_example.py with your colours, fonts, contact block.
  • Data source — keyless by default; add a Visibly key for the full engine, or wire your own (GSC export → Python templates, DataForSEO, GA4, Ahrefs…) in .mcp.json. See docs/setup.md. Free walkthrough for building your own GSC access from scratch: Indexing Checker für die Google Search Console (German).
  • Workflows — the .claude/commands/*.md files are the workflows. Rewrite them in your own words.
  • Guardrails — extend .claude/hooks/seo-check.sh with your own keyword triggers.

See docs/setup.md for a deeper walkthrough and docs/best-practices.md for the hard-won lessons.

📂 Repo layout

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

Related repos

RepoWhat it adds
claude-homebaseHow to set up Claude Code from scratch: /homebase interviews your role and builds CLAUDE.md, folders, skills and learnings
claude-context-guardWarns when the context gets expensive and carries a handoff briefing across /clear
delegate-auditLints Claude Code skills and LLM pipelines against the DELEGATE-52 hygiene rules
visiblyai-mcp-serverThe Visibly AI MCP server behind this starter
peec-ai-skillsSkills for brand visibility in ChatGPT, Perplexity and Google AI Overviews

More on the method: best Claude Code skills for developers.

🤝 Contributing

PRs welcome — see CONTRIBUTING.md. Found this useful? A ⭐ helps others find it.

📜 License

MIT — see LICENSE. Use it commercially, fork it, ship it for your own clients.

💬 Want help setting it up?

If you'd rather have this dialled in to your agency's workflow — or want to talk SEO, Claude Code, or vibe coding — book a consultation.


Created by Antonio Blago — SEO Freelancer & Neuro-SEO System®
📅 Book a consultation
If this saves you an afternoon per client, it did its job.

來源:README.md,提交 82bb028

工具

7

classify_keywords_simple

Classify keywords locally by intent, funnel stage, brand type, and topic. Free and available without an API key.

輸入參數keywords必填brand_namecompetitorsbrand_variationsproduct_keywords

seo_checklist

Get an SEO checklist. Types: general, blog, ecommerce, discover, backlink, all. Available in English and German. Free - no API key required.

輸入參數languagechecklist_type

seo_guidance

Get SEO best practices on a topic. Topics: title_tags, meta_descriptions, heading_structure, internal_linking, core_web_vitals, eeat, keyword_research, schema_markup, image_optimization, local_seo. Use topic='list' for all. Free - no API key required.

輸入參數topic必填

analyze_url_structure

Analyze a URL for SEO-friendliness. Checks length, structure, and common issues. Free - no API key required.

輸入參數url必填

list_locations

List available countries/locations for SEO data queries. Free - no API key required.

無需輸入參數。

get_skill

Get an SEO workflow skill with step-by-step methodology, triggers, credits, and quality gates from the current seo_skills catalog. Use name='content-nss-optimize' to write with your own model and improve an article toward measured NSS 70/80 using free Visibly scoring, then save it and show the editor link. Use name='list' for all available skills. Free - no API key required.

輸入參數name必填

get_google_guidelines

Get official Google Search developer guidelines by category. Free.

輸入參數category

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分