Search Visibility Augmentation Platform (SVAP)

An advanced application engineered for automated SEO lifecycle management and intelligent content enhancement, deeply integrated with the Google Ads Keyword Planner ecosystem.

Core Functionalities

• Keyword Ideation & Sourcing: Leveraging the Google Ads API for exhaustive keyword universe exploration.
• SERP Landscape Assessment: Deep-dive analysis of current Search Engine Results Pages.
• Competitive Intelligence Gathering: Systematic comparison against market rivals.
• Actionable Optimization Directives: Generation of precise, evidence-based SEO recommendations.
• Model Context Protocol (MCP) Interoperability: Seamless connection points for advanced AI assistant utilization.

Operational Prerequisites

• Runtime Environment: Node.js (version 14 or newer).
• Package Manager: npm or yarn.
• Credentials: Valid Google Ads account access with requisite API permissions.
• Cloud Setup: Configured Google Cloud Platform project enabling the Google Ads API service.

Deployment Procedure

1. Source Code Retrieval

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

2. Dependency Ingestion

npm install

3. Environmental Configuration

Duplicate the template configuration file:

cp .env.example .env

Modify the .env file, populating placeholders with your Google Ads API authorization parameters:

# Server Operational Settings
PORT=3000
NODE_ENV=development

# Google Ads API Authorization Details
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 Data Acquisition Key (Optional)
SERP_API_KEY=your_serp_api_key

4. Refresh Token Acquisition

Execute the token retrieval utility:

npm run get-token

This action initiates a browser session for OAuth2 credential exchange, subsequently persisting the resulting refresh token within the .env configuration.

5. Service Initiation

To launch for iterative development:

npm run dev

For live production deployment:

npm start

The application instance will commence operation on the port defined in your environment file (default: 3000).

Interface Specification (API Documentation)

Comprehensive interface documentation is accessible via the /api-docs endpoint once the server is active:

http://localhost:3000/api-docs

MCP Interoperability Framework

This release incorporates native MCP (Model Context Protocol) capabilities, enabling external autonomous agents to leverage the exposed functionalities. The specific MCP configuration schema resides in mcp.json.

Integration guidance for the Smithery ecosystem:

1. Navigate to Smithery
2. Establish a novel MCP server instance.
3. Designate the app-seo-ai repository as the source.
4. Finalize the server environment specifications.
5. Execute the deployment sequence.

Exposed MCP Tool Set

• research_keywords: Generates keyword suggestions predicated on a thematic input or starting keyword.
• analyze_serp: Performs an analytical breakdown of the Search Engine Results Page results for a specified search query.
• analyze_competitors: Benchmarks performance metrics against established competitors for a given keyword or domain entity.
• _health: Endpoint for verifying system operational status.

Functional Demonstration (Code Snippets)

Keyword Discovery Example

// Sample invocation for keyword universe exploration
fetch('http://localhost:3000/api/keywords/ideas?keyword=seo%20tools&language=en')
  .then(response => response.json())
  .then(data => console.log(data));

SERP Examination Example

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

Competitive Profiling Example

// Sample invocation for competitor assessment
fetch('http://localhost:3000/api/competitors/analyze?domain=example.com')
  .then(response => response.json())
  .then(data => console.log(data));

Licensing Agreement

MIT License