SEO AI (Google Ads Keyword Planner)

🚀 アプリケーション SEO AI

SEOの自動化と人工知能による最適化を行うアプリケーションです。Google Adsのキーワード計画ツールを統合しています。

🚀 クイックスタート

このアプリケーションは、SEOの自動化と人工知能による最適化を行うためのものです。Google Adsのキーワード計画ツールを統合し、様々なSEO関連の機能を提供します。

✨ 主な機能

• Google広告APIを使用したキーワード研究
• 検索結果ページ（SERP）分析
• 競合他社分析
• SEO最適化提案
• AIアシスタント用のMCP（モデルコンテキストプロトコル）統合

📦 インストール

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）で起動します。

📚 ドキュメント

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 - ヘルスチェックエンドポイント

💻 使用例

キーワード研究

// キーワードを研究するためのサンプルリクエスト
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));

📄 ライセンス

MIT