{
  "markdown": "<p align=\"center\">\n  <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%\" />\n</p>\n\n<p align=\"center\">\n  <strong>SERP-based content scoring, entity analysis, and actionable SEO recommendations.</strong><br />\n  Score your content against top-ranking pages. Know exactly what to improve.\n</p>\n\n<p align=\"center\">\n  <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>\n  <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>\n  <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>\n  <a href=\"https://github.com/sharozdawa/content-optimizer/pulls\"><img src=\"https://img.shields.io/badge/PRs-welcome-22c55e\" alt=\"PRs Welcome\" /></a>\n  <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>\n</p>\n\n---\n\n## Why Content Optimizer?\n\nPaid content optimization tools charge $89-$170/month for SERP-based scoring. Content Optimizer gives you the same analysis — **for free, self-hosted, and extensible**.\n\n| Feature | Content Optimizer | Surfer SEO | Clearscope | Frase |\n|---------|:-:|:-:|:-:|:-:|\n| **Price** | **Free** | $89/mo | $170/mo | $15/mo |\n| **Self-hosted** | :white_check_mark: | :x: | :x: | :x: |\n| **Open source** | :white_check_mark: | :x: | :x: | :x: |\n| **Content scoring** | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |\n| **Keyword analysis** | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |\n| **Readability analysis** | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |\n| **Heading optimization** | :white_check_mark: | :white_check_mark: | :white_check_mark: | :x: |\n| **Entity/topic coverage** | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |\n| **MCP server** | :white_check_mark: | :x: | :x: | :x: |\n| **AI editor integration** | :white_check_mark: | :x: | :x: | :x: |\n| **API access** | :white_check_mark: | Paid add-on | :x: | Paid add-on |\n| **No data limits** | :white_check_mark: | Credits-based | Credits-based | Credits-based |\n\n---\n\n## :sparkles: Features\n\n:dart: **Content Scoring** — Score content 0-100 across 7 SEO categories with per-category breakdowns\n\n:mag: **SERP Analysis** — Analyze top-ranking pages for word count, headings, and topic benchmarks\n\n:abc: **Readability Analysis** — Flesch-Kincaid scoring, grade level, sentence length, reading time\n\n:bookmark_tabs: **Heading Optimization** — Detect hierarchy issues, suggest keyword-rich heading structure\n\n:brain: **Entity Coverage** — Find topics competitors cover that you're missing\n\n:clipboard: **Actionable Recommendations** — Prioritized improvements ranked by impact\n\n:robot: **MCP Server** — Use with Claude Desktop, Cursor, or any MCP-compatible AI tool\n\n---\n\n## :chart_with_upwards_trend: Scoring Categories\n\n| Category | Max Points | What It Measures |\n|----------|:---------:|------------------|\n| **Keyword Usage** | 20 | Density, placement in first paragraph and headings |\n| **Word Count** | 15 | Content length vs SERP average and target |\n| **Heading Structure** | 15 | H1/H2/H3 hierarchy, count, keyword inclusion |\n| **Readability** | 15 | Flesch-Kincaid score, grade level |\n| **Entity Coverage** | 15 | Topic coverage vs SERP competitors |\n| **Content Depth** | 10 | Paragraphs, lists, statistics, data points |\n| **Internal Structure** | 10 | Introduction, conclusion, logical flow |\n| | **100** | |\n\n---\n\n## :camera: Screenshots\n\n<p align=\"center\">\n  <em>Screenshots coming soon — the web UI is under active development.</em>\n</p>\n\n---\n\n## :rocket: Self-Hosting Setup\n\n### Prerequisites\n\n- Node.js 18+\n- npm 9+\n\n### Installation\n\n```bash\ngit clone https://github.com/sharozdawa/content-optimizer.git\ncd content-optimizer\nnpm install\n```\n\n### Development\n\n```bash\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000).\n\n### Production Build\n\n```bash\nnpm run build\nnpm start\n```\n\n---\n\n## :electric_plug: MCP Server\n\nThe MCP server lets you use Content Optimizer directly inside AI coding tools like Claude Desktop and Cursor.\n\n### Install via npx\n\nNo setup required — just add the config:\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"content-optimizer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"content-optimizer-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"content-optimizer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"content-optimizer-mcp\"]\n    }\n  }\n}\n```\n\n### Build from Source\n\n```bash\ncd mcp-server\nnpm install\nnpm run build\n```\n\nThen use `node ./mcp-server/dist/index.js` as the command in your MCP config.\n\n### MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `score_content` | Score content against a keyword across 7 categories (0-100) |\n| `analyze_keyword` | Analyze SERP data — top 10 results with word counts, headings, topics |\n| `get_content_recommendations` | Get prioritized improvement recommendations |\n| `check_readability` | Flesch-Kincaid score, grade level, sentence stats, reading time |\n| `find_missing_topics` | Find topics from SERP competitors missing in your content |\n| `optimize_headings` | Analyze heading structure and suggest improvements |\n\n---\n\n## :open_book: More Open Source SEO Tools\n\n| Project | Description |\n|---------|-------------|\n| **[Schema Generator](https://github.com/sharozdawa/schema-gen)** | Generate structured data (JSON-LD) for any page — Product, Article, FAQ, HowTo, and more |\n| **[AI Visibility](https://github.com/sharozdawa/ai-visibility)** | Track how your brand appears in AI search engines (ChatGPT, Perplexity, Gemini) |\n| **[IndexNow MCP](https://github.com/sharozdawa/indexnow-mcp)** | Instantly notify search engines when you publish or update content |\n| **[HumanPen](https://github.com/sharozdawa/humanpen)** | AI content humanizer — make AI-generated text sound natural |\n\n---\n\n## :handshake: Contributing\n\nContributions are welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\n\n---\n\n## :page_facing_up: License\n\nMIT — see [LICENSE](./LICENSE) for details.\n\n---\n\n<p align=\"center\">\n  Built by <a href=\"https://github.com/sharozdawa\"><strong>Sharoz Dawa</strong></a>\n  <br />\n  <a href=\"https://github.com/sharozdawa\"><img src=\"https://img.shields.io/github/followers/sharozdawa?label=Follow&style=social\" alt=\"GitHub\" /></a>\n</p>\n\n<p align=\"center\">\n  <img src=\"https://capsule-render.vercel.app/api?type=waving&color=0:22c55e,100:16a34a&height=120&section=footer\" width=\"100%\" />\n</p>\n",
  "bytes": 7294,
  "sha": "20a8bb083f65ae02f13b00b89a14ea8bcd64adcff8da340fc4211798867836b4",
  "repo_slug": "sharozdawa/content-optimizer",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sharozdawa_content_optimizer_087a63b0/readme"
}