{"id":49216027,"url":"https://github.com/hashangit/seo-pro","last_synced_at":"2026-04-24T00:03:00.724Z","repository":{"id":337966221,"uuid":"1156002938","full_name":"hashangit/seo-pro","owner":"hashangit","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-25T16:02:34.000Z","size":190,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-25T20:06:31.703Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hashangit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-12T06:28:35.000Z","updated_at":"2026-02-25T16:09:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hashangit/seo-pro","commit_stats":null,"previous_names":["hashangit/seo-pro"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hashangit/seo-pro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashangit%2Fseo-pro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashangit%2Fseo-pro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashangit%2Fseo-pro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashangit%2Fseo-pro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hashangit","download_url":"https://codeload.github.com/hashangit/seo-pro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashangit%2Fseo-pro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32203362,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-23T20:19:26.138Z","status":"ssl_error","status_checked_at":"2026-04-23T20:19:23.520Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-24T00:02:59.966Z","updated_at":"2026-04-24T00:03:00.714Z","avatar_url":"https://github.com/hashangit.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SEO Pro\n\n**SEO Pro** is a comprehensive SEO analysis platform that operates in two modes:\n\n1. **SaaS Platform** - Full web application with credit-based pricing, user authentication, and dashboard\n2. **Claude Code Skill** - CLI-based SEO analysis tool for Claude Code users\n\n![SEO Pro Platform](screenshots/cover-image.jpeg)\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Python 3.11+](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://python.org)\n[![Next.js 15](https://img.shields.io/badge/Next.js-15-black.svg)](https://nextjs.org)\n\n---\n\n## SaaS Platform\n\n### Architecture\n\n```\n┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐\n│   Next.js       │────▶│   FastAPI       │────▶│   SDK Worker    │\n│   Frontend      │     │   Gateway       │     │   (Claude SDK)  │\n│   (Vercel)      │     │   (Cloud Run)   │     │   (Cloud Run)   │\n└─────────────────┘     └─────────────────┘     └─────────────────┘\n                               │                        │\n                               ▼                        ▼\n                        ┌─────────────────┐     ┌─────────────────┐\n                        │   Supabase      │     │   Cloud Tasks   │\n                        │   PostgreSQL    │     │   (Queue)       │\n                        └─────────────────┘     └─────────────────┘\n```\n\n### Tech Stack\n\n| Layer | Technology |\n|-------|------------|\n| Frontend | Next.js 15, TypeScript, Tailwind CSS, shadcn/ui |\n| Backend | FastAPI, Python 3.11+, Pydantic v2 |\n| Auth | WorkOS AuthKit (SSO: Google, GitHub, etc.) |\n| Database | Supabase PostgreSQL with Row-Level Security |\n| AI Engine | Claude Agent SDK + GLM-4.7 (via Z.AI) |\n| Deployment | Google Cloud Run, Cloud Tasks, Secret Manager |\n\n### Credit Pricing\n\n| Mode | Credits | Cost | Description |\n|------|---------|------|-------------|\n| Quick Analysis | 1 | ~$0.12 | Single analysis type (schema, technical, etc.) |\n| Full Page Audit | 8 | ~$1.00 | All 12 analysis types on one page |\n| Full Site Audit | 7/page | ~$0.88/page | Complete site-wide analysis |\n\n**Exchange Rate:** $1 = 8 credits (never expire)\n\n### Quick Start (SaaS)\n\n```bash\n# Clone and configure\ngit clone https://github.com/hashangit/seo-pro.git\ncd seo-pro\ncp .env.example .env\n\n# Start local development\ndocker-compose up -d\n\n# Access the platform\nopen http://localhost:3000     # Frontend\nopen http://localhost:8080     # API Gateway\n```\n\n### Analysis Types\n\nThe platform provides 12 comprehensive SEO analysis types:\n\n| Type | Description |\n|------|-------------|\n| Technical SEO | Crawlability, indexability, Core Web Vitals |\n| On-Page SEO | Meta tags, headings, keyword optimization |\n| Content Quality | E-E-A-T signals, readability, depth |\n| Schema Markup | JSON-LD validation and generation |\n| Image Optimization | Alt text, compression, lazy loading |\n| Internal Linking | Structure, anchor text, orphan pages |\n| Sitemap Analysis | XML validation, URL coverage |\n| AI Search (GEO) | Google AI Overviews, ChatGPT optimization |\n| Competitor Analysis | Gap analysis, opportunity identification |\n| Hreflang/i18n | Multi-language validation |\n| Programmatic SEO | Scale analysis, thin content detection |\n| Page Speed | Performance metrics, optimization tips |\n\n---\n\n## Claude Code Skill (CLI)\n\nFor Claude Code users, SEO Pro is available as a skill for in-terminal SEO analysis.\n\n### Installation\n\n```bash\n# One-command install (Unix/macOS/Linux)\ncurl -fsSL https://raw.githubusercontent.com/hashangit/seo-pro/main/install.sh | bash\n\n# Windows\nirm https://raw.githubusercontent.com/hashangit/seo-pro/main/install.ps1 | iex\n```\n\n### CLI Commands\n\n```bash\n# Start Claude Code\nclaude\n\n# Run a full site audit\n/seo audit https://example.com\n\n# Analyze a single page\n/seo page https://example.com/about\n\n# Check schema markup\n/seo schema https://example.com\n\n# Generate a sitemap\n/seo sitemap generate\n\n# Optimize for AI search\n/seo geo https://example.com\n```\n\n| Command | Description |\n|---------|-------------|\n| `/seo audit \u003curl\u003e` | Full website audit with parallel subagent delegation |\n| `/seo page \u003curl\u003e` | Deep single-page analysis |\n| `/seo sitemap \u003curl\u003e` | Analyze existing XML sitemap |\n| `/seo schema \u003curl\u003e` | Detect, validate, and generate Schema.org markup |\n| `/seo images \u003curl\u003e` | Image optimization analysis |\n| `/seo technical \u003curl\u003e` | Technical SEO audit |\n| `/seo content \u003curl\u003e` | E-E-A-T and content quality analysis |\n| `/seo geo \u003curl\u003e` | AI Overviews / Generative Engine Optimization |\n| `/seo plan \u003ctype\u003e` | Strategic SEO planning |\n| `/seo hreflang \u003curl\u003e` | Hreflang/i18n audit and generation |\n\n### CLI Demo\n\n[Watch the full demo on YouTube](https://www.youtube.com/watch?v=COMnNlUakQk)\n\n![SEO Audit Demo](screenshots/seo-audit-demo.gif)\n\n---\n\n## Features\n\n### Core Web Vitals (2026 Metrics)\n- **LCP** (Largest Contentful Paint): Target \u003c 2.5s\n- **INP** (Interaction to Next Paint): Target \u003c 200ms\n- **CLS** (Cumulative Layout Shift): Target \u003c 0.1\n\n### E-E-A-T Analysis\nBased on September 2025 Quality Rater Guidelines:\n- **Experience**: First-hand knowledge signals\n- **Expertise**: Author credentials and depth\n- **Authoritativeness**: Industry recognition\n- **Trustworthiness**: Contact info, security, transparency\n\n### AI Search Optimization (GEO)\nOptimize for AI-powered search experiences:\n- Google AI Overviews\n- ChatGPT web search\n- Perplexity\n- Other generative AI engines\n\n### Schema Markup Support\n- Detection: JSON-LD (preferred), Microdata, RDFa\n- Validation against Google's supported types\n- Auto-generation with templates\n- Video schema: VideoObject, BroadcastEvent, Clip\n\n### Quality Gates\n- Warning at 30+ location pages\n- Hard stop at 50+ location pages\n- Thin content detection\n- Doorway page prevention\n\n---\n\n## Deployment\n\n### Google Cloud Run\n\n```bash\n# Deploy gateway\ngcloud run deploy seo-pro-gateway \\\n  --source ./deploy/Dockerfile.gateway \\\n  --region us-central1 \\\n  --platform managed \\\n  --allow-unauthenticated \\\n  --set-env-vars \"ENVIRONMENT=production,FRONTEND_URL=https://your-app.vercel.app\" \\\n  --set-secrets \"SUPABASE_SERVICE_KEY=supabase-service-key:latest\"\n\n# Deploy SDK worker\ngcloud run deploy seo-pro-sdk-worker \\\n  --source ./deploy/Dockerfile.sdk-worker \\\n  --region us-central1 \\\n  --memory 2Gi \\\n  --cpu 1 \\\n  --set-env-vars \"ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic\" \\\n  --set-secrets \"ANTHROPIC_AUTH_TOKEN=zai-api-key:latest\"\n```\n\nSee [Deployment Guide](docs/DEPLOYMENT.md) for complete instructions.\n\n---\n\n## Documentation\n\n### SaaS Platform\n- [Deployment Guide](docs/DEPLOYMENT.md) - Deploy to Google Cloud Run\n- [Developer Guide](docs/DEVELOPER_GUIDE.md) - Local development setup\n- [Architecture](docs/ARCHITECTURE.md) - System design and components\n- [Features Overview](docs/FEATURES.md) - All 12 analysis types\n\n### Claude Code Skill\n- [Installation Guide](docs/INSTALLATION.md) - CLI setup\n- [Commands Reference](docs/COMMANDS.md) - All available commands\n- [MCP Integration](docs/MCP-INTEGRATION.md) - Connect Ahrefs, Semrush, etc.\n- [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues\n\n---\n\n## Development\n\n### Prerequisites\n\n- Python 3.11+\n- Node.js 20+\n- Docker \u0026 Docker Compose\n- Supabase account\n- WorkOS account\n- Google Cloud account (for deployment)\n\n### Local Development\n\n```bash\n# Backend\npython -m venv .venv\nsource .venv/bin/activate\npip install -r requirements.txt\nuvicorn api.main:app --reload\n\n# Frontend\ncd frontend\nnpm install\nnpm run dev\n\n# Or use Docker Compose for everything\ndocker-compose up -d\n```\n\n### Testing\n\n```bash\n# Backend tests\npytest api/tests/ -v\n\n# Frontend tests\ncd frontend \u0026\u0026 npm test\n```\n\n---\n\n## Security\n\n- **SSRF Prevention**: URL validation blocks private IP ranges\n- **Row-Level Security**: Supabase RLS isolates data per user\n- **JWT Authentication**: WorkOS token validation with audience verification\n- **CORS Configuration**: Origin whitelisting for API access\n- **Input Sanitization**: Injection prevention across all endpoints\n- **Secret Management**: Google Secret Manager for production\n\n---\n\n## Requirements\n\n| Component | Requirement |\n|-----------|-------------|\n| Python | 3.11+ |\n| Node.js | 20+ |\n| Claude Code CLI | Latest (for skill mode) |\n| Playwright | Optional, for screenshots |\n\n---\n\n## Uninstall (CLI Skill)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/hashangit/seo-pro/main/uninstall.sh | bash\n```\n\n---\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n## Contributing\n\nContributions welcome! Please read the guidelines in `docs/` before submitting PRs.\n\n---\n\nBuilt for Claude Code by [@hashangit](https://github.com/hashangit)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashangit%2Fseo-pro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhashangit%2Fseo-pro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashangit%2Fseo-pro/lists"}