X Algorithm MCP

⚡ X Algorithm Toolkit

Puntúa, optimiza y genera tweets usando los pesos de señal reales del algoritmo de recomendación de código abierto de X.

🧠 Qué Hace Esto

Este toolkit replica el algoritmo de recomendación de X a partir del código abierto y te ofrece:

• Puntuador de Tweets — Puntúa cualquier borrador (0-100) según los pesos reales del algoritmo
• Analizador de Ganchos — Prueba tu primera línea contra la penalización de -11× not_dwelled
• Calculadora de Diversidad — Planifica la cadencia de publicación usando la fórmula de decaimiento de author_diversity_scorer.rs
• Verificador de 18 Filtros — Pasa los tweets por los filtros de calidad y seguridad
• Reescritura, Generación y Constructor de Hilos con IA — IA multiproveedor (Groq, Gemini, OpenAI, Claude)
• Gestor de Borradores, Modo Comparar, Historial de Puntuaciones — Herramientas de flujo de trabajo completas
• Exportar Tarjeta de Puntuación — Descargas PNG con marca

📊 Las 22 Señales del Algoritmo

De weighted_scorer.rs + ranking_scorer.rs:

Señal	Peso	Qué Significa
Respuesta	27.0×	Señal #1 — termina cada publicación con una pregunta
Marcador	10.0×	El contenido digno de guardar recibe un gran impulso
Seguir	4.0×	"Quiero más" — la señal de carrera
Permanencia (Binaria)	2.0×	Las publicaciones multilínea generan más tiempo de lectura
Tiempo de Permanencia Cont.	1.5×	Las lecturas más largas puntúan más alto
Tiempo de Clic-Permanencia	1.5×	Interés profundo después de expandir
Reportar	-369×	Penalización nuclear — el contenido se vuelve invisible
No Interesado	-74×	Fuera de tema = muerte algorítmica
Desplazado	-11×	Los ganchos débiles activan esto

+ 13 señales más (Me Gusta, Repost, Cita, Clic en Cita, Compartir, Compartir por DM, Copiar Enlace, Clic, Clic en Perfil, Expandir Foto, Vista de Video en Calidad)

---

🚀 Inicio Rápido

# Clone
git clone https://github.com/MrChartist/x-algorithm-toolkit.git
cd x-algorithm-toolkit

# Install & Run
npm install
npm run dev

Abre http://localhost:5173 — no se necesita clave API para puntuación, filtros y análisis.

Para funciones de IA (Reescritura, Generación, Hilos), añade una clave API en Configuración (se recomienda el nivel gratuito de Groq).

---

🔧 Servidor MCP (npm)

Instala el servidor MCP para conectar el motor del algoritmo a cualquier asistente de IA:

Opción 1: Vía npx (Recomendado)

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "x-algorithm": {
      "command": "npx",
      "args": ["-y", "x-algorithm-mcp"]
    }
  }
}

Opción 2: Instalación Global

npm install -g x-algorithm-mcp

Opción 3: Desde el Código Fuente

cd mcp && npm install && npm run build

11 Herramientas: score_tweet, check_filters, analyze_hook, get_signals, get_optimal_schedule, compare_tweets, detect_spam_patterns, diversity_penalty, classify_niche, get_thread_strategy, full_audit

3 Recursos: x-algorithm://weights, x-algorithm://filters, x-algorithm://niches

---

🎯 Habilidad de IA (Antigravity / Gemini CLI)

Más de 400 líneas de experiencia de dominio que convierten a cualquier IA en un experto del algoritmo de X:

Instalación Global

mkdir -p ~/.gemini/antigravity/skills/x-algorithm-expert
curl -o ~/.gemini/antigravity/skills/x-algorithm-expert/SKILL.md \
  https://raw.githubusercontent.com/MrChartist/x-algorithm-toolkit/master/skill/SKILL.md

Lo Que Cubre:

• Los 22 pesos de señal con estrategias de optimización
• Arquitectura transformadora Phoenix basada en Grok
• Más de 77 categorías de temas de topic_ids_filter.rs
• Sistema de puntuación de 10 puntos con calificaciones por letras
• Reglas de escritura de ganchos y 7 plantillas
• Fórmula de decaimiento de diversidad de autores
• Mecánica viral OON
• Estrategia de construcción de hilos (6 plantillas)
• Lista de verificación de 18 filtros de seguridad
• Optimización por nicho (7 nichos)

---

📁 Arquitectura

x-algo-toolkit/
├── src/                    # React Web App (13 tabs)
│   ├── engine/             # Scoring engine + AI abstraction
│   └── components/         # 15 UI components
├── mcp/                    # MCP Server (11 tools, 3 resources)
│   ├── src/                # TypeScript source
│   ├── dist/               # Compiled output
│   └── package.json        # npm: x-algorithm-mcp
├── skill/                  # AI Skill
│   └── SKILL.md            # 400+ line expertise file
└── public/                 # Static assets

🛠️ Stack Tecnológico

• Frontend: React 19, TypeScript, Vite
• Animaciones: Framer Motion
• IA: Multiproveedor (Groq/Gemini/OpenAI/Claude)
• MCP: @modelcontextprotocol/sdk v1.12+
• Almacenamiento: localStorage (sin backend necesario)

📜 Licencia

MIT — Creado por @Mr_Chartist

---

Datos obtenidos del algoritmo de código abierto de X: weighted_scorer.rs, ranking_scorer.rs, author_diversity_scorer.rs, oon_scorer.rs, topic_ids_filter.rs, recsys_model.py