Content Optimizer

io.github.sharozdawaPublished by GitHub account sharozdawav1.0.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

A local MCP server that scores and optimizes web content against search results, with SEO recommendations across seven categories.

What you can do
Score content against a target keyword across seven SEO categories with a 0-100 breakdown per category and prioritized improvement recommendations, plus readability checks (Flesch-Kincaid, grade level, sentence stats, reading time). Analyze SERP data for top-ranking pages, including word counts, headings and topic benchmarks, and find topics competitors cover that your content is missing. Review heading structure and get suggested keyword-rich heading improvements.
When to use it
Useful when drafting or revising SEO articles and you want an assistant to benchmark a draft against top-ranking pages, spot missing topics, and get concrete scoring and readability feedback without a paid subscription tool.
Requirements
Runs locally over stdio via npx from the npm package content-optimizer-mcp; Node.js 18+ and npm 9+ are needed. No authentication, environment variables or headers are declared. SERP analysis implies network access to fetch search results.
Before you install
The tools analyze content you provide, so drafts and keywords are sent to whatever search source the server queries for SERP data; review what it contacts before using confidential material. No credentials or payments are declared.

Installation

In SourceWeft

  1. Open Content Optimizer in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Image]

SERP-based content scoring, entity analysis, and actionable SEO recommendations.
Score your content against top-ranking pages. Know exactly what to improve.

[npm] [stars] [license] [PRs Welcome] [Content Optimizer MCP server]

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.

FeatureContent OptimizerSurfer SEOClearscopeFrase
PriceFree$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-basedCredits-basedCredits-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

bash
git clone https://github.com/sharozdawa/content-optimizer.gitcd content-optimizernpm install

Development

bash
npm run dev

Open http://localhost:3000.

Production Build

bash
npm run buildnpm 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:

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

Cursor

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

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

Build from Source

bash
cd mcp-servernpm installnpm 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
[GitHub]

[Image]

Source: README.md at commit 96a551a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts