io.github.sharozdawa/content-optimizer

SERP-based content scoring and optimization with 7 SEO categories.
Open source Open in the app JSON README (API)
About

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

Kind: MCP servers
Topic: Marketing & analytics
Publisher: sharozdawa
Origin: official
Category: ferramentas
Transport: local
Version: 1.0.0
Last push: 2026-03-22T09:30:11Z
Repository state: ativo
Language: TypeScript
License: MIT
Added: 2026-08-29 04:01:23
Updated: 2026-08-29 04:01:23
Origin id: io.github.sharozdawa/content-optimizer
README

<p align="center">
  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:22c55e,100:16a34a&height=200&section=header&text=Content%20Optimizer&fontSize=50&fontColor=ffffff&animation=fadeIn&fontAlignY=35&desc=Open%20Source%20Alternative%20to%20Surfer%20SEO&descSize=18&descAlignY=55&descColor=ffffff" width="100%" />
</p>

<p align="center">
  <strong>SERP-based content scoring, entity analysis, and actionable SEO recommendations.</strong><br />
  Score your content against top-ranking pages. Know exactly what to improve.
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/content-optimizer-mcp"><img src="https://img.shields.io/npm/v/content-optimizer-mcp?color=22c55e&label=mcp%20server" alt="npm" /></a>
  <a href="https://github.com/sharozdawa/content-optimizer/stargazers"><img src="https://img.shields.io/github/stars/sharozdawa/content-optimizer?style=flat&color=22c55e" alt="stars" /></a>
  <a href="https://github.com/sharozdawa/content-optimizer/blob/main/LICENSE"><img src="https://img.shields.io/github/license/sharozdawa/content-optimizer?color=22c55e" alt="license" /></a>
  <a href="https://github.com/sharozdawa/content-optimizer/pulls"><img src="https://img.shields.io/badge/PRs-welcome-22c55e" alt="PRs Welcome" /></a>
  <a href="https://glama.ai/mcp/servers/sharozdawa/content-optimizer"><img src="https://glama.ai/mcp/servers/sharozdawa/content-optimizer/badges/score.svg" alt="Content Optimizer MCP server" /></a>
</p>

---

## 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

<p align="center">
  <em>Screenshots coming soon — the web UI is under active development.</em>
</p>

---

## :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

```bash
npm run dev
```

Open [http://localhost:3000](http://localhost:3000).

### Production Build

```bash
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`:

```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-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](https://github.com/sharozdawa/schema-gen)** | Generate structured data (JSON-LD) for any page — Product, Article, FAQ, HowTo, and more |
| **[AI Visibility](https://github.com/sharozdawa/ai-visibility)** | Track how your brand appears in AI search engines (ChatGPT, Perplexity, Gemini) |
| **[IndexNow MCP](https://github.com/sharozdawa/indexnow-mcp)** | Instantly notify search engines when you publish or update content |
| **[HumanPen](https://github.com/sharozdawa/humanpen)** | AI content humanizer — make AI-generated text sound natural |

---

## :handshake: Contributing

Contributions are welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.

---

## :page_facing_up: License

MIT — see [LICENSE](./LICENSE) for details.

---

<p align="center">
  Built by <a href="https://github.com/sharozdawa"><strong>Sharoz Dawa</strong></a>
  <br />
  <a href="https://github.com/sharozdawa"><img src="https://img.shields.io/github/followers/sharozdawa?label=Follow&style=social" alt="GitHub" /></a>
</p>

<p align="center">
  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:22c55e,100:16a34a&height=120&section=footer" width="100%" />
</p>