MCP Ubersuggest

🚀 Ubersuggest MCP Server

このMCP（Model Context Protocol）サーバーは、Neil Patelの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を提出する前に、コントリビュートガイドラインを読んでください。

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

サポート

問題や質問については、GitHubのイシュートラッカーを使用してください。

免責事項

このプロジェクトはNeil PatelまたはUbersuggestに関連付けられておらず、承認もされておらず、後援もされていません。自己責任で使用してください。