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](https://smithery.ai/)
- 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 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
Analyze SERP
Analyze Competitors
License
MIT