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 | :white_check_mark: | :x: | :x: | :x: |
| Open source | :white_check_mark: | :x: | :x: | :x: |
| Content scoring | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Keyword analysis | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Readability analysis | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| Heading optimization | :white_check_mark: | :white_check_mark: | :white_check_mark: | :x: |
| Entity/topic coverage | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| MCP server | :white_check_mark: | :x: | :x: | :x: |
| AI editor integration | :white_check_mark: | :x: | :x: | :x: |
| API access | :white_check_mark: | Paid add-on | :x: | Paid add-on |
| No data limits | :white_check_mark: | Credits-based | Credits-based | Credits-based |
: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
| 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 |
:camera: Screenshots
Screenshots coming soon — the web UI is under active development.
: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
| 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 |
:open_book: More Open Source SEO Tools
| 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 |
:handshake: Contributing
Contributions are welcome! See CONTRIBUTING.md for guidelines.
:page_facing_up: License
MIT — see LICENSE for details.
Built by Sharoz Dawa
