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.