SERP-based content scoring, entity analysis, and actionable SEO recommendations.
Score your content against top-ranking pages. Know exactly what to improve.
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.
| Feature | Content Optimizer | Surfer SEO | Clearscope | Frase |
|---|
| Price | Free | $89/mo | $170/mo | $15/mo |
| Self-hosted | ✅ | ❌ | ❌ | ❌ |
| Open source | ✅ | ❌ | ❌ | ❌ |
| Content scoring | ✅ | ✅ | ✅ | ✅ |
| Keyword analysis | ✅ | ✅ | ✅ | ✅ |
| Readability analysis | ✅ | ✅ | ✅ | ✅ |
| Heading optimization | ✅ | ✅ | ✅ | ❌ |
| Entity/topic coverage | ✅ | ✅ | ✅ | ✅ |
| MCP server | ✅ | ❌ | ❌ | ❌ |
| AI editor integration | ✅ | ❌ | ❌ | ❌ |
| API access | ✅ | Paid add-on | ❌ | Paid add-on |
| No data limits | ✅ | Credits-based | Credits-based | Credits-based |
✨ Features
🎯 Content Scoring — Score content 0-100 across 7 SEO categories with per-category breakdowns
🔍 SERP Analysis — Analyze top-ranking pages for word count, headings, and topic benchmarks
🔤 Readability Analysis — Flesch-Kincaid scoring, grade level, sentence length, reading time
📑 Heading Optimization — Detect hierarchy issues, suggest keyword-rich heading structure
🧠 Entity Coverage — Find topics competitors cover that you're missing
📋 Actionable Recommendations — Prioritized improvements ranked by impact
🤖 MCP Server — Use with Claude Desktop, Cursor, or any MCP-compatible AI tool
📈 Scoring Categories
| Category | Max Points | What It Measures |
|---|
| Keyword Usage | 20 | Density, placement in first paragraph and headings |
| Word Count | 15 | Content length vs SERP average and target |
| Heading Structure | 15 | H1/H2/H3 hierarchy, count, keyword inclusion |
| Readability | 15 | Flesch-Kincaid score, grade level |
| Entity Coverage | 15 | Topic coverage vs SERP competitors |
| Content Depth | 10 | Paragraphs, lists, statistics, data points |
| Internal Structure | 10 | Introduction, conclusion, logical flow |
| 100 | |
📷 Screenshots
Screenshots coming soon — the web UI is under active development.
🚀 Self-Hosting Setup
Prerequisites
Installation
git clone https://github.com/sharozdawa/content-optimizer.git
cd content-optimizer
npm install
Development
Open http://localhost:3000.
Production Build
🔌 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.
| Tool | Description |
|---|
score_content | Score content against a keyword across 7 categories (0-100) |
analyze_keyword | Analyze SERP data — top 10 results with word counts, headings, topics |
get_content_recommendations | Get prioritized improvement recommendations |
check_readability | Flesch-Kincaid score, grade level, sentence stats, reading time |
find_missing_topics | Find topics from SERP competitors missing in your content |
optimize_headings | Analyze heading structure and suggest improvements |
| Project | Description |
|---|
| Schema Generator | Generate structured data (JSON-LD) for any page — Product, Article, FAQ, HowTo, and more |
| AI Visibility | Track how your brand appears in AI search engines (ChatGPT, Perplexity, Gemini) |
| IndexNow MCP | Instantly notify search engines when you publish or update content |
| HumanPen | AI content humanizer — make AI-generated text sound natural |
🤝 Contributing
Contributions are welcome! See CONTRIBUTING.md for guidelines.
📄 License
MIT — see LICENSE for details.
Built by Sharoz Dawa
