SEO AI (Google Ads Keyword Planner)

🚀 應用 SEO AI

一款用於 SEO 自動化和人工智能優化的應用，集成了 Google Ads 關鍵詞計劃工具，能有效助力網站進行 SEO 優化，提升搜索排名。

🚀 快速開始

本應用可幫助您進行 SEO 自動化和人工智能優化，集成了 Google Ads 關鍵詞計劃工具，為您的網站 SEO 工作提供便利。

✨ 主要特性

• 使用 Google 廣告 API 進行關鍵詞研究，精準定位熱門關鍵詞。
• 搜索結果頁面 (SERP) 分析，瞭解搜索結果情況。
• 競爭對手分析，掌握競爭對手動態。
• 提供 SEO 優化建議，助力網站優化。
• MCP（模型上下文協議）集成用於 AI 助手，拓展應用功能。

📦 安裝指南

先決條件

• Node.js（v14 或更高版本）
• npm 或 yarn
• 帶有 API 訪問權限的 Google 廣告賬戶
• 啟用了 Google 廣告 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 廣告 API 憑證：

# 服務器配置
PORT=3000
NODE_ENV=development

# Google 廣告 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 廣告 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 許可證。