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 许可证。