MCP

🚀 Haloscan MCP Server

Haloscan MCP Serverは、Haloscan SEO APIとやり取りするためのModel Context Protocol (MCP) サーバーです。このサーバーを使用すると、Claude for Desktop、N8NなどのMCP互換クライアントと簡単に統合できます。

✨ 主な機能

• MCPツールを通じてHaloscan SEO APIの機能を公開します。
• 一般的なSEOタスクのプロンプトを提供します。
• N8Nなどのワークフロー自動化ツールと簡単に統合できます。

🛠️ ツール

1. ユーザーツール

• get_user_credit
  • 提供されたAPIキーで識別されるユーザーの残りクレジットを取得します。

2. キーワードエクスプローラーツール

• get_keywords_overview

  • 特定のキーワードの概要を取得し、検索量、競争レベル、経時的なトレンドなどの主要なパフォーマンス指標を提供します。
  • 入力:
    • keyword (文字列): 要求するキーワード。
    • requested_data (文字列配列): [keyword_match, related_search, related_question, similar_category, similar_serp, top_sites, similar_highlight, categories, synonyms, metrics, volume_history, serp ] の任意の組み合わせ。

• get_keywords_match

  • 完全一致検索に基づいてキーワードデータを取得し、特定のキーワードが検索エンジンでどのように機能するかに関する詳細な洞察を提供します。
  • 入力:
    • keyword (文字列): 要求するキーワード。

• get_keywords_similar

  • 与えられたキーワードと意味的またはトピック的に類似したキーワードのリストを取得します。
  • 入力:
    • keyword (文字列): 要求するキーワード。

• get_keywords_highlights

  • 与えられたキーワードから主要なパフォーマンスハイライトを取得します。
  • 入力:
    • keyword (文字列): 要求するキーワード。

• get_keywords_related

  • 与えられたキーワードと文脈的またはトピック的に関連するキーワードのリストを取得します。
  • 入力:
    • keyword (文字列): 要求するキーワード。

• get_keywords_questions

  • 与えられたキーワードに関連する質問ベースのキーワードのリストを取得します。
  • 入力:
    • keyword (文字列): 要求するキーワード。

• get_keywords_synonyms

  • 与えられたキーワードに関連する同義語のリストを取得します。
  • 入力:
    • keyword (文字列): 要求するキーワード。

• get_keywords_find

  • 与えられたキーワードまたはキーワードのリストに関する包括的なデータを取得し、検索量、競争、トレンド分析などを含みます。
  • 入力:
    • keyword (文字列): 要求するキーワード。
    • keywords (文字列配列): 要求するキーワード。
    • keywords_sources (文字列配列): 入力からキーワードを見つけるために使用する戦略 ([match, serp, related, highlights, categories, questions] の任意の組み合わせ)。

• get_keywords_site_structure

  • 与えられたドメインのサイト構造データを取得し、サイトのページに関連付けられたキーワード、階層構造、およびSEO最適化に関連するメタデータを含みます。
  • 入力:
    • keyword (文字列): 要求するキーワード。

• get_keywords_serp_compare

  • 2つ以上のキーワードの検索エンジン結果ページ (SERP) の比較を取得し、検索ランキングでのパフォーマンスに関する洞察を提供します。
  • 入力:
    • keyword (文字列): 要求するキーワード。
    • period (文字列): SERPの比較期間 (1か月、3か月、6か月、12か月、カスタム)。

• get_keywords_serp_availableDates

  • 与えられたキーワードの特定の期間における過去のSERPデータの利用可能な日付を取得します。
  • 入力:
    • keyword (文字列): 要求するキーワード。

• get_keywords_serp_pageEvolution

  • 特定のキーワードのSERPランキングの経時的な変化を取得し、検索結果でのページの位置がどのように変化したかを示します。
  • 入力:
    • keyword (文字列): 要求するキーワード。
    • first_date (文字列): YYYY-MM-DD形式の日付。
    • second_date (文字列): YYYY-MM-DD形式の日付。
    • url (文字列)

• get_keywords_bulk

  • 一括リクエストで複数のキーワードに関するキーワードデータを取得します。
  • 入力:
    • keywords (文字列配列): 要求するキーワードを含む配列。

• get_keywords_scrap

  • 与えられたキーワードの検索エンジン結果ページ (SERP) をスクレイピングしてキーワードデータを取得します。
  • 入力:
    • keywords (文字列配列): 要求するキーワードを含む配列。

3. サイトエクスプローラーツール

• get_domains_overview

  • 特定のドメインの包括的なSEOパフォーマンスの概要を取得します。
  • 入力:
    • input (文字列): 要求するURL、ドメイン、またはルートドメイン。
    • requested_data (文字列配列): 与えられたURLまたはドメインに関する要求データで、Haloscan概要ページの異なるセクションの内容に対応します。

• get_domains_positions

  • 指定されたドメインの1つ以上のキーワードに対する検索エンジンランキングの位置を取得します。
  • 入力:
    • input (文字列): 要求するURL、ドメイン、またはルートドメイン。

• get_domains_top_pages

  • 有機検索メトリクス (トラフィック、ランキングキーワードの数、可視性など) に基づいて、指定されたドメインの上位ページを取得します。
  • 入力:
    • input (文字列): 要求するURL、ドメイン、またはルートドメイン。

• get_domains_history_positions

  • 特定のドメインの選択されたキーワードに対する過去のランキング位置を取得します。
  • 入力:
    • input (文字列): 要求するURLまたはドメイン。
    • date_from (文字列): YYYY-MM-DD形式の日付。
    • date_to (文字列): YYYY-MM-DD形式の日付。

• get_domains_history_pages

  • 指定されたドメインの上位ページの過去のSEOパフォーマンスデータを取得します。
  • 入力:
    • input (文字列): 要求するURLまたはドメイン。
    • date_from (文字列): YYYY-MM-DD形式の日付。
    • date_to (文字列): YYYY-MM-DD形式の日付。

• get_page_best_keywords

  • 特定のURLの上位キーワードを取得し、どの検索クエリがそのページに最も多くのトラフィックと可視性をもたらすかを示します。
  • 入力:
    • input (文字列配列): 要求するURL。

• get_domains_keywords

  • 有機検索結果でドメインがランキングするすべてのキーワードを取得し、ランキング位置、トラフィック、検索量などの関連メトリクスを含みます。
  • 入力:
    • input (文字列): 要求するURLまたはドメイン。
    • keywords (文字列配列): 要求するキーワードを含む配列。

• get_domains_bulk

  • 単一のリクエストで複数のドメインのSEOパフォーマンスメトリクスを取得します。
  • 入力:
    • inputs (文字列配列): 要求するURLまたはドメインを含む配列。

• get_domains_competitors

  • 重複するキーワードに基づいて、与えられたドメインの有機検索競合相手のリストを取得します。
  • 入力:
    • input (文字列): 要求するURLまたはドメイン。

• get_domains_competitors_keywords_diff

  • 与えられたドメインとその競合相手のキーワードの違いを比較し、一方のドメインがランキングするが他方がランキングしないキーワードを強調表示します。
  • 入力:
    • input (文字列): 要求するURLまたはドメイン。
    • competitors (文字列配列): 入力と比較する競合相手のリスト。

• get_domains_competitors_best_pages

  • 与えられたドメインの競合相手の上位ページを取得します。
  • 入力:
    • input (文字列): 要求するURLまたはドメイン。
    • competitors (文字列配列): 入力と比較する競合相手のリスト。

• get_domains_competitors_keywords_best_positions

  • 与えられたドメインの競合相手と比較した上位ランキングのキーワードを取得します。
  • 入力:
    • competitors (文字列配列): 競合ドメインまたはルートドメインのリスト。
    • keywords (文字列配列): 探すキーワードのリスト。

• get_domains_visibility_trends

  • 特定のドメインの可視性トレンドを経時的に取得し、検索エンジンでの可視性がどのように変化したかを示します。
  • 入力:
    • input (文字列配列): 要求するURLまたはドメインを含む配列。

• get_domains_expired

  • 特定のドメインの可視性トレンドを経時的に取得し、検索エンジンでの可視性がどのように変化したかを示します。

📦 インストール

1. Haloscanアカウントにサインアップします。
2. プランを選択します。
3. 設定APIページからAPIキーを生成します。
4. Claude Desktopの設定ファイルでHaloscanサーバーにAPIキーを使用します。

💻 使用例

Claude Desktopでの使用

Claude Desktopの設定ファイル claude_desktop_config.json にこのサーバーを追加します。

NPX

{
  "mcpServers": {
    "haloscan": {
      "command": "npx",
      "args": [
        "-y",
        "@occirank/haloscan-server",
        "start"
      ],
      "env": {
        "HALOSCAN_API_KEY": "YOUR API KEY"
      }
    }
  }
}

📄 ライセンス

MIT