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 文件。