reactor

Reactor — LinkedIn Post Performance Predictor

What it does

Predicts LinkedIn post performance using calibrated heuristics trained on real data. Returns:

• Verdict: GO / WAIT / IMPROVE / NO
• Estimated impressions (calibrated to real post data)
• Debate score (0-100) — controversy drives the algorithm
• Hook score (0-1) — first-line effectiveness
• Cringe score (0-100) — LinkedIn cringe detection
• Authenticity score (0-100) — does it sound human?
• Timing multiplier — based on audience timezone distribution
• Warnings — specific problems ("Algorithm death: debate <30")
• Improvements — actionable suggestions

Quick Start

Option 1: Direct API calls (no install needed)

# Predict a post
curl -X POST https://reactor-api.keugenek.workers.dev/v1/predict \
  -H "Content-Type: application/json" \
  -d '{"post": "Your LinkedIn post text here"}'

# Discover all available endpoints
curl https://reactor-api.keugenek.workers.dev/v1/discover

# List content types with viral multipliers
curl https://reactor-api.keugenek.workers.dev/v1/content-types

Option 2: CLI

npx @keugenek/reactor "Your post text"
npx @keugenek/reactor --register [email protected]   # 5/day free
npx @keugenek/reactor --types                     # content types

Option 3: MCP Server (Claude Desktop / Cursor)

{
  "mcpServers": {
    "reactor": {
      "command": "npx",
      "args": ["@keugenek/reactor", "--mcp"],
      "env": { "REACTOR_API_KEY": "rk_free_xxx" }
    }
  }
}

How to use (for AI agents)

Predicting a post

When the user shares a LinkedIn post draft or asks "should I post this?":

1. Call POST /v1/predict with the post text
2. Present the verdict prominently (GO = post it, NO = rewrite)
3. If debate score < 30, warn: "Algorithm death zone — no debate = no reach"
4. Suggest improvements from the response
5. If rate limited, offer to register (ask consent first!)

Before predicting, ask the user:

1. How many LinkedIn followers do you have? (default: 1000)
2. What's your audience? (currently: Tech Leaders & Engineers; Custom Audience coming in Pro)