Haloscan MCP Server

Haloscan MCP Server

A Model Context Protocol (MCP) server for interacting with the Haloscan SEO API.
This server allows easy integration with Claude for Desktop, N8N, and other MCP-compatible clients.

Features

• Exposes Haloscan SEO API functionality through MCP tools
• Provides prompts for common SEO tasks
• Easy integration with workflow automation tools like N8N

Tools

1. User Tools

• get_user_credit
  • Retrieves the remaining credit for the user identified by the provided API key.

2. Keyword Explorer Tools

• get_keywords_overview

  • Retrieves an overview of a specific keyword, providing key performance indicators such as search volume, competition level, and trends over time.
  • Inputs:
    • keyword (string): Requested keyword.
    • requested_data (string[]): Any combination of [keyword_match, related_search, related_question, similar_category, similar_serp, top_sites, similar_highlight, categories, synonyms, metrics, volume_history, serp ].

• get_keywords_match

  • Retrieves keyword data based on an exact match search, providing detailed insights into how the specific keyword performs in search engines.
  • Input:
    • keyword (string): Requested keyword.

• get_keywords_similar

  • Retrieves the list of keywords that are semantically or topically similar to a given keyword.
  • Input:
    • keyword (string): Requested keyword.

• get_keywords_highlights

  • Retrieves the key performance highlights from a given keyword.
  • Input:
    • keyword (string): Requested keyword.

• get_keywords_related

  • Retrieves the list of keywords that are contextually or topically related to a given keyword.
  • Input:
    • keyword (string): Requested keyword.

• get_keywords_questions

  • Retrieves a list of question-based keywords related to a given keyword.
  • Input:
    • keyword (string): Requested keyword.

• get_keywords_synonyms

  • Retrieves a list of synonyms related to a given keyword.
  • Input:
    • keyword (string): Requested keyword.

• get_keywords_find

  • Retrieves comprehensive data for a given keyword or list of keywords, including search volume, competition, and trend analysis.
  • Inputs:
    • keyword (string): Requested keyword.
    • keywords (string[]): Requested keywords.
    • keywords_sources (string[]): Which strategies to use to find keywords from input (Any combination of [match, serp, related, highlights, categories, questions]).

• get_keywords_site_structure

  • Retrieves the site structure data for a given domain, including the keywords associated with the site's pages, hierarchical organization, and relevant metadata for SEO optimization.
  • Input:
    • keyword (string): Requested keyword.

• get_keywords_serp_compare

  • Retrieves a comparison of search engine results pages (SERP) for two or more keywords, providing insights into how they perform in search rankings.
  • Inputs:
    • keyword (string): Requested keyword.
    • period (string): The comparison period for SERPs (1 month, 3 months, 6 months, 12 months, custom).

• get_keywords_serp_availableDates

  • Retrieves the available dates for historical SERP data of a given keyword at a given period.
  • Input:
    • keyword (string): Requested keyword.

• get_keywords_serp_pageEvolution

  • Retrieves the evolution of SERP rankings for a specific keyword over time, showing how a page's position in search results has changed.
  • Inputs:
    • keyword (string): Requested keyword.
    • first_date (string): Date in YYYY-MM-DD format.
    • second_date (string): Date in YYYY-MM-DD format.
    • url (string)

• get_keywords_bulk

  • Retrieves keyword data for multiple keywords at once in a bulk request.
  • Input:
    • keywords (string[]): Array containing the requested keywords.

• get_keywords_scrap

  • Retrieves keyword data by scraping the search engine results pages (SERP) for a given keyword.
  • Input:
    • keywords (string[]): Array containing the requested keywords.

3. Site Explorer Tools

• get_domains_overview

  • Retrieves a comprehensive SEO performance summary for a specific domain.
  • Inputs:
    • input (string): Requested url, domain or root domain.
    • requested_data (string[]): Requested data for the given url or domain, corresponding to the content of different sections of the haloscan overview page.

• get_domains_positions

  • Retrieves the search engine ranking positions of a spe