🚀 应用 SEO AI
这是一款用于 SEO 自动化和 AI 驱动优化的应用程序，它集成了 Google Ads 关键词规划师 API，能有效助力 SEO 工作的开展。
🚀 快速开始
本应用可帮助用户利用 Google Ads API 进行关键词研究、分析搜索结果页面、开展竞争对手分析，并提供专业的 SEO 建议，还集成了 MCP 用于 AI 助手。
✨ 主要特性
- 使用 Google Ads API 进行关键词研究
- 分析搜索结果页面（SERP）
- 竞争对手分析
- 提供 SEO 建议
- 集成 MCP（模型上下文协议）用于 AI 助手
📦 安装指南
先决条件
- Node.js (v14 或更高版本)
- npm 或 yarn
- 带有 API 访问权限的 Google Ads 账户
- 启用 Google Ads API 的 Google Cloud Platform 项目
安装步骤
1. 克隆仓库
git clone https://github.com/ccnn2509/app-seo-ai.git
cd app-seo-ai
2. 安装依赖项
npm install
3. 配置环境变量
复制示例环境文件：
cp .env.example .env
编辑 .env 文件并填写您的 Google Ads API 凭证：
# 服务器配置
PORT=3000
NODE_ENV=development
# Google Ads API 配置
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 配置（可选）
SERP_API_KEY=your_serp_api_key
4. 获取 Google Ads API 刷新令牌
运行以下命令以获取刷新令牌：
npm run get-token
这将打开您的浏览器并引导您完成 OAuth2 认证流程。刷新令牌会自动保存到您的 .env 文件中。
5. 启动服务器
开发环境：
npm run dev
生产环境：
npm start
服务器将在您 .env 文件中指定的端口上运行（默认：3000）。
💻 使用示例
基础用法
研究关键词
// 示例请求以研究关键词
fetch('http://localhost:3000/api/keywords/ideas?keyword=seo%20tools&language=en')
.then(response => response.json())
.then(data => console.log(data));
分析 SERP
// 示例请求以分析 SERP
fetch('http://localhost:3000/api/serp/analyze?query=best%20seo%20tools&location=United%20States')
.then(response => response.json())
.then(data => console.log(data));
分析竞争者
// 示例请求以分析竞争者
fetch('http://localhost:3000/api/competitors/analyze?domain=example.com')
.then(response => response.json())
.then(data => console.log(data));
📚 详细文档
API 文档
API 文档在 /api-docs 路径下可用，当服务器运行时：
http://localhost:3000/api-docs
MCP 集成
该项目包含 MCP（模型上下文协议）集成，允许 AI 助手使用 API。MCP 的配置位于 mcp.json 文件中。
要与 Smithery 一起使用，请执行以下操作：
- 访问 Smithery
- 创建新的 MCP 服务器
- 选择
app-seo-ai仓库 - 配置服务器设置
- 部署服务器
可用的 MCP 工具
research_keywords- 研究与给定主题或种子关键词相关的关键词analyze_serp- 分析特定查询的搜索结果页面（SERP）analyze_competitors- 分析给定关键词或域名的竞争者_health- 健康检查端点
📄 许可证
MIT