Haloscan

You can access Haloscan SEO data and perform advanced keyword and site analysis through an MCP server. This setup lets you drive Haloscan tools from MCP-compatible clients, enabling automation, prompts, and streamlined workflows for SEO tasks.

How to use

To use the Haloscan MCP server with an MCP client, connect your client to the local or remote MCP endpoint and start issuing tool requests for keyword research, site analytics, and related SEO data. The server exposes a wide range of keywords and domain analysis tools that you can invoke from your automation flows or chat-like assistants.

If you are using Claude Desktop or a similar MCP client, configure your client to run the server via a standard MCP command. The following NPX configuration starts the Haloscan MCP server and passes your API key safely through the environment.

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

How to install

Prerequisites: Node.js (and npm or npx) must be installed on your system. Ensure you have a Haloscan account and a generated API key before starting.

Install and start the MCP server using the provided NPX command. The command runs the server without needing to install a global package.

Step-by-step commands you can run in your terminal:

# Ensure you have Node.js and npm/yarn installed
node -v
npm -v

# Start the Haloscan MCP server via NPX
npx -y @occirank/haloscan-server start

Available tools

get_user_credit

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

get_keywords_overview

Retrieves an overview of a specific keyword with metrics like search volume, competition, and trends.

get_keywords_match

Provides keyword data for an exact match search, including performance details in search results.

get_keywords_similar

Returns a list of keywords that are semantically similar to the given keyword.

get_keywords_highlights

Extracts key performance highlights for a given keyword.

get_keywords_related

Lists keywords contextually related to the given keyword.

get_keywords_questions

Retrieves question-based keywords related to the given keyword.

get_keywords_synonyms

Returns synonyms related to the given keyword.

get_keywords_find

Compiles comprehensive data for a keyword or keywords including volume, competition, and trends.

get_keywords_site_structure

Fetches the site structure data for a domain including keyword associations and metadata.

get_keywords_serp_compare

Compares SERP data for two or more keywords over a selected period.

get_keywords_serp_availableDates

Provides available historical SERP dates for a keyword.

get_keywords_serp_pageEvolution

Shows evolution of SERP rankings for a keyword over time for a specific URL.

get_keywords_bulk

Retrieves keyword data for multiple keywords in a single bulk request.

get_keywords_scrap

Scrapes SERP data to gather keyword metrics for multiple keywords.

get_domains_overview

Provides a comprehensive SEO performance summary for a domain.

get_domains_positions

Shows the search ranking positions of a domain for specified keywords.

get_domains_top_pages

Retrieves top-performing pages for a domain based on organic metrics.

get_domains_history_positions

Fetches historical ranking positions for a domain across keywords.

get_domains_history_pages

Retrieves historical performance data for the top pages of a domain.

get_page_best_keywords

Finds top keywords driving traffic to a specific URL.

get_domains_keywords

Lists all keywords a domain ranks for along with metrics.

get_domains_bulk

Gathers SEO metrics for multiple domains in one request.

get_domains_competitors

Lists organic competitors for a domain based on overlapping keywords.

get_domains_competitors_keywords_diff

Compares keyword differences between a domain and its competitors.

get_domains_competitors_best_pages

Retrieves best-performing pages of competitors for a domain.

get_domains_competitors_keywords_best_positions

Shows best-ranking keywords for a domain versus its competitors.

get_domains_visibility_trends

Fetches visibility trends for a domain over time.

get_domains_expired

Tracks domain visibility trends including expired domains.