X Algorithm MCP

⚡ X Algorithm Toolkit

Pontue, otimize e gere tweets usando os pesos reais dos sinais do algoritmo de recomendação open-source do X.

🧠 O Que Isso Faz

Este toolkit faz engenharia reversa do algoritmo de recomendação do X a partir do código-fonte aberto e oferece a você:

• Pontuador de Tweets — Pontue qualquer rascunho (0-100) com base nos pesos reais do algoritmo
• Analisador de Ganchos — Teste sua linha de abertura contra a penalidade de -11× not_dwelled
• Calculadora de Diversidade — Planeje a cadência de postagens usando a fórmula de decaimento de author_diversity_scorer.rs
• Verificador de 18 Filtros — Execute tweets pelos portões de qualidade/segurança
• Reescrita com IA, Geração e Construtor de Threads — IA multi-provedor (Groq, Gemini, OpenAI, Claude)
• Gerenciador de Rascunhos, Modo de Comparação, Histórico de Pontuações — Ferramentas completas de fluxo de trabalho
• Exportar Scorecard — Downloads de PNG com marca

📊 Os 22 Sinais do Algoritmo

De weighted_scorer.rs + ranking_scorer.rs:

Sinal	Peso	O Que Significa
Resposta	27.0×	Sinal nº 1 — termine cada post com uma pergunta
Favoritar	10.0×	Conteúdo digno de salvar recebe um grande impulso
Seguir	4.0×	"Quero mais" — o sinal de carreira
Tempo de Leitura (Binário)	2.0×	Posts com várias linhas ganham mais tempo de leitura
Tempo de Leitura Contínuo	1.5×	Leituras mais longas pontuam mais alto
Tempo de Clique-Leitura	1.5×	Interesse profundo após expandir
Denunciar	-369×	Penalidade nuclear — o conteúdo se torna invisível
Não Tenho Interesse	-74×	Fora do assunto = morte algorítmica
Rolou Para Passar	-11×	Ganchos fracos acionam isso

+ 13 sinais adicionais (Curtir, Repostar, Citar, Clique em Citação, Compartilhar, Compartilhar por DM, Copiar Link, Clique, Clique no Perfil, Expandir Foto, Visualização de Vídeo em Qualidade)

---

🚀 Início Rápido

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

# Install & Run
npm install
npm run dev

Abra http://localhost:5173 — nenhuma chave de API é necessária para pontuação, filtros e análise.

Para recursos de IA (Reescrita, Geração, Thread), adicione uma chave de API nas Configurações (nível gratuito do Groq recomendado).

---

🔧 Servidor MCP (npm)

Instale o servidor MCP para conectar o mecanismo do algoritmo a qualquer assistente de IA:

Opção 1: Via npx (Recomendado)

Adicione ao claude_desktop_config.json:

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

Opção 2: Instalação Global

npm install -g x-algorithm-mcp

Opção 3: A Partir do Código-Fonte

cd mcp && npm install && npm run build

11 Ferramentas: 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

---

🎯 Habilidade de IA (Antigravity / Gemini CLI)

Mais de 400 linhas de conhecimento especializado que tornam qualquer IA uma especialista no algoritmo do X:

Instalar Globalmente

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

O Que Está Coberto:

• Todos os 22 pesos de sinais com estratégias de otimização
• Arquitetura de transformador Phoenix baseada em Grok
• Mais de 77 categorias de tópicos de topic_ids_filter.rs
• Sistema de pontuação de 10 pontos com notas por letras
• Regras de escrita de ganchos e 7 modelos
• Fórmula de decaimento de diversidade de autores
• Mecânicas virais OON
• Estratégia de construção de threads (6 modelos)
• Checklist de 18 filtros de segurança
• Otimização por nicho (7 nichos)

---

📁 Arquitetura

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

🛠️ Pilha Tecnológica

• Frontend: React 19, TypeScript, Vite
• Animações: Framer Motion
• IA: Multi-provedor (Groq/Gemini/OpenAI/Claude)
• MCP: @modelcontextprotocol/sdk v1.12+
• Armazenamento: localStorage (sem necessidade de backend)

📜 Licença

MIT — Criado por @Mr_Chartist

---

Dados provenientes do algoritmo open-source do X: weighted_scorer.rs, ranking_scorer.rs, author_diversity_scorer.rs, oon_scorer.rs, topic_ids_filter.rs, recsys_model.py