🚀 应用 SEO AI

应用 SEO AI 是一款用于 SEO 自动化和 AI 驱动优化的应用程序，它集成了 Google Ads 关键词规划师 API，能够助力用户高效开展 SEO 工作。

🚀 快速开始

应用 SEO AI 借助 Google Ads API 等技术，为用户提供关键词研究、搜索结果页面分析、竞争对手分析等功能，并给出专业的 SEO 建议。以下是使用该应用的快速指南：

1. 确保满足先决条件（如安装 Node.js、npm 或 yarn 等）。
2. 按照安装步骤完成项目的克隆、依赖安装、环境变量配置等操作。
3. 启动服务器后，即可通过 API 进行关键词研究、SERP 分析等操作。

✨ 主要特性

• 关键词研究：使用 Google Ads API 进行关键词研究，精准挖掘相关关键词。
• SERP 分析：深入分析搜索结果页面（SERP），了解页面排名情况。
• 竞争对手分析：对竞争对手进行全面分析，掌握市场动态。
• SEO 建议提供：根据分析结果，为用户提供专业的 SEO 建议。
• MCP 集成：集成 MCP（模型上下文协议），方便 AI 助手使用 API。

📦 安装指南

先决条件

• 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 一起使用，请执行以下操作：

1. 访问 Smithery
2. 创建新的 MCP 服务器
3. 选择 app-seo-ai 仓库
4. 配置服务器设置
5. 部署服务器

可用的 MCP 工具

• research_keywords - 研究与给定主题或种子关键词相关的关键词
• analyze_serp - 分析特定查询的搜索结果页面（SERP）
• analyze_competitors - 分析给定关键词或域名的竞争者
• _health - 健康检查端点

📄 许可证

本项目采用 MIT 许可证。