<p align="center"><img src="logo.png" width="120" alt="logo"></p>

SEO Analyzer API

⭐ Building in public from $0 MRR. Star if you want to follow the journey — lazymac-mcp (42 tools, one MCP install) · lazymac-k-mcp (Korean wedge) · lazymac-sdk (TS client) · api.lazy-mac.com · Pro $29/mo.

🚀 Want all 42 lazymac tools through ONE MCP install? npx -y @lazymac/mcp · Pro $29/mo for unlimited calls.

Analyze any webpage for SEO scores, issues, and actionable recommendations. No external API keys needed — just pass a URL.

Features

• Overall SEO Score (0-100) with letter grade (A-F)
• 12 analysis categories: title, meta description, headings, images, links, Open Graph, technical SEO, Schema.org, content quality, and more
• Side-by-side comparison of two URLs
• MCP server for AI assistant integration
• Zero external dependencies — uses only HTML parsing via cheerio

Quick Start

npm install
npm start
# Server runs on http://localhost:3400

API Endpoints

GET /api/v1/analyze

curl "http://localhost:3400/api/v1/analyze?url=https://example.com"

POST /api/v1/analyze

curl -X POST http://localhost:3400/api/v1/analyze \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

POST /api/v1/compare

curl -X POST http://localhost:3400/api/v1/compare \
  -H "Content-Type: application/json" \
  -d '{"url1": "https://github.com", "url2": "https://gitlab.com"}'

Response Example

{
  "url": "https://example.com",
  "overallScore": 72,
  "grade": "C",
  "scores": {
    "title": 100,
    "metaDescription": 0,
    "headings": 60,
    "images": 100,
    "links": 70,
    "openGraph": 0,
    "technical": 76,
    "schema": 0,
    "content": 30
  },
  "summary": {
    "totalIssues": 6,
    "issues": ["..."],
    "recommendations": ["..."]
  }
}

MCP Server

Use as an MCP tool in Claude Desktop, Cursor, or any MCP-compatible client:

{
  "mcpServers": {
    "seo-analyzer": {
      "command": "node",
      "args": ["/path/to/seo-analyzer-api/src/mcp-server.js"]
    }
  }
}

Tools:

• analyze_seo — Full SEO analysis of a single URL
• compare_seo — Compare two URLs side by side

Docker

docker build -t seo-analyzer-api .
docker run -p 3400:3400 seo-analyzer-api

Analysis Categories

Category	Weight	What it checks
Title	15%	Presence, length (30-60 chars), duplicates
Meta Description	10%	Presence, length (120-160 chars)
Headings	10%	H1 presence/uniqueness, hierarchy, nesting
Images	8%	Alt text presence on all images
Links	7%	Internal/external ratio, broken hrefs
Open Graph	10%	og:title, og:description, og:image, og:url, og:type, Twitter cards
Technical	20%	Viewport, canonical, lang, charset, favicon, HTML size, resource count
Schema.org	10%	JSON-LD, Microdata, RDFa structured data
Content	10%	Word count, reading time

License

MIT

Related projects

• 🧰 lazymac-mcp — Single MCP server exposing 15+ lazymac APIs as tools for Claude Code, Cursor, Windsurf
• ✅ lazymac-api-healthcheck-action — Free GitHub Action to ping any URL on a cron and fail on non-2xx
• 🌐 api.lazy-mac.com — 36+ developer APIs, REST + MCP, free tier

_{💡 Host your own stack? <a href="https://m.do.co/c/c8c07a9d3273">Get $200 DigitalOcean credit</a> via lazymac referral link.}