🚀 Blogger Agent MCP & AI Content Generation Engine

Blogger Agent MCP ist ein autonomes Multi-Agenten-System basierend auf Google Agent Development Kit (ADK) und Gemini 3.5 Flash, das für die tiefgehende Trendanalyse, die Live-Suche aktueller Fakten im Web, die automatische Erstellung von Mehrpunkt-Reiserouten in Google Maps, das Verfassen von Experten-Longreads, die Veröffentlichung von Dokumenten in Google Docs und den E-Mail-Versand über Gmail konzipiert ist.

🌟 Wichtigste Funktionen

• 🧠 Multi-Agent-Pipeline (Google ADK & Gemini 3.5 Flash): Verwendung spezialisierter Sub-Agenten BlogPlanner und BlogWriter unter der Steuerung eines einheitlichen Orchestrators Root Agent.

• 🌐 Live-Websuche in Echtzeit (search_web): Verankerung von Fakten (Grounding) auf das aktuelle Datum, um Halluzinationen und Veraltung von LLM-Daten zu verhindern.

• 🗺 Grand-Tour-Router (get_scenic_travel_route): Erstellung komplexer Autoreisen Punkt A ➔ B ➔ C ➔ D mit Generierung anklickbarer interaktiver Karten in Google Maps.

• 📈 Google Trends Integration: Automatische Erfassung aufstrebender wichtiger Publikumstrends.

• 🔒 Delegierte OAuth 2.0-Autorisierung: Erstellung von Dateien direkt auf Ihrem persönlichen Google Drive (Google Docs API) und Versand von Nachrichten von Ihrer persönlichen Gmail (Gmail API).

• ☁️ Cloud Native & Docker Ready: Bereit zur sofortigen Bereitstellung in Google Cloud Run, Docker und Dokploy.

Related MCP server: Universal Adapter

🏗 Pipeline-Architektur

[Пользовательский Запрос]
        │
        ▼
[Root Agent (Blogger)]
        │
        ├──> 1. Trends Analysis (get_google_trends / pytrends)
        │
        ├──> 2. Live Web Search (search_web / DDGS Grounding)
        │
        ├──> 3. Scenic Route Planner (get_scenic_travel_route / Places & Routes API)
        │
        ├──> 4. Outline Generation (Sub-Agent: BlogPlanner)
        │
        ├──> 5. Full Article Generation (Sub-Agent: BlogWriter)
        │
        └──> 6. Export & Delivery
                 ├── Google Drive / Docs API (save_to_google_drive)
                 ├── Google Cloud Storage Backup (save_to_cloud_storage)
                 └── Gmail API Dispatch (send_article_email)

⚙️ Umgebungsvariablen (.env)

Erstellen Sie eine Datei .env im Wurzelverzeichnis des Projekts:

# Модель и регион Google Cloud Vertex AI
MODEL=gemini-3.5-flash
GOOGLE_CLOUD_LOCATION=global
GOOGLE_GENAI_USE_VERTEXAI=TRUE

# Ключ Google Maps Platform API
GOOGLE_MAPS_API_KEY=AIzaSyYourGoogleMapsApiKeyHere12345

# Хранилище Google Cloud Storage
GCS_BUCKET_NAME=your-gcs-bucket-name

# OAuth 2.0 Desktop Credentials (для личного Google Диска и Gmail)
OAUTH_CLIENT_ID=123456789012-yourclientid.apps.googleusercontent.com
OAUTH_CLIENT_SECRET=GOCSPX-yourClientSecretHere123456
OAUTH_REFRESH_TOKEN=1//04yourRefreshTokenHere_abcdefghijklmnopqrstuvwxyz

# Email для уведомлений
NOTIFICATION_EMAIL=your_email@gmail.com

📦 Schnelle Installation und lokaler Start

1. Repository klonen und venv erstellen

git clone https://github.com/your-username/bloggeragentmcp.git
cd bloggeragentmcp

python3 -m venv .venv
source .venv/bin/activate

2. Abhängigkeiten installieren

pip install -r requirements.txt

3. OAuth 2.0-Autorisierung (Einmaliger Start)

Um Ihren dauerhaften OAUTH_REFRESH_TOKEN zu erhalten, führen Sie das Autorisierungsskript aus:

python generate_oauth_token.py

Autorisieren Sie sich im geöffneten Browser mit Ihrem Google-Konto und kopieren Sie das erhaltene refresh_token in die .env-Datei.

4. Lokaler Start des Agents

python agent.py

🐳 Ausrollen in Docker / Dokploy / Cloud Run

1. Start über Docker Compose

Erstellen Sie docker-compose.yml:

version: '3.8'

services:
  blogger-agent:
    build: .
    container_name: blogger_agent
    restart: always
    ports:
      - "8080:8080"
    env_file:
      - .env

Starten Sie den Container:

docker compose up -d

2. Deployment in Google Cloud Run

gcloud run deploy bloggeragentmcpv03 \
  --source . \
  --region us-east1 \
  --allow-unauthenticated \
  --set-secrets="OAUTH_REFRESH_TOKEN=oauth-refresh-token:latest" \
  --set-env-vars GOOGLE_GENAI_USE_VERTEXAI=TRUE,MODEL="gemini-3.5-flash",GOOGLE_CLOUD_LOCATION="global",GCS_BUCKET_NAME="your-gcs-bucket-name",NOTIFICATION_EMAIL="your_email@gmail.com"

3. Deployment in Dokploy

1. Erstellen Sie eine Application im Dokploy-Dashboard.

2. Wählen Sie bei Build Type Dockerfile.

3. Füllen Sie die Variablen im Reiter Environment aus.

4. Klicken Sie auf Deploy.

*** n

📝 Lizenz

MIT License © 2026 Blogger Agent MCP Team.