🚀 Hybrid YouTube Growth Engine (hybrid-youtube-growth-engine)

An all-in-one local toolkit and CLI for YouTube algorithm optimization, tag generation, high-CTR A/B title creation, competitor metadata extraction, and comprehensive SEO auditing.

---

📦 Core Features

• 🏷️ 500-Character Tag Budget Optimizer:
  • Enforces strict 10-tier priority hierarchy (Brand $\to$ Exact Title $\to$ High-Traffic Style $\to$ Viral Topic $\to$ Multi-language tags).
  • Precise multi-language ratio allocation (e.g. 70% English / 30% Japanese for global + anime/pixel-art crossover discovery).
  • Guaranteed zero overflow past 500 characters and duplicate tag protection.
• 🎯 5-Archetype A/B Title Generator:
  • Generates 5 distinct, proven title formulas tailored for YouTube's Test & Compare system:
    1. Official SEO Standard
    2. Relatable Hook & Empathy
    3. Curiosity Gap & Suspense
    4. Bilingual / International Release
    5. Aesthetic & Niche Art Focus
  • Built-in heuristic CTR scoring algorithm evaluating length, power words, and first-40-char keyword weighting.
• 🔍 Zero-Key Competitor Inspector:
  • Scrapes hidden tags, descriptions, view counts, and chapter timestamps from any YouTube URL using yt-dlp and direct scraper fallback.
• 📝 Algorithm-Compliant Description & Chapter Builder:
  • Automatically formats the first 150 characters for search previews before "Show more".
  • Integrates smart streaming links, full lyrics/scripts, credit blocks, and Google Key Moments chapters.
• 📊 0–100 SEO Health Score Auditor:
  • Audits Title, Description, Tags, and Hashtags with actionable recommendations and letter grades (A+, A, B, C).

---

🛠️ Installation

# Clone the repository
git clone https://github.com/catball912/hybrid-youtube-growth-engine.git
cd hybrid-youtube-growth-engine

# Install in editable mode
pip install -e .

---

🚀 CLI Usage

1. Generate Full YouTube SEO Launch Package

youtube-growth generate "CyberEcho" "Neon Midnight" \
    --album "Cyber Horizon" \
    --smart-link "https://example.com/smart-link"

2. Generate 500-Char Multi-Language Tag Bundle

youtube-growth tags "CyberEcho" "Neon Midnight" \
    --lang en,ja \
    --ratio 70:30 \
    --max-chars 490

3. Generate 5 A/B Testing Title Archetypes

youtube-growth titles "CyberEcho" "Neon Midnight" \
    --album "賽博之夜" \
    --style "4K Pixel Art"

4. Inspect Competitor Video Tags & Metadata

youtube-growth inspect "https://www.youtube.com/watch?v=VIDEO_ID"

5. Audit Metadata for SEO Score (0–100)

youtube-growth audit \
    --title "CyberEcho - Neon Midnight (Official Music Video) | 4K Pixel Art" \
    --desc "📱 One more swipe into the cyber night...." \
    --tags "CyberEcho, Neon Midnight, Pixel Art Music Video, ..."

---

💻 Python API

from hybrid_youtube_growth_engine import (
    generate_seo_bundle,
    generate_tags,
    generate_titles,
    audit_metadata,
    inspect_youtube_video,
)

# 1. Generate full bundle
bundle = generate_seo_bundle(
    artist="CyberEcho",
    title="Neon Midnight",
    album_name="Cyber Horizon",
    smart_link="https://example.com/smart-link",
)

print(f"Primary Title: {bundle['primary_title']}")
print(f"Tags ({bundle['tag_bundle'].total_characters}/500 chars):")
print(bundle['tag_bundle'].formatted_string)
print(f"SEO Health Score: {bundle['audit_report'].overall_score}/100 ({bundle['audit_report'].grade})")

---

🧪 Testing

python -m unittest discover tests

---

📄 License

MIT License © 2026 catball912