io.github.sharozdawa/content-optimizer

Why Content Optimizer?

Paid content optimization tools charge $89-$170/month for SERP-based scoring. Content Optimizer gives you the same analysis — for free, self-hosted, and extensible.

:sparkles: Features

:dart: Content Scoring — Score content 0-100 across 7 SEO categories with per-category breakdowns

:mag: SERP Analysis — Analyze top-ranking pages for word count, headings, and topic benchmarks

:abc: Readability Analysis — Flesch-Kincaid scoring, grade level, sentence length, reading time

:bookmark_tabs: Heading Optimization — Detect hierarchy issues, suggest keyword-rich heading structure

:brain: Entity Coverage — Find topics competitors cover that you're missing

:clipboard: Actionable Recommendations — Prioritized improvements ranked by impact

:robot: MCP Server — Use with Claude Desktop, Cursor, or any MCP-compatible AI tool

:chart_with_upwards_trend: Scoring Categories

:camera: Screenshots

:rocket: Self-Hosting Setup

Prerequisites

• Node.js 18+
• npm 9+

Installation

git clone https://github.com/sharozdawa/content-optimizer.git
cd content-optimizer
npm install

Development

npm run dev

Open http://localhost:3000.

Production Build

npm run build
npm start

:electric_plug: MCP Server

The MCP server lets you use Content Optimizer directly inside AI coding tools like Claude Desktop and Cursor.

Install via npx

No setup required — just add the config:

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "content-optimizer": {
      "command": "npx",
      "args": ["-y", "content-optimizer-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "content-optimizer": {
      "command": "npx",
      "args": ["-y", "content-optimizer-mcp"]
    }
  }
}

Build from Source

cd mcp-server
npm install
npm run build

Then use node ./mcp-server/dist/index.js as the command in your MCP config.

MCP Tools

:open_book: More Open Source SEO Tools

:handshake: Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

:page_facing_up: License

MIT — see LICENSE for details.