Enables keyword research and analysis using Google Ads Keyword Planner API, allowing users to discover related keywords and their metrics for SEO optimization
Integrates with Google Cloud Platform for authentication and API access to Google Ads services, requiring a GCP project with Google Ads API enabled
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
2. Install dependencies
3. Configure environment variables
Copy the example environment file:
Edit the .env
file and fill in your Google Ads API credentials:
4. Get Google Ads API refresh token
Run the following command to get a refresh 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:
For production:
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:
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:
- Go to Smithery
- Create a new MCP server
- Select the
app-seo-ai
repository - Configure the server settings
- Deploy the server
Available MCP Tools
research_keywords
- Research keywords related to a given topic or seed keywordanalyze_serp
- Analyze a SERP (Search Engine Results Page) for a given queryanalyze_competitors
- Analyze competitors for a given keyword or domain_health
- Health check endpoint
Example Usage
Research Keywords
Analyze SERP
Analyze Competitors
License
MIT
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Provides SEO automation with tools for keyword research, SERP analysis, and competitor analysis through Google Ads API integration, enabling AI assistants to access these capabilities via MCP.
Related MCP Servers
- -securityAlicense-qualityProvides Google search capabilities, web content extraction, and screenshot functionality with advanced bot detection avoidance through the MCP protocol.Last updated -435TypeScriptMIT License
- -securityFlicense-qualityMCP 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 -
- AsecurityFlicenseAqualityAn 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 -16811JavaScript
- -securityAlicense-qualityA 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 -2PythonMIT License