Stop Googling SEO metrics. Let your AI pull them directly.

MCP Server Node TypeScript License Tools GA4 Search Console

Rank tracking, Google Analytics, site audits, keyword research, competitive analysis, Core Web Vitals, and a research-backed scoring system — all accessible through natural language or CLI.

Why This Exists

You: "Where do we rank for 'best mcp servers' and how's our traffic this month?"
Claude: Let me check... [calls rank_check + analytics_overview]
 Rankings:
 - "best mcp servers" → #7 (up from #12 last week)
 - "mcp server tools" → #3
 Traffic (last 28 days):
 - Sessions: 4,231 (+18% vs previous period)
 - Top source: Organic Search (62%)
 - Bounce rate: 34% (good)

If You Only Try 3 Things, Try These

The 8 Arms (23 Tools)

Arm 1: Rank Tracking

Arm 2: Google Analytics (GA4)

Arm 3: SEO Auditing

Arm 4: Keyword Research

Arm 5: Competitive Analysis

Arm 6: Performance & Core Web Vitals

Arm 7: OctoScore

Arm 8: Reports

Quick Start (2 Minutes)

# 1. Clone and install
git clone https://github.com/itsjwill/seoctopus.git
cd seoctopus
npm install
# 2. Build
npm run build
# 3. Install browser for rank tracking
npx playwright install chromium

Add to Claude as MCP Server

{
 "mcpServers": {
 "seoctopus": {
 "command": "node",
 "args": ["/path/to/seoctopus/dist/index.js"]
 }
 }
}

Want Google Analytics + Search Console too?

# One-time OAuth2 setup (requires Google Cloud project)
npx seoctopus auth setup -c /path/to/credentials.json

Where Should I Start?

OctoScore — The SEO Rating System

CLI Usage

# Check where you rank
seoctopus rank check "best seo tools" "mcp server" -d example.com
# Full page audit
seoctopus audit page https://example.com
# Content analysis with keyword targeting
seoctopus audit content https://example.com -k "target keyword"
# Core Web Vitals check
seoctopus perf cwv https://example.com
# Keyword opportunities from Search Console
seoctopus keywords gaps -s https://example.com
# Generate HTML report
seoctopus report https://example.com -f html -o report.html
# Calculate OctoScore
seoctopus score https://example.com -k "target keyword"
# Competitor deep dive
seoctopus compete analyze "target keyword" -u https://yoursite.com

How It's Built

seoctopus/
├── src/
│ ├── index.ts # MCP server entry (stdio transport)
│ ├── server.ts # 23 tool definitions with Zod schemas
│ ├── cli.ts # Full CLI with Commander
│ ├── auth/google.ts # OAuth2 with auto token refresh
│ ├── data/store.ts # SQLite (WAL mode) for history
│ ├── modules/
│ │ ├── rank-tracker/ # Playwright + anti-detection + SERP parsing
│ │ ├── analytics/ # GA4 Data API + Admin API + Realtime
│ │ ├── auditor/ # On-page, content, links, schema, crawler
│ │ ├── keywords/ # Search Console + autocomplete + clustering
│ │ ├── competitive/ # Competitor analysis + content gaps + SERP share
│ │ └── performance/ # Lighthouse + PageSpeed Insights + CWV
│ ├── scoring/ # OctoScore: weights, grader, recommendations
│ ├── reports/ # JSON, Markdown, HTML (dark theme) formatters
│ └── utils/ # Config (Conf), logging, rate limiter
├── bin/seoctopus.ts # CLI executable entry
├── tsup.config.ts # Dual-entry build (MCP + CLI)
└── package.json

Under the Hood

Tech Stack

Comparison: SEOctopus vs The Alternatives

Development

npm run dev # Watch mode (auto-rebuild on changes)
npm run typecheck # TypeScript strict mode check
npm run lint # ESLint
npm run format # Prettier
npm run test # Vitest

Want to Build Real Projects With AI Tools Like This?

Contributing

License