English Français العربية

io.github.sharozdawa/content-optimizer

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.sharozdawa/content-optimizer؟

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

كيف أثبّت io.github.sharozdawa/content-optimizer؟

يعمل على جهازك. في Claude Code: claude mcp add content-optimizer -- npx -y content-optimizer-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.sharozdawa/content-optimizer إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.sharozdawa/content-optimizer مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.sharozdawa/content-optimizer؟

ينشره sharozdawa. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.