App Seo Ai

🚀 アプリケーションSEO AI

このアプリケーションは、SEOの自動化とAIによる最適化を行うためのもので、Google AdsキーワードプランナーAPIを統合しています。

🚀 クイックスタート

このアプリケーションは、SEOの自動化とAIによる最適化を行うためのもので、Google AdsキーワードプランナーAPIを統合しています。以下に、アプリケーションの使用方法を説明します。

✨ 主な機能

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

📦 インストール

前提条件

• 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統合

このプロジェクトには、AIアシスタントがAPIを使用できるように、MCP（モデルコンテキストプロトコル）が統合されています。MCPの設定は mcp.json ファイルにあります。

Smitheryと一緒に使用するには、以下の手順を実行します：

1. Smithery にアクセスする
2. 新しいMCPサーバーを作成する
3. app-seo-ai リポジトリを選択する
4. サーバー設定を構成する
5. サーバーをデプロイする

利用可能なMCPツール

• research_keywords - 与えられたテーマまたはシードキーワードに関連するキーワードを研究する
• analyze_serp - 特定のクエリの検索結果ページ（SERP）を分析する
• analyze_competitors - 与えられたキーワードまたはドメインの競合他社を分析する
• _health - ヘルスチェックエンドポイント

📄 ライセンス

MIT