App Seo Ai

🚀 應用 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 許可證。