Content Optimizer MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add content-optimizer -- npx -y content-optimizer-mcp
README.md

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": {
      "comma

Tools (2)

analyze_contentScores content against top-ranking pages across 7 SEO categories including keyword usage, word count, and readability.
get_serp_benchmarksRetrieves benchmarks for word count, headings, and topic coverage from top-ranking pages.

Configuration

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

Try it

Analyze my draft article about 'sustainable gardening' and provide a content score.
What are the SERP benchmarks for the keyword 'best mechanical keyboards'?
How can I improve the heading structure of my current blog post to better match top-ranking pages?
Identify missing entities in my content compared to the top 3 search results for 'remote work tips'.

Frequently Asked Questions

What are the key features of Content Optimizer?

Content scoring 0-100 across 7 SEO categories. SERP analysis for word count, headings, and topic benchmarks. Readability analysis including Flesch-Kincaid scoring. Heading optimization for hierarchy and keyword inclusion. Entity coverage analysis to identify missing topics.

What can I use Content Optimizer for?

Optimizing blog posts to rank higher in search engine results. Improving content readability for specific target audiences. Refining heading structures for better SEO and logical flow. Identifying content gaps by comparing drafts against top-ranking competitors.

How do I install Content Optimizer?

Install Content Optimizer by running: npx -y content-optimizer-mcp

What MCP clients work with Content Optimizer?

Content Optimizer works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Content Optimizer docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare