金大哥 - mcp-ubersuggest MCP 详情

article

README

🚀 Ubersuggest MCP 服务器

这是一个 MCP（模型上下文协议）服务器，它将尼尔·帕特尔（Neil Patel）的 Ubersuggest SEO 平台与 Cursor IDE 集成，让你能够在开发环境中直接进行 AI 辅助的 SEO 分析。

🚀 快速开始

本服务器可将 Ubersuggest SEO 平台与 Cursor IDE 集成，让你在开发环境中直接开展 AI 辅助的 SEO 分析。按以下步骤操作，即可快速开启使用。

✨ 主要特性

域名概况：提供全面的域名分析，涵盖流量和排名数据。
关键词研究：研究关键词，获取搜索量、竞争难度和竞争程度等指标。
网站审计：执行技术 SEO 审计，以发现优化机会。
流量预估：预估域名的自然流量潜力。

📦 安装指南

前提条件

Node.js v16 或更高版本
Ubersuggest 账户凭证
支持 MCP 的 Cursor IDE

安装步骤

克隆仓库：

git clone https://github.com/yourusername/mcp-ubersuggest.git
cd mcp-ubersuggest

安装依赖：

npm install

根据 .env.example 创建 .env 文件：

cp .env.example .env

在 .env 文件中添加你的 Ubersuggest 凭证：

UBERSUGGEST_USERNAME=your-email@example.com
UBERSUGGEST_PASSWORD=your-password

💻 使用示例

运行 MCP 服务器

npm start

若要在开发环境中实现自动重新加载，可运行：

npm run dev

配置 Cursor IDE

在你的 Cursor IDE 的 MCP 配置中添加以下内容：

{
  "mcpServers": {
    "ubersuggest-seo": {
      "command": "node",
      "args": ["/path/to/mcp-ubersuggest/src/index.js"],
      "env": {
        "UBERSUGGEST_USERNAME": "your-email@example.com",
        "UBERSUGGEST_PASSWORD": "your-password"
      }
    }
  }
}

可用工具

基础用法

以下是各个工具的基础使用说明：

1. 域名概况

ubersuggest_domain_overview
- 分析域名性能指标
- 参数：domain（必需），country（可选）

2. 关键词研究

ubersuggest_keyword_research
- 研究关键词并获取详细指标
- 参数：keyword（必需），language（可选），location（可选）

3. 网站审计

ubersuggest_site_audit
- 执行技术 SEO 审计
- 参数：url（必需），pages_limit（可选）

4. 流量预估

ubersuggest_traffic_estimation
- 预估自然流量潜力
- 参数：domain（必需），period（可选）

📚 详细文档

法律声明

⚠️ 重要提示

这是一个非官方集成，使用了逆向工程的端点。使用此工具可能违反 Ubersuggest 的服务条款。用户需负责：

审查并遵守 Ubersuggest 的服务条款

了解网页抓取的法律风险

使用保守的速率限制，以减少对服务器的影响

承担使用此非官方集成的所有风险

安全考量

凭证存储在环境变量中。
所有 API 通信均使用 HTTPS。
实施了速率限制，以防止被检测。
安全管理会话令牌。

贡献说明

欢迎贡献代码！在提交 PR 之前，请阅读我们的贡献指南。

支持与反馈

如有问题和疑问，请使用 GitHub 问题跟踪器。

免责声明

本项目与尼尔·帕特尔（Neil Patel）或 Ubersuggest 没有关联，未得到其认可或赞助。使用时请自行承担风险。

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

mcp-ubersuggest