Backlinks MCP

🚀 SEO MCP ツールサービス（Ahrefs データベースベース）

このサービスは、Ahrefs のデータを基に、SEO データ取得を行う Model Control Protocol (MCP) ツールです。機能には、逆リンク分析、キーワード研究、トラフィック推定などが含まれます。

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 ファイルを参照してください。