Skip to main content
Glama

SEO AI Assistant

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:

http://localhost:3000/api-docs

MCP Integration

This project includes MCP (Model Context Protocol) integration, allowing AI assistants to use the API. The MCP configuration is in the mcp.json file.

To use this with Smithery:

  1. Go to Smithery
  2. Create a new MCP server
  3. Select the app-seo-ai repository
  4. Configure the server settings
  5. Deploy the server

Available MCP Tools

  • 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

Example Usage

Research Keywords

// Example request to research keywords fetch('http://localhost:3000/api/keywords/ideas?keyword=seo%20tools&language=en') .then(response => response.json()) .then(data => console.log(data));

Analyze SERP

// Example request to analyze SERP fetch('http://localhost:3000/api/serp/analyze?query=best%20seo%20tools&location=United%20States') .then(response => response.json()) .then(data => console.log(data));

Analyze Competitors

// Example request to analyze competitors fetch('http://localhost:3000/api/competitors/analyze?domain=example.com') .then(response => response.json()) .then(data => console.log(data));

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Google Ads API 統合により、キーワード調査、SERP 分析、競合他社分析のツールを備えた SEO 自動化が提供され、AI アシスタントが MCP 経由でこれらの機能にアクセスできるようになります。

  1. 特徴
    1. 前提条件
      1. 設定
        1. 1. リポジトリをクローンする
        2. 2. 依存関係をインストールする
        3. 3. 環境変数を設定する
        4. 4. Google Ads APIのリフレッシュトークンを取得する
        5. 5. サーバーを起動する
      2. APIドキュメント
        1. MCP統合
          1. 利用可能なMCPツール
            1. 使用例
              1. 研究キーワード
              2. SERPを分析する
              3. 競合他社を分析する
            2. ライセンス

              Related MCP Servers

              • -
                security
                F
                license
                -
                quality
                MCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.
                Last updated -
                1
              • A
                security
                F
                license
                A
                quality
                An MCP-based service that analyzes user search keywords to determine their intent, providing classifications, reasoning, references, and search suggestions to support SEO analysis.
                Last updated -
                1
                49
                1
              • -
                security
                A
                license
                -
                quality
                A collection of custom MCP servers providing various AI-powered capabilities including web search, YouTube video analysis, GitHub repository analysis, reasoning, code generation/execution, and web crawling.
                Last updated -
                2
                MIT License
              • -
                security
                F
                license
                -
                quality
                An MCP server that enables interacting with Google's Indexing API, allowing agents to submit URLs to Google for indexing or removal from search results through natural language commands.
                Last updated -

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/ccnn2509/app-seo-ai'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server