English Français العربية

io.github.sharozdawa/content-optimizer

Official registry Search and web

SERP-based content scoring and optimization with 7 SEO categories.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package content-optimizer-mcp
Claude Code 
claude mcp add content-optimizer -- npx -y content-optimizer-mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "content-optimizer": {
            "command": "npx",
            "args": [
                "-y",
                "content-optimizer-mcp@1.0.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Why Content Optimizer?
  2. :sparkles: Features
  3. :chart_with_upwards_trend: Scoring Categories
  4. :camera: Screenshots
  5. :rocket: Self-Hosting Setup
  6. :electric_plug: MCP Server
  7. :open_book: More Open Source SEO Tools
  8. :handshake: Contributing
  9. :page_facing_up: License

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

CategoryMax PointsWhat It Measures
Keyword Usage20Density, placement in first paragraph and headings
Word Count15Content length vs SERP average and target
Heading Structure15H1/H2/H3 hierarchy, count, keyword inclusion
Readability15Flesch-Kincaid score, grade level
Entity Coverage15Topic coverage vs SERP competitors
Content Depth10Paragraphs, lists, statistics, data points
Internal Structure10Introduction, 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
ToolDescription
score_contentScore content against a keyword across 7 categories (0-100)
analyze_keywordAnalyze SERP data — top 10 results with word counts, headings, topics
get_content_recommendationsGet prioritized improvement recommendations
check_readabilityFlesch-Kincaid score, grade level, sentence stats, reading time
find_missing_topicsFind topics from SERP competitors missing in your content
optimize_headingsAnalyze heading structure and suggest improvements

:open_book: More Open Source SEO Tools

ProjectDescription
Schema GeneratorGenerate structured data (JSON-LD) for any page — Product, Article, FAQ, HowTo, and more
AI VisibilityTrack how your brand appears in AI search engines (ChatGPT, Perplexity, Gemini)
IndexNow MCPInstantly notify search engines when you publish or update content
HumanPenAI 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

Frequently asked questions

What is io.github.sharozdawa/content-optimizer?

SERP-based content scoring and optimization with 7 SEO categories.

How do I install io.github.sharozdawa/content-optimizer?

It runs on your machine. In Claude Code: claude mcp add content-optimizer -- npx -y content-optimizer-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.sharozdawa/content-optimizer need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.sharozdawa/content-optimizer open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.sharozdawa/content-optimizer?

It is published by sharozdawa. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.