Backlinks MCP

🚀 SEO MCP 工具服務基於 Ahrefs 數據

這是一個基於 Ahrefs 數據支持的 Model Control Protocol (MCP) 工具服務，可提供 SEO 數據獲取功能。它能實現反向鏈接分析、關鍵詞研究、流量估算等，為 SEO 工作者提供了強大的支持。

English

🚀 快速開始

此服務為從 Ahrefs 獲取 SEO 數據提供了 API 接口，涵蓋了解決 CAPTCHA、身份驗證和數據獲取的整個流程。並且，結果會被緩存以提高性能並降低成本。

⚠️ 重要提示

此 MCP 工具僅供教育用途使用。請勿濫用本工具。該項目靈感來源於 @哥飛社群。

✨ 主要特性

• 🔍 反向鏈接分析
  • 獲取任意域名的詳細反向鏈接數據。
  • 查看域名評分、錨文本和鏈接屬性。
  • 過濾教育類及政府類域名。
• 🎯 關鍵詞研究
  • 根據種子關鍵詞生成關鍵詞建議。
  • 獲取關鍵詞難度分數。
  • 查看搜索量和趨勢。
• 📊 流量分析
  • 估算網站流量。
  • 查看流量歷史和趨勢。
  • 分析熱門頁面及國家分佈。
  • 監控關鍵詞排名。
• 🚀 性能優化
  • 使用 CapSolver 自動解決 CAPTCHA。
  • 響應緩存。

📦 安裝指南

先決條件

• Python 3.10 或更高版本。
• CapSolver 賬戶及 API Key（註冊鏈接）。

從 PyPI 安裝

pip install seo-mcp

或使用 uv：

uv pip install seo-mcp

手動安裝

1. 克隆倉庫：

git clone https://github.com/cnych/seo-mcp.git
cd seo-mcp

2. 安裝依賴項：

pip install -e .
# 或者
uv pip install -e .

3. 設置 CAPSOLVER_API_KEY 環境變量：

export CAPSOLVER_API_KEY="你的 API Key"

💻 使用示例

基礎用法

from seo_mcp import MCPClient

client = MCPClient(api_key="你的 Ahrefs API Key", cap_key="你的 CapSolver API Key")

# 獲取反向鏈接數據
backlinks_data = client.get_backlinks(domain="example.com")

# 獲取關鍵詞排名數據
keyword_rankings = client.get_keyword_rankings(keyword="SEO", country="us")

# 獲取流量數據
traffic_data = client.get_traffic_analysis(url="https://www.example.com")

示例輸出

反向鏈接數據示例：

{
  "domain": "example.com",
  "backlinks_count": 1234,
  "dofollow_backlinks": 890,
  "nofollow_backlinks": 345,
  "top_backlink_domains": ["www.example1.com", "www.example2.com"]
}

📚 詳細文檔

開發指南

git clone https://github.com/cnych/seo-mcp.git
cd seo-mcp
uv sync

工作原理

1. 用戶通過 MCP 發送請求。
2. 服務使用 CapSolver 解決 Cloudflare Turnstile CAPTCHA。
3. 服務從 Ahrefs 獲取身份驗證令牌。
4. 服務提取所需 SEO 數據。
5. 服務處理數據並返回格式化結果。

故障排除

• CapSolver API Key 錯誤：檢查 CAPSOLVER_API_KEY 環境變量。
• 速率限制：降低請求頻率。
• 無結果：目標域名可能未被 Ahrefs 索引。
• 其他問題：請訪問 GitHub 倉庫。

📄 許可證

MIT License - 詳見 LICENSE 文件