Content Optimizer README

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

bash

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

Development

Terminal

npm run dev

Open http://localhost:3000.

Production Build

Terminal

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:

config.json

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

Cursor

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

config.json

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

Build from Source

bash

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