MCP

🚀 Haloscan MCP 服務器

Haloscan MCP 服務器是一個基於模型上下文協議（MCP）的服務器，用於與 Haloscan SEO API 進行交互。它能夠讓你輕鬆地將其與 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
  • 檢索兩個或多個關鍵詞的搜索引擎結果頁面（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
  • 檢索指定域名針對一個或多個關鍵詞的搜索引擎排名位置。
  • 輸入參數：
    • 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 配置文件中使用該 API 密鑰來配置 Haloscan 服務器。

💻 使用示例

基礎用法

將此服務器添加到你的 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 許可證。