🚀 Blogger Agent MCP & Motor de Generación de Contenido con IA

Blogger Agent MCP es un sistema multiagente autónomo basado en Google Agent Development Kit (ADK) y Gemini 3.5 Flash, diseñado para el análisis profundo de tendencias, búsqueda en vivo de hechos actuales en la web, construcción automática de rutas de viaje multipunto en Google Maps, redacción de artículos extensos de expertos, publicación de documentos en Google Docs y envío de correos electrónicos a través de Gmail.

🌟 Funcionalidades clave

• 🧠 Pipeline multiagente (Google ADK & Gemini 3.5 Flash): Uso de subagentes especializados BlogPlanner y BlogWriter bajo la gestión de un orquestador único Root Agent.

• 🌐 Búsqueda web en vivo en tiempo real (search_web): Anclaje de hechos (Grounding) a la fecha actual para prevenir alucinaciones y obsolescencia de datos del LLM.

• 🗺 Enrutador de Grand Tour (get_scenic_travel_route): Construcción de viajes por carretera complejos Punto A ➔ B ➔ C ➔ D con generación de mapas interactivos enlazables en Google Maps.

• 📈 Integración con Google Trends: Recopilación automática de tendencias clave ascendentes de la audiencia.

• 🔒 Autorización OAuth 2.0 delegada: Creación de archivos directamente en su Google Drive personal (API de Google Docs) y envío de mensajes desde su Gmail personal (API de Gmail).

• ☁️ Cloud Native y listo para Docker: Listo para un despliegue inmediato en Google Cloud Run, Docker y Dokploy.

Related MCP server: Universal Adapter

🏗 Arquitectura del pipeline

[Пользовательский Запрос]
        │
        ▼
[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)

⚙️ Variables de entorno (.env)

Cree un archivo .env en el directorio raíz del proyecto:

# Модель и регион 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

📦 Instalación rápida y ejecución local

1. Clonar el repositorio y crear el entorno virtual

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

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

2. Instalar dependencias

pip install -r requirements.txt

3. Autorización OAuth 2.0 (Ejecución única)

Para obtener su OAUTH_REFRESH_TOKEN duradero, ejecute el script de autorización:

python generate_oauth_token.py

Autorícese en el navegador que se abre con su cuenta de Google y copie el refresh_token obtenido en .env.

4. Ejecución local del agente

python agent.py

🐳 Despliegue en Docker / Dokploy / Cloud Run

1. Ejecución con Docker Compose

Cree docker-compose.yml:

version: '3.8'

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

Ejecute el contenedor:

docker compose up -d

2. Despliegue en 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. Despliegue en Dokploy

1. Cree una Aplicación en el panel de Dokploy.

2. En Tipo de compilación seleccione Dockerfile.

3. Complete las variables en la pestaña Entorno.

4. Haga clic en Desplegar.

📝 Licencia

Licencia MIT © 2026 Equipo de Blogger Agent MCP.