MCP Ubersuggest

🚀 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

安装步骤

1. 克隆仓库：

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

2. 安装依赖：

npm install

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

cp .env.example .env

4. 在 .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 文件。