social-media-automation/docs/CONTENT_RECYCLING.md

Reciclaje de Contenido

Sistema para republica contenido exitoso y maximizar su alcance.

Descripción

El reciclaje de contenido permite:

• Identificar posts con alto engagement
• Republicarlos con modificaciones opcionales
• Trackear rendimiento de versiones recicladas
• Automatizar el proceso de reciclaje

Modelo de Datos

RecycledPost

RecycledPost:
    id: int
    original_post_id: int (FK -> posts)
    new_post_id: int (FK -> posts)

    recycle_number: int  # 1, 2, 3... (veces reciclado)

    modifications: JSON
    # {"content_changed": true, "hashtags_updated": true, "image_changed": false}

    modification_notes: str

    original_engagement_rate: float
    new_engagement_rate: float

    status: str  # pending, published, cancelled
    reason: str  # high_performer, evergreen, seasonal, manual

    recycled_at: datetime
    scheduled_for: datetime

Campos en Post

# Campos añadidos al modelo Post
is_recyclable: bool  # Si puede ser reciclado (default True)
recycled_from_id: int (FK -> posts)  # Post original si es reciclado
recycle_count: int  # Veces que este post ha sido reciclado

Configuración

# En recycling_service.py
MIN_DAYS_SINCE_PUBLISH = 30  # No reciclar posts recientes
MIN_ENGAGEMENT_RATE = 2.0    # Mínimo 2% engagement
MAX_RECYCLE_COUNT = 3        # Máximo 3 veces por post

API Endpoints

GET /api/recycling/candidates

Obtiene posts candidatos para reciclar.

Parámetros:

• platform (str): Filtrar por plataforma
• content_type (str): Filtrar por tipo de contenido
• min_engagement_rate (float, default=2.0): Engagement mínimo
• min_days (int, default=30): Días desde publicación
• limit (int, default=20): Máximo candidatos

Respuesta:

{
    "candidates": [
        {
            "id": 123,
            "content": "Tip: Usa IA para automatizar...",
            "full_content": "...",
            "content_type": "tip_tech",
            "platforms": ["x"],
            "published_at": "2024-12-01T10:00:00",
            "days_since_publish": 58,
            "engagement_rate": 4.5,
            "recycle_count": 0,
            "score": 3.8,
            "metrics": {"likes": 150, "comments": 30}
        }
    ],
    "count": 10,
    "filters": {
        "min_engagement_rate": 2.0,
        "min_days": 30
    }
}

POST /api/recycling/{post_id}

Recicla un post específico.

Body (opcional):

{
    "content": "Versión actualizada del contenido...",
    "hashtags": ["#nuevo", "#hashtag"],
    "image_url": "https://...",
    "scheduled_for": "2025-02-01T10:00:00",
    "platforms": ["x", "threads"],
    "reason": "high_performer"
}

Respuesta:

{
    "message": "Post recycled successfully",
    "success": true,
    "new_post_id": 456,
    "recycle_record_id": 1,
    "scheduled_for": "2025-02-01T10:00:00",
    "platforms": ["x", "threads"]
}

POST /api/recycling/auto

Reciclaje automático de mejores posts.

Parámetros:

• platform (str, opcional): Plataforma específica
• count (int, default=1, max=5): Cantidad a reciclar
• min_engagement_rate (float, default=2.0)

Respuesta:

{
    "success": true,
    "recycled": 2,
    "posts": [
        {
            "original_id": 123,
            "new_post_id": 456,
            "engagement_rate": 4.5
        }
    ]
}

GET /api/recycling/history

Obtiene historial de reciclaje.

Parámetros:

• original_post_id (int, opcional): Filtrar por post original
• limit (int, default=50)

POST /api/recycling/{post_id}/disable

Marca un post como no reciclable.

Sistema de Puntuación

Los candidatos se puntúan con la fórmula:

score = engagement_rate * recency_factor * recycled_penalty

donde:
  recency_factor = min(days_since_publish / 90, 1.0)
  recycled_penalty = 1 - (recycle_count * 0.2)

Ejemplo

Post	Engagement	Días	Reciclajes	Score
A	4.0%	60	0	4.0 × 0.67 × 1.0 = 2.68
B	5.0%	90	1	5.0 × 1.0 × 0.8 = 4.00
C	3.0%	45	0	3.0 × 0.5 × 1.0 = 1.50

Post B tiene el score más alto.

Tareas Programadas

auto_recycle_content

• Frecuencia: Diario a las 2:00 AM
• Función:
  • Busca 1 post por plataforma con engagement > 3%
  • Programa reciclaje automático
• Plataformas: x, threads

Flujo de Reciclaje

1. Identificar Candidatos
   - Posts con > 30 días de antigüedad
   - Engagement rate > 2%
   - recycle_count < 3
   - is_recyclable = true
        ↓
2. Seleccionar por Score
   - Ordenar por score descendente
        ↓
3. Crear Post Reciclado
   - Clonar contenido (o modificar)
   - Establecer recycled_from_id
   - Programar publicación
        ↓
4. Registrar en RecycledPost
   - Guardar relación
   - Incrementar recycle_count del original
        ↓
5. Publicar y Trackear
   - Comparar new_engagement_rate vs original

Razones de Reciclaje

Razón	Descripción
high_performer	Post con engagement alto
evergreen	Contenido atemporal relevante
seasonal	Contenido de temporada que regresa
manual	Reciclado manualmente

Ejemplo de Uso

from app.services.recycling_service import recycling_service

# Buscar candidatos
candidates = await recycling_service.find_recyclable_posts(
    platform="x",
    min_engagement_rate=3.0,
    limit=10
)

for candidate in candidates:
    print(f"Post {candidate['id']}: {candidate['engagement_rate']}% - Score {candidate['score']}")

# Reciclar manualmente
result = await recycling_service.recycle_post(
    post_id=123,
    modifications={"content": "Versión actualizada..."},
    reason="evergreen"
)

# Reciclaje automático
result = await recycling_service.auto_recycle(
    platform="x",
    count=2
)

Mejores Prácticas

1. Esperar suficiente tiempo: Mínimo 30 días entre reciclajes
2. Modificar ligeramente: Actualiza hashtags o intro
3. No abusar: Máximo 3 reciclajes por post
4. Monitorear: Compara rendimiento nuevo vs original
5. Contenido evergreen: Prioriza contenido atemporal

Tipos de Contenido Ideales para Reciclar

Tipo	Ideal	Razón
Tips técnicos	✅	Siempre relevantes
Tutoriales	✅	Valor educativo permanente
Productos	⚠️	Si stock disponible
Promociones	❌	Fechas específicas
Efemérides	❌	Fechas específicas
Noticias	❌	Se vuelven obsoletas