diff --git a/www/docs/SEO_KEYWORDS.md b/www/docs/SEO_KEYWORDS.md new file mode 100644 index 0000000..4e96105 --- /dev/null +++ b/www/docs/SEO_KEYWORDS.md @@ -0,0 +1,236 @@ +# SEO Keywords & Content Strategy for Gitea Mirror + +## Target Audience & Pain Points + +### Primary Audience +- DevOps engineers managing GitHub repositories +- Companies looking to backup GitHub data +- Self-hosting enthusiasts +- Organizations migrating from GitHub to self-hosted solutions +- Developers needing GitHub disaster recovery + +### Key Pain Points +- Manual GitHub to Gitea migration is time-consuming +- No automated backup solution for GitHub organizations +- Difficulty preserving repository structure during migration +- Need for scheduled, automatic synchronization +- Complex authentication setup for self-hosted Git services + +## Keyword Categories & Opportunities + +### 1. Problem-Solving Keywords (High Intent) +- **"github to gitea migration"** - Core functionality keyword +- **"mirror github repository to gitea"** - Direct search intent +- **"sync github gitea automatically"** - Automation focus +- **"backup github to self hosted"** - Backup use case +- **"github organization mirror tool"** - Organization-specific +- **"gitea import from github"** - Alternative phrasing +- **"migrate starred github repos"** - Specific feature + +### 2. Comparison & Alternative Keywords +- **"github vs gitea migration"** - Comparison content +- **"gitea mirror alternatives"** - Competitor analysis +- **"self hosted github backup solutions"** - Solution category +- **"github repository sync tools"** - Tool category +- **"gitea github integration"** - Integration focus +- **"github backup automation"** - Automation emphasis + +### 3. How-To & Tutorial Keywords +- **"how to mirror github to gitea"** - Tutorial intent +- **"setup gitea mirror docker"** - Installation guide +- **"gitea github sync tutorial"** - Step-by-step content +- **"automate github backup gitea"** - Automation tutorial +- **"mirror private github repos gitea"** - Private repos guide +- **"gitea import github wiki"** - Feature-specific tutorial + +### 4. Feature-Specific Keywords +- **"gitea sso authentication setup"** - Auth feature +- **"gitea oidc provider configuration"** - OIDC setup +- **"gitea better auth integration"** - Specific tech stack +- **"gitea scheduled mirror"** - Scheduling feature +- **"gitea bulk repository import"** - Bulk operations +- **"gitea preserve organization structure"** - Organization feature + +### 5. Platform & Deployment Keywords +- **"gitea mirror proxmox"** - Platform-specific +- **"gitea mirror docker compose"** - Docker deployment +- **"gitea mirror arm64"** - Architecture-specific +- **"gitea mirror reverse proxy"** - Infrastructure setup +- **"gitea authentik integration"** - Auth provider integration + +### 6. Use Case Keywords +- **"self host github backup"** - Backup use case +- **"enterprise github migration gitea"** - Enterprise focus +- **"github disaster recovery gitea"** - DR use case +- **"github archive self hosted"** - Archival use case +- **"github organization backup automation"** - Org backup + +### 7. Long-Tail Problem Keywords +- **"mirror github issues to gitea"** - Specific feature +- **"sync github releases gitea automatically"** - Release sync +- **"gitea mirror multiple organizations"** - Multi-org +- **"github starred repositories backup"** - Starred repos +- **"gitea mirror skip forks"** - Fork handling + +### 8. Technical Integration Keywords +- **"gitea github api integration"** - API focus +- **"gitea webhook github sync"** - Webhook integration +- **"gitea ci/cd github mirror"** - CI/CD integration +- **"gitea github actions migration"** - Actions migration + +## Blog Post Ideas & Content Strategy + +### High-Priority Blog Posts + +1. **"Complete Guide to Migrating from GitHub to Gitea in 2025"** + - **Target Keywords**: github to gitea migration, gitea import from github + - **Content**: Comprehensive migration guide with screenshots + - **Length**: 2,500-3,000 words + - **Include**: Step-by-step instructions, troubleshooting, best practices + +2. **"How to Automatically Backup Your GitHub Repositories to Self-Hosted Gitea"** + - **Target Keywords**: backup github to self hosted, github backup automation + - **Content**: Focus on automation and scheduling features + - **Length**: 1,800-2,200 words + - **Include**: Docker setup, cron scheduling, backup strategies + +3. **"Gitea Mirror vs Manual Migration: Which GitHub Migration Method is Best?"** + - **Target Keywords**: gitea mirror alternatives, github repository sync tools + - **Content**: Comparison post with pros/cons, feature matrix + - **Length**: 1,500-2,000 words + - **Include**: Comparison table, use case recommendations + +4. **"Setting Up Enterprise GitHub Backup with Gitea Mirror and Docker"** + - **Target Keywords**: enterprise github migration gitea, github organization backup automation + - **Content**: Enterprise-focused guide with security considerations + - **Length**: 2,000-2,500 words + - **Include**: Multi-user setup, permission management, scaling + +5. **"Mirror GitHub Organizations to Gitea While Preserving Structure"** + - **Target Keywords**: github organization mirror tool, gitea preserve organization structure + - **Content**: Deep dive into organization mirroring strategies + - **Length**: 1,500-1,800 words + - **Include**: Strategy explanations, configuration examples + +6. **"Gitea SSO Setup: Complete Authentication Guide with Examples"** + - **Target Keywords**: gitea sso authentication setup, gitea oidc provider configuration + - **Content**: Cover all auth methods including header auth + - **Length**: 2,000-2,500 words + - **Include**: Provider examples (Google, Azure, Authentik) + +7. **"How to Mirror Private GitHub Repositories to Your Gitea Instance"** + - **Target Keywords**: mirror private github repos gitea, gitea github api integration + - **Content**: Security-focused content with token management + - **Length**: 1,500-1,800 words + - **Include**: Token permissions, security best practices + +8. **"Gitea Mirror on Proxmox: Ultimate Self-Hosting Guide"** + - **Target Keywords**: gitea mirror proxmox, self host github backup + - **Content**: LXC container setup tutorial + - **Length**: 1,800-2,200 words + - **Include**: Proxmox setup, resource allocation, networking + +## Landing Page Optimization + +### Title Tag Options +- "Gitea Mirror - Automated GitHub to Gitea Migration & Backup Tool" +- "GitHub to Gitea Mirror - Sync, Backup & Migrate Repositories Automatically" +- "Gitea Mirror - Self-Hosted GitHub Repository Backup & Sync Solution" + +### Meta Description Options +- "Automatically mirror and backup your GitHub repositories to self-hosted Gitea. Support for organizations, private repos, scheduled sync, and SSO authentication. Docker & Proxmox ready." +- "The easiest way to migrate from GitHub to Gitea. Mirror repositories, organizations, issues, and releases automatically. Self-hosted backup solution with enterprise features." + +### H1 Options +- "Automatically Mirror GitHub Repositories to Your Gitea Instance" +- "Self-Hosted GitHub Backup & Migration Tool for Gitea" +- "The Complete GitHub to Gitea Migration Solution" + +### Key Landing Page Sections to Optimize + +1. **Hero Section** + - Include primary keywords naturally + - Clear value proposition + - Quick start CTA + +2. **Features Section** + - Target feature-specific keywords + - Use semantic variations + - Include comparison points + +3. **Use Cases Section** + - Target use case keywords + - Include customer scenarios + - Enterprise focus subsection + +4. **Installation Section** + - Target platform keywords + - Docker, Proxmox, manual options + - Quick start emphasis + +5. **FAQ Section** + - Target long-tail keywords + - Common migration questions + - Technical integration queries + +## Content Calendar Suggestions + +### Month 1 +- Week 1-2: "Complete Guide to Migrating from GitHub to Gitea" +- Week 3-4: "How to Automatically Backup Your GitHub Repositories" + +### Month 2 +- Week 1-2: "Gitea Mirror vs Manual Migration" +- Week 3-4: "Enterprise GitHub Backup Guide" + +### Month 3 +- Week 1-2: "Mirror GitHub Organizations Guide" +- Week 3-4: "Gitea SSO Setup Guide" + +### Month 4 +- Week 1-2: "Private Repository Mirroring" +- Week 3-4: "Gitea Mirror on Proxmox" + +## SEO Research Tips + +### When Using Ahrefs +1. **Search Volume**: Target 100-1,000 monthly searches initially +2. **Keyword Difficulty**: Aim for KD < 30 for new content +3. **SERP Analysis**: Check competitor content depth +4. **Parent Topics**: Find broader topics to target +5. **Featured Snippets**: Look for snippet opportunities + +### Content Optimization +1. Include target keyword in: + - Title tag + - H1 (once) + - First 100 words + - At least one H2 + - URL slug + - Meta description + +2. Use semantic variations throughout +3. Include related keywords naturally +4. Optimize for search intent +5. Add schema markup for tutorials + +## Tracking & Updates + +### KPIs to Monitor +- Organic traffic growth +- Keyword rankings +- Click-through rates +- Conversion rates (signups/downloads) +- Time on page + +### Regular Updates +- Review keyword performance monthly +- Update content quarterly +- Add new keywords based on search console data +- Monitor competitor content +- Track feature releases for new keyword opportunities + +--- + +*Last Updated: [Current Date]* +*Next Review: [Date + 3 months]* \ No newline at end of file