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 个人 资料).服务 每 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"
      }
    }
  }
}

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

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

如果文件不存在，请创建它。如果已经存在，请添加 "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 会根据您的需求自动选择正确的工具。

______________________________________________________________________

环境变量

______________________________________________________________________

可用工具 （25）

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

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

关键词--4工具

域--8工具

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

URLs-4工具

项目--8工具

实用工具——1个工具

______________________________________________________________________

测试控制MCP检查员

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

______________________________________________________________________

API环保室

官方文件： apidoc.seozoom.it

______________________________________________________________________

如何创建

项目设置

初始化为 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