AI导哈

SEOZoom MCP服务器

SEOZoom MCP Server是一个将SEOZoom API作为工具暴露给Claude Desktop、Claude Code和其他兼容MCP客户端的服务器。

  • by Sozione
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Sozione/seozoom-mcp

使用说明

SEOZoom MCP Server

Server MCP che espone le API di SEOZoom come tool per Claude Desktop, Claude Code, Cursor e altri client MCP compatibili.

服务器远程操作（精简版）

你不想安装任何东西吗？使用托管在 Koyeb 上的远程 MCP 服务器。只需一个URL和您的SEOZoom API密钥。

服务器URL：

https://fresh-chiquita-sozione-22beccd8.koyeb.app/mcp?api_key=LA-TUA-API-KEY

克劳德代码 — 添加到 .mcp.json 哦 ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "seozoom": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://fresh-chiquita-sozione-22beccd8.koyeb.app/mcp?api_key=LA-TUA-API-KEY"]
    }
  }
}

克劳德桌面 — 两个选项：

选项 1 （接口）： 或进入 设置 → 连接器 → 添加自定义连接器 并粘贴URL：

选项 2 （JSON）： 添加到 claude_desktop_config.json (macOS | 视窗):

{
  "mcpServers": {
    "seozoom": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://fresh-chiquita-sozione-22beccd8.koyeb.app/mcp?api_key=LA-TUA-API-KEY"]
    }
  }
}

替换 LA-TUA-API-KEY 使用您的 SEOZoom API 密钥（您可以在您的 SEOZoom 个人 资料).服务 Node.js 每 npx.

本地安装

如果您希望在本地运行服务器（不依赖于远程服务器）：

快速开始

1. 安装uv（如果你没有）

uv 快速的Python包管理器。它使用命令安装并自动管理所有内容（包括Python）。

macOS/Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

你已经有了 uv跳到第二步

2. 克隆并安装

git clone https://github.com/Sozione/seozoom-mcp.git
cd seozoom-mcp
uv sync

uv sync 下载 Python（如有必要），并自动安装所有依赖项。

3.配置

根据您使用的客户端，在正确的文件中添加以下 JSON 配置。

替换 /path/to/seozoom-mcp 真正的路线和 la-tua-api-key 使用您的 SEOZoom API 密钥（您可以在您的 SEOZoom 个人 资料).

{
  "mcpServers": {
    "seozoom": {
      "command": "uv",
      "args": ["--directory", "/path/to/seozoom-mcp", "run", "seozoom-mcp"],
      "env": {
        "SEOZOOM_API_KEY": "la-tua-api-key"
      }
    }
  }
}

克劳德代码 选择放在哪里：

文件 效果
.mcp.json 在项目的根目录中 仅在该项目中激活
~/.claude/claude_code_config.json 积极参与所有项目。

克劳德桌面 — 添加配置到：

OS 文件
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
窗户 %APPDATA%\Claude\claude_desktop_config.json

如果文件不存在，请创建它。如果已经存在，请添加 "seozoom": { ... } 里面 "mcpServers".

4. 开始

  • 克劳德代码打开终端并检查 /mcp 服务器处于活动状态
  • 克劳德桌面重新启动应用程序，服务器将出现在工具列表中

服务器会自动启动和关闭 Claude。不需要手动管理。

Claude Code 使用指南

设置完毕后，您可以向Claude询问有关SEO的任何内容，他将自动使用SEOZoom工具。一些例子：

Analisi关键字

Quali sono le metriche per la keyword "regime forfettario"?
Trova le keyword correlate a "partita iva"
Mostrami la SERP per "calcolatore tasse forfettario"

域分析

Analizza il dominio repubblica.it
Quali sono le migliori pagine di corriere.it?
Chi sono i competitor organici di aranzulla.it?
Mostrami le keyword per cui ilsole24ore.it appare nelle AI Overview

URL 分析

Quante keyword ha posizionato questa pagina? https://example.com/pagina
Qual e il Page Zoom Authority di questa URL?
Trova le keyword con potenziale non sfruttato per questa URL

项目管理

Mostrami la lista dei miei progetti SEOZoom
Qual e la panoramica del progetto 190197?
Quali pagine del mio progetto stanno perdendo traffico?

成本监控

Quante unita API mi restano?

无需指定使用哪个工具：Claude 会根据您的需求自动选择正确的工具。

环境变量

变量 强制性 Default 描述
SEOZOOM_API_KEY 是 — SEOZoom 配置文件的 API 密钥
SEOZOOM_DEFAULT_DB 没有 it 国家数据库： it es fr de uk

可用工具 （25）

每个响应都会自动包括通话费用：

[Costo: 10 unit | Rimanenti: 4950 | Risultati: 1]

关键词--4工具

工具 参数 描述
keyword_metrics 关键字，DB？搜索量，KD，CPC，intent，月度趋势
keyword_serp 关键字，DB？ 当前SERP结果（最多50个结果）
keyword_serp_history 关键字：date，db？ 日期的 SERP 历史快照
keyword_related 关键字，db？限制？ 关键字相关亲和SERP

域--8工具

工具 参数 描述
domain_metrics 域名，DB？ 估计流量， 关键字位置， ZA
domain_metrics_history 域名，日期，数据库？某个日期的历史指标
domain_authority 域名，db？ Zoom权威、信任、稳定、机会
domain_niches 域名，db？限制？ 小众话题权威
domain_best_pages 域名，DB？限制？ 最佳PZA页面
domain_ai_keywords 域名，db？偏移？限制？ 谷歌关键词nelle AI概述
domain_keywords 域、类型、数据库？偏移？限制？ 按提示过滤关键字
domain_competitors 域名，db？限制？ 竞争对手组织

类型为 domain_keywords: best withtraffic up down stable entered exited bypage byposition newentry

URLs-4工具

工具 参数 描述
url_page_authority url、db？ 页面缩放权限（PZA）
url_metrics url，db？总关键字，交通，PZA
url_keywords url，db？限制？关键字以数量和CPC排列。
url_intent_gap url，db？限制？关键字有未开发的潜力。

项目--8工具

工具 参数 描述
project_list db ？列出所有项目。
project_overview ID，DB？ 项目全面概述
project_keywords id，db？ 关键字监控
project_best_pages ID，DB？限制？最好的项目页面
project_pages_with_more_keywords ID，DB？限制？关键字最多的页面
project_pages_with_potential ID，DB？限制？有增长潜力的页面
project_winner_pages ID，DB？限制？页面增长。
project_loser_pages ID，DB？限制？页面下降。

实用工具——1个工具

工具 参数 描述
check_units — 检查剩余的 API 单位（费用 10 单位）

测试控制MCP检查员

SEOZOOM_API_KEY=la-tua-api-key uv run mcp dev src/seozoom_mcp/server.py

API环保室

官方文件： apidoc.seozoom.it
每通话成本 每行10-120个单位
支持的数据库 it es fr de uk

如何创建

项目设置

初始化为 uv init，创造 pyproject.toml 和虚拟env .venv.

依赖性

[project]
dependencies = [
    "mcp[cli]",   # SDK MCP con FastMCP
    "httpx",      # Client HTTP async
]

[project.scripts]
seozoom-mcp = "seozoom_mcp.server:main"
  • mcp[cli] Model Context Protocol SDK，包括 FastMCP 以声明方式创建服务器
  • httpx 异步HTTP客户端，因为MCP工具是功能所必需的 async

客户端HTTP(client.py)

克拉斯 SEOZoomClient 包装 SEOZoom v2 REST API：

  • 基本URL: https://apiv2.seozoom.com/api/v2
  • 验证 ： api_key come查询参数
  • 所有端点均为 GET action come查询参数
  • 多个值（关键字，域名，URL）由管道分隔 |
  • 每个端点的一个方法，返回响应的 JSON

服务器MCP(server.py)

创建于 FastMCPMCP SDK 的声明框架：

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("seozoom")

@mcp.tool()
async def keyword_metrics(
    keywords: Annotated[list[str], "Lista di keyword (max 100)"],
    db: Annotated[str | None, "Database paese (it, es, fr, de, uk)"] = None,
) -> str:
    """Ottieni metriche per una o piu keyword."""
    return _fmt(await client.keyword_metrics(keywords, db))

每个工具：

  • Ha类型提示 Annotated LLM的描述
  • 它有一个 docstring，LLM 用来理解何时调用它
  • 将 JSON 返回为字符串
  • 将 HTTP 调用委派给 SEOZoomClient

运输

服务器用于传输 标准 （标准输入/输出），与 Claude Desktop、Claude Code 和 Cursor 兼容。MCP 客户端启动进程，并通过 stdin/stdout 通过 JSON-RPC 消息进行通信。

许可证

AGPL-3.0

联系方式

如有疑问、建议或协作： info@pasqualeverta.it

相关 MCP