🚀 DataForSEO API Gateway PRO ELITE

API Gateway profesional y escalable para DataForSEO con Next.js 15, TypeScript, rate limiting, caching y analytics. Listo para producción en auditoria.fascinantedigital.com

✨ Características Principales

🔐 Seguridad Avanzada

Autenticación dual: API Keys + JWT
Rate limiting por IP y usuario
Headers de seguridad automáticos
CORS configurado
Validación de requests con Zod

⚡ Performance Optimizada

Caching inteligente con Redis + fallback a memoria
Compresión automática
CDN ready para Vercel
Edge Runtime compatible
Response time < 1 segundo

📊 Monitoreo Profesional

Analytics en tiempo real
Logging estructurado con Winston
Health checks automáticos
Métricas de performance y costos
Error tracking completo

🛠️ Stack Tecnológico

Framework: Next.js 15 (App Router)
Lenguaje: TypeScript 5.0
Styling: Tailwind CSS
Caching: Redis + Memory
Auth: JWT + API Keys
Deploy: Vercel + Docker
CI/CD: GitHub Actions

🚀 Inicio Rápido

1. Clonar el Repositorio

git clone https://github.com/alexanderovie/fascinante-dataforseo-gateway.git
cd fascinante-dataforseo-gateway

2. Instalar Dependencias

pnpm install

3. Configurar Variables de Entorno

cp env.local.example .env.local

Editar .env.local con tus credenciales:

# DataForSEO API Configuration
DATAFORSEO_USERNAME=[email protected]
DATAFORSEO_PASSWORD=your-password
DATAFORSEO_BASE_URL=https://api.dataforseo.com

# API Gateway Configuration
API_GATEWAY_SECRET=your-super-secret-api-key
JWT_SECRET=your-jwt-secret
JWT_EXPIRES_IN=24h

# Redis Configuration (opcional)
REDIS_URL=redis://localhost:6379
REDIS_PASSWORD=

# Analytics
ENABLE_ANALYTICS=true
LOG_LEVEL=info

4. Ejecutar en Desarrollo

pnpm dev

5. Probar la API

# Health check
curl http://localhost:3000/api/health

# Documentación
curl http://localhost:3000/api/docs

# Generar contenido AI
curl -H "X-API-Key: your-api-key" \
  -X POST http://localhost:3000/api/v3/ai_optimization/chat_gpt/llm_responses/live \
  -H "Content-Type: application/json" \
  -d '[{"user_prompt": "Escribe un título SEO para mi negocio", "model_name": "gpt-4o-mini"}]'

📚 Documentación de la API

Endpoints Principales

Endpoint	Método	Descripción
`/api/health`	GET	Health check del sistema
`/api/docs`	GET	Documentación OpenAPI 3.1.0
`/api/v3/ai_optimization/chat_gpt/llm_responses/models`	GET	Modelos AI disponibles
`/api/v3/ai_optimization/chat_gpt/llm_responses/live`	POST	Generar contenido AI
`/api/v3/serp/google/organic/live/advanced`	POST	Análisis SERP
`/api/v3/keywords_data/google_ads/search_volume/live`	POST	Volumen de búsqueda

Autenticación

API Key (Recomendado)

curl -H "X-API-Key: your-api-key" \
  http://localhost:3000/api/v3/ai_optimization/chat_gpt/llm_responses/models

JWT Token

curl -H "Authorization: Bearer your-jwt-token" \
  http://localhost:3000/api/v3/ai_optimization/chat_gpt/llm_responses/models

Ejemplos de Uso

1. Generar Contenido SEO

curl -H "X-API-Key: your-api-key" \
  -X POST http://localhost:3000/api/v3/ai_optimization/chat_gpt/llm_responses/live \
  -H "Content-Type: application/json" \
  -d '[{
    "user_prompt": "Escribe un título SEO para una empanadería llamada El Empanadazo",
    "model_name": "gpt-4o-mini",
    "max_output_tokens": 200,
    "temperature": 0.3
  }]'

2. Análisis SERP

curl -H "X-API-Key: your-api-key" \
  -X POST http://localhost:3000/api/v3/serp/google/organic/live/advanced \
  -H "Content-Type: application/json" \
  -d '[{
    "keyword": "empanadas artesanales",
    "location_name": "United States",
    "language_code": "en",
    "depth": 10
  }]'

3. Volumen de Búsqueda

curl -H "X-API-Key: your-api-key" \
  -X POST http://localhost:3000/api/v3/keywords_data/google_ads/search_volume/live \
  -H "Content-Type: application/json" \
  -d '[{
    "keywords": ["empanadas", "empanadas artesanales", "empanadas caseras"],
    "location_name": "United States",
    "language_code": "en"
  }]'

🚀 Despliegue

Vercel (Recomendado)

# Instalar Vercel CLI
npm i -g vercel

# Desplegar
vercel --prod

Docker

# Construir imagen
docker build -t fascinante-dataforseo-gateway .

# Ejecutar contenedor
docker run -p 3000:3000 \
  -e DATAFORSEO_USERNAME=your-email \
  -e DATAFORSEO_PASSWORD=your-password \
  -e API_GATEWAY_SECRET=your-secret \
  fascinante-dataforseo-gateway

Configuración de Dominio

Configurar DNS para auditoria.fascinantedigital.com
Actualizar vercel.json con el dominio
Configurar SSL automático

📊 Monitoreo y Analytics

Métricas Disponibles

Requests por minuto/hora
Costo total de DataForSEO
Tiempo de respuesta promedio
Rate limiting hits
Cache hit ratio
Errores por endpoint

Logs Estructurados

{
  "level": "info",
  "message": "DataForSEO Request: POST /v3/ai_optimization/chat_gpt/llm_responses/live",
  "timestamp": "2025-09-06T22:00:43.000Z",
  "service": "fascinante-dataforseo-gateway",
  "userId": "user-123",
  "endpoint": "/v3/ai_optimization/chat_gpt/llm_responses/live",
  "responseTime": 992,
  "cost": 0.0006177
}

🧪 Testing

Ejecutar Tests

# Test completo del gateway
./test-gateway.sh

# Test específico de endpoints
curl -H "X-API-Key: your-api-key" \
  http://localhost:3000/api/health | jq .

Resultados de Pruebas

✅ Health Check: 200 OK
✅ Documentación: OpenAPI disponible
✅ AI Models: 33 modelos disponibles
✅ AI Generation: Contenido generado correctamente
✅ SERP Analysis: Análisis funcionando
✅ Rate Limiting: Configurado y activo
✅ Caching: Redis + Memory funcionando

🔧 Configuración Avanzada

Rate Limiting

API_RATE_LIMIT_PER_MINUTE=200
API_RATE_LIMIT_BURST=50

Caching

REDIS_URL=redis://localhost:6379
CACHE_TTL_DEFAULT=3600
CACHE_TTL_AI=1800
CACHE_TTL_SERP=7200

Logging

LOG_LEVEL=debug
ENABLE_ANALYTICS=true

📈 Roadmap

Webhook support para notificaciones
Dashboard de métricas en tiempo real
Multi-tenant support
API versioning automático
GraphQL endpoint
WebSocket para updates en tiempo real

🤝 Contribuir

Fork el repositorio
Crear feature branch (git checkout -b feature/amazing-feature)
Commit cambios (git commit -m 'Add amazing feature')
Push al branch (git push origin feature/amazing-feature)
Abrir Pull Request

📄 Licencia

Este proyecto está bajo la Licencia MIT. Ver LICENSE para más detalles.

🆘 Soporte

Documentación: OpenAPI Docs
Issues: GitHub Issues
Email: [email protected]

Desarrollado con ❤️ por Fascinante Digital

API Gateway PRO ELITE para DataForSEO - Next.js 15, TypeScript, Rate Limiting, Caching, Analytics

Name		Name	Last commit message	Last commit date
Latest commit History 40 Commits
.github/workflows		.github/workflows
app		app
cloudflared		cloudflared
lib		lib
openapi		openapi
scripts		scripts
terraform		terraform
tests		tests
.context-config.json		.context-config.json
.context-memory.json		.context-memory.json
.dockerignore		.dockerignore
.elite-config.json		.elite-config.json
.env.local.backup		.env.local.backup
.env.local.oauth-backup		.env.local.oauth-backup
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.meta-config.json		.meta-config.json
.prettierrc		.prettierrc
CLOUDFLARE_ELITE_SETUP.md		CLOUDFLARE_ELITE_SETUP.md
CONTEXT-SYSTEM.md		CONTEXT-SYSTEM.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
ELITE-SYSTEM-IMPLEMENTED.md		ELITE-SYSTEM-IMPLEMENTED.md
ENV-CONFIG-UPDATE-GUIDE.md		ENV-CONFIG-UPDATE-GUIDE.md
GPT-ACTIONS-IMPLEMENTATION-GUIDE.md		GPT-ACTIONS-IMPLEMENTATION-GUIDE.md
LICENSE		LICENSE
META-ECOSYSTEM-IMPLEMENTED.md		META-ECOSYSTEM-IMPLEMENTED.md
OAUTH-SETUP-COMPLETE.md		OAUTH-SETUP-COMPLETE.md
PROJECT_SUMMARY.md		PROJECT_SUMMARY.md
README.md		README.md
SISTEMA-MEMORIA-IMPLEMENTADO.md		SISTEMA-MEMORIA-IMPLEMENTADO.md
TEST_RESULTS.md		TEST_RESULTS.md
chatgpt-gpt-schema-completo.json		chatgpt-gpt-schema-completo.json
chatgpt-gpt-schema-funcionando.json		chatgpt-gpt-schema-funcionando.json
chatgpt-gpt-schema-minimalista.json		chatgpt-gpt-schema-minimalista.json
chatgpt-gpt-schema-optimizado.json		chatgpt-gpt-schema-optimizado.json
chatgpt-gpt-schema-pagespeed.json		chatgpt-gpt-schema-pagespeed.json
chatgpt-gpt-schema-simple.json		chatgpt-gpt-schema-simple.json
chatgpt-gpt-schema.json		chatgpt-gpt-schema.json
create-oauth-client.sh		create-oauth-client.sh
dataforseo-automation.py		dataforseo-automation.py
dataforseo-config.example.json		dataforseo-config.example.json
dataforseo-httpie-scripts.sh		dataforseo-httpie-scripts.sh
domain-setup.md		domain-setup.md
ejemplo-fascinante-digital-serp.md		ejemplo-fascinante-digital-serp.md
ejemplo-on-page-uso.md		ejemplo-on-page-uso.md
ejemplo-request-body-correcto.md		ejemplo-request-body-correcto.md
endpoints-funcionando-resumen.md		endpoints-funcionando-resumen.md
env-config-organized.txt		env-config-organized.txt
env-gpt-actions-additions.txt		env-gpt-actions-additions.txt
env.example		env.example
env.local.example		env.local.example
env.production.example		env.production.example
esquema-corregido-resumen.md		esquema-corregido-resumen.md
esquema-final-funcionando.md		esquema-final-funcionando.md
esquema-minimalista-resumen.md		esquema-minimalista-resumen.md
esquemas-finales-resumen.md		esquemas-finales-resumen.md
infrastructure-context.md		infrastructure-context.md
keywords-example.txt		keywords-example.txt
middleware.ts		middleware.ts
next-env.d.ts		next-env.d.ts
next.config.mjs		next.config.mjs
package.json		package.json
pagespeed-insights-resumen.md		pagespeed-insights-resumen.md
pnpm-lock.yaml		pnpm-lock.yaml
postcss.config.js		postcss.config.js
setup.sh		setup.sh
solucion-chatgpt-optimizada.md		solucion-chatgpt-optimizada.md
tailwind.config.js		tailwind.config.js
test-gateway.sh		test-gateway.sh
tsconfig.json		tsconfig.json
vercel.json.backup		vercel.json.backup

License

alexanderovie/fascinante-dataforseo-gateway

Folders and files

Latest commit

History

Repository files navigation