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

: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.

content-optimizer-mcp