SEO AI (Google Ads Keyword Planner)

by ccnn2509

6 stars

Not rated

GitHub

About

Integrates with Google Ads Keyword Planner API to enable SEO research, SERP analysis, and competitor analysis through a Node.js Express server deployable via Docker or Smithery.

Details

Author: ccnn2509
Repository: ccnn2509/app-seo-ai
GitHub stars: 6
Categories: Productivity, AI, Developer Tools, Search, Infrastructure, API
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name SEO AI (Google Ads Keyword Planner)

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

npm install

Copy the example environment file:

cp .env.example .env

Edit the .env file and fill in your Google Ads API credentials:


PORT=3000
NODE_ENV=development
GOOGLE_ADS_DEVELOPER_TOKEN=your_developer_token

GOOGLE_ADS_CLIENT_ID=your_client_id

GOOGLE_ADS_CLIENT_SECRET=your_client_secret

GOOGLE_ADS_REFRESH_TOKEN=your_refresh_token

GOOGLE_ADS_LOGIN_CUSTOMER_ID=your_customer_id_without_dashes
SERP_API_KEY=your_serp_api_key

`research_keywords`

Research keywords related to a given topic or seed keyword.

`analyze_serp`

Analyze a SERP (Search Engine Results Page) for a given query.

`analyze_competitors`

Analyze competitors for a given keyword or domain.

`_health`

Health check endpoint to verify the status of the application.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "seo ai (google ads keyword planner)": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

App SEO AI

Application for SEO automation and AI-powered optimization with Google Ads Keyword Planner integration.

Features

- Keyword research using Google Ads API
- SERP analysis
- Competitor analysis
- SEO recommendations
- MCP (Model Context Protocol) integration for AI assistants

Prerequisites

- Node.js (v14 or higher)
- npm or yarn
- Google Ads account with API access
- Google Cloud Platform project with Google Ads API enabled

Setup

1. Clone the repository

git clone https://github.com/ccnn2509/app-seo-ai.git
cd app-seo-ai

2. Install dependencies

npm install

3. Configure environment variables

Copy the example environment file:

cp .env.example .env

Edit the .env file and fill in your Google Ads API credentials:

# Server Configuration
PORT=3000
NODE_ENV=development
Google Ads API Configuration
GOOGLE_ADS_DEVELOPER_TOKEN=your_developer_token
GOOGLE_ADS_CLIENT_ID=your_client_id
GOOGLE_ADS_CLIENT_SECRET=your_client_secret
GOOGLE_ADS_REFRESH_TOKEN=your_refresh_token
GOOGLE_ADS_LOGIN_CUSTOMER_ID=your_customer_id_without_dashes
SERP API Configuration (optional)
SERP_API_KEY=your_serp_api_key

4. Get Google Ads API refresh token

Run the following command to get a refresh token:

npm run get-token

This will open your browser and guide you through the OAuth2 authentication process. The refresh token will be automatically saved to your .env file.

5. Start the server

For development:

npm run dev

For production:

npm start

The server will start on the port specified in your .env file (default: 3000).

API Documentation

API documentation is available at /api-docs when the server is running:

```

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

research_keywords

analyze_serp

analyze_competitors

_health

Claude Desktop / Cursor

Linux

Macos

Windows

App SEO AI

Features

Prerequisites

Setup

1. Clone the repository

2. Install dependencies

3. Configure environment variables

Google Ads API Configuration

SERP API Configuration (optional)

4. Get Google Ads API refresh token

5. Start the server

API Documentation

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`research_keywords`

`analyze_serp`

`analyze_competitors`

`_health`