光环扫描-mcp服务器

Name: 光环扫描-mcp服务器
Author: occirank

作者：occirank2 星标更新：2025-08-06

安装使用来源：spider==github.com

项目介绍

Haloscan MCP 服务器

这是一个用于与 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, metrics, volume_history, serp ]中的任意组合。 至少需要指定一个请求数据。它们的含义如下： 
 - keyword_match：按搜索量排名的前10个包含所提供关键词的关键词（精确匹配）。 
 - related_search：按搜索量排名的前10个出现在所提供关键词的“相关搜索”部分的关键词。 
 - related_question：按搜索量排名的前10个出现在所提供关键词的“人们也问”（或如果关键词显然是一个问题，则在“相关搜索”部分）的关键词。 
 - similar_category：按搜索量排名的前10个具有相同“产品和服务”类别树的关键词。注意，获取这些数据会显著增加响应时间。 
 - similar_serp：按SERP相似性排名的前10个具有类似自然SERP的关键词。 
 - top_sites：按可见性排名的前10个网站，这些网站在所提供关键词及其类似关键词上排名较高。 
 - similar_highlight：按搜索量排名的前10个关键词，其相似词汇在SERP结果页面中被突出显示。 
 - categories：所提供关键词所属的产品和服务类别列表。 
 - metrics：所提供关键词的指标列表。这些指标包括： 
 - 广告指标：搜索量、竞争度、CPC。您通常的广告数据。 
 - SEO指标：修正后的搜索量、关键词匹配数、allintitle、KGR、KVI（关键词可见性指数）。 
 - volume_history：所提供关键词长达两年的搜索量历史。 
 - serp：所提供关键词的最新自然SERP。
get_keywords_match 
- 获取包含所提供关键词作为子串的关键词/表达式。 
- 输入： 
 - keyword (字符串)：请求的关键词。
get_keywords_highlights 
- 获取在SERP结果页面中相似词汇被突出显示的关键词/表达式。 
- 输入： 
 - keyword (字符串)：请求的关键词。
get_keywords_related 
- 获取出现在所提供关键词的“相关搜索”部分的关键词/表达式。 
- 输入： 
 - keyword (字符串)：请求的关键词。
get_keywords_questions 
- 获取出现在所提供关键词的“人们也问”（或如果关键词显然是一个问题，则在“相关搜索”部分）的关键词/表达式。 
- 输入：<
 - keyword (字符串)：请求的关键词。
get_keywords_find 
- 获取给定关键词或关键词列表的全面数据，包括SEO指标和广告指标。此端点是调用get_keywords_match、get_keywords_related、get_keywords_questions、get_keywords_highlights的封装。 
- 输入： 
 - keyword (字符串)：请求的关键词。 
 - keywords (字符串[])：请求的关键词。如果提供了keyword则忽略此参数。 
 - keywords_sources (字符串[])：从输入中查找关键词使用的策略（[match, serp, related, highlights, questions]中的任意组合）。 至少需要一个。它们的含义如下： 
 - match：包含所提供关键词的搜索查询（精确匹配）的关键词/表达式。 
 - serp：具有类似自然SERP的关键词/表达式。 
 - related：出现在所提供关键词的“相关搜索”部分的关键词/表达式。 
 - highlights：在SERP结果页面中相似词汇被突出显示的关键词/表达式。 
 - questions：出现在所提供关键词的“人们也问”（或如果关键词显然是一个问题，则在“相关搜索”部分）的关键词/表达式。
get_keywords_site_structure 
- 聚类端点。您可以批量使用（然后提供keywords的值）或单次请求（然后提供keyword的值）。 
- 输入： 
 - keyword (字符串)：请求的关键词。如果提供了keywords则忽略此参数。如果您仅提供keyword（不提供keywords），则首先运行类似于get_keywords_find的操作以获取要分组的关键词。 
 - keywords (字符串[])：请求的关键词。 
 - mode (字符串)：聚类模式。可以是manual或multi。在manual模式下，关键词基于SERP相似性进行分组。在multi模式下，根据图链接密度创建层次结构。
get_keywords_serp_compare 
- 比较给定关键词/表达式的SERP在两个不同日期的情况。 
- 输入： 
 - keyword (字符串)：请求的关键词/表达式。 
 - period (字符串)：SERP的比较周期（1个月、3个月、6个月、12个月、自定义）。 
 - first_date (字符串)：YYYY-MM-DD格式的日期。如果period不是custom则忽略此参数。此日期必须是给定关键词/表达式的有效日期。有效的搜索日期会在调用响应中的available_search_dates项中返回，或者作为get_keywords_serp_available_dates的响应。 
 - second_date (字符串)：YYYY-MM-DD格式的日期。如果period不是custom则忽略此参数。此日期必须是给定关键词/表达式的有效日期。有效的搜索日期会在调用响应中的available_search_dates项中返回，或者作为get_keywords_serp_available_dates的响应。
get_keywords_serp_availableDates 
- 获取给定关键词的历史SERP数据可用日期。 
- 输入： 
 - keyword (字符串)：请求的关键词。
get_keywords_serp_pageEvolution 
- 获取给定URL在特定关键词上的SERP排名随时间的变化。所有参数都是必需的。 
- 输入： 
 - keyword (字符串)：请求的关键词/表达式。 
 - first_date (字符串)：YYYY-MM-DD格式的日期。 
 - second_date (字符串)：YYYY-MM-DD格式的日期。 
 - url (字符串)：跟踪排名的URL。
get_keywords_bulk 
- 批量获取多个关键词的数据（SEO指标、广告指标等）。 
- 输入： 
 - keywords (字符串[])：包含请求关键词的数组。
get_keywords_scrap 
- 请求Haloscan抓取给定关键词/表达式的搜索引擎结果页面（SERP）。抓取大约需要24小时才能完成。 
- 输入： 
 - keywords (字符串[])：包含请求关键词的数组。

3. 站点探索工具

get_domains_overview 
- 获取特定域名的全面SEO性能总结。 
- 输入： 
 - input (字符串)：目标网址、域名或根域名。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。 
 - requested_data (字符串[])：至少一个（metrics、positions_breakdown、traffic_value、categories、best_keywords、best_pages、gmb_backlinks、visibility_index_history、positions_breakdown_history、positions_and_pages_history）。要获取的数据： 
 - metrics：给定域名的SEO指标（VI、排名数量、关键词数量、流量、页面数量、排名等）。 
 - positions_breakdown：给定域名的搜索引擎排名位置。 
 - traffic_value：给定域名的流量价值（对于大型域名可能需要一段时间计算）。 
 - categories：给定域名的类别（对于大型域名可能需要一段时间计算）。 
 - best_keywords：给定域名的最佳表现关键词（对于大型域名可能需要一段时间计算）。 
 - best_pages：给定域名的最佳表现页面（对于大型域名可能需要一段时间计算）。 
 - gmb_backlinks：给定域名的GMB反向链接。 
 - visibility_index_history：给定域名的可见性指数历史。 
 - positions_breakdown_history：给定域名的搜索引擎排名位置分解历史。 
 - positions_and_pages_history：给定域名的搜索引擎排名位置和页面历史。
get_domains_positions 
- 获取指定域名的搜索引擎排名位置。 
- 输入： 
 - input (字符串)：目标网址、域名或根域名。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。
get_domains_top_pages 
- 根据聚合的自然搜索指标（如流量、排名关键词数量）获取指定域名的最佳表现页面。 
- 输入： 
 - input (字符串)：目标网址、域名或根域名。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。
get_domains_history_positions 
- 获取特定域名在两个指定日期之间的历史排名位置。非常有用，如果您想找到丢失的位置。 
- 输入： 
 - input (字符串)：目标网址或域名。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。 
 - date_from (字符串)：YYYY-MM-DD格式的日期。 
 - date_to (字符串)：YYYY-MM-DD格式的日期。
get_domains_history_pages 
- 获取指定域名在两个指定日期之间页面级别的历史SEO性能数据。 
- 输入： 
 - input (字符串)：目标网址或域名。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。 
 - date_from (字符串)：YYYY-MM-DD格式的日期。 
 - date_to (字符串)：YYYY-MM-DD格式的日期。
get_page_best_keywords 
- 获取特定URL的最佳表现关键词，展示哪些搜索查询为该页面带来了最多的流量和可见性。 
- 输入： 
 - input (字符串[])：目标网址。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。 
 - strategy (字符串)：任何一种（both、only_active、only_lost）。是否返回所有排名关键词、仅活跃的关键词或仅丢失的关键词。
get_domains_keywords 
- 获取给定域名在给定关键词列表中的当前排名位置。 
- 输入： 
 - input (字符串)：目标网址或域名。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。 
 - keywords (字符串[])：必需的关键词数组。
get_domains_bulk 
- 在单个请求中获取多个域名的SEO性能指标。 
- 输入： 
 - inputs (字符串[])：包含请求网址或域名的数组。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。
get_domains_competitors 
- 基于重叠关键词获取给定域名的有机搜索竞争对手列表（对于大型域名可能需要一段时间计算）。 
- 输入： 
 - input (字符串)：目标网址或域名。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。
get_domains_competitors_keywords_diff 
- 比较给定域名与其竞争对手的关键词差异，突出显示一个域名排名而另一个未排名的关键词（对于大型域名可能需要一段时间计算）。 
- 输入： 
 - input (字符串)：目标网址或域名。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。 
 - competitors (字符串[])：必需的（最多20个）竞争对手列表，用于比较输入。 
 - exclusive (布尔值)：是否包括只有搜索输入排名而没有请求的竞争对手排名的位置。 
 - missing (布尔值)：是否包括搜索输入未排名而至少有一个请求的竞争对手排名的位置。 
 - bested (布尔值)：是否包括搜索输入排名且比至少一个请求的竞争对手排名更好的位置。 
 - besting (布尔值)：是否包括搜索输入排名但至少有一个请求的竞争对手排名更好的位置。
get_domains_competitors_best_pages 
- 获取给定域名的（指定）竞争对手的最佳表现页面（对于大型域名可能需要一段时间计算）。 
- 输入： 
 - input (字符串)：目标网址或域名。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。 
 - competitors (字符串[])：必需的（最多20个）竞争对手列表，用于比较输入。
get_domains_competitors_keywords_best_positions 
- 获取给定关键词列表在给定域名列表上的最佳排名位置。 
- 输入： 
 - competitors (字符串[])：竞争对手域名或根域名列表。 
 - keywords (字符串[])：必需的关键词列表。
get_domains_visibility_trends 
- 获取特定域名随时间变化的可见性趋势，展示其搜索引擎可见性的演变。 
- 输入： 
 - input (字符串[])：包含请求网址或域名的数组。 
 - mode (字符串)：任何一种（auto、root、domain、url）。如何解释输入。通常，您希望使用root来获取关于根域名的数据。 
 - type (字符串)：任何一种（first、highest、trends、index）。数据是否应缩放以及如何缩放。使用index获取原始可见性指数。
get_domains_expired 
- 返回可用域名列表。除非您已经揭示了它们（在这种情况下，root_domain会被填充），否则域名将不带URL返回，并且需要调用domains/expired/reveal来揭示您感兴趣的域名。 
- 输入： 
 - keyword (字符串)：可选关键词，过期域名应该在此关键词上排名。

配置

注册一个 Haloscan账户。
选择一个计划。
从配置API页面生成您的API密钥。
将API密钥用于Claude Desktop配置文件中的Haloscan服务器。

使用Claude Desktop

将此服务器添加到您的Claude Desktop配置文件claude_desktop_config.json中：

NPX

{
  "mcpServers": {
    "haloscan": {
      "command":