Refactor SEO automation into unified CLI application

Major refactoring to create a clean, integrated CLI application:

### New Features:
- Unified CLI executable (./seo) with simple command structure
- All commands accept optional CSV file arguments
- Auto-detection of latest files when no arguments provided
- Simplified output directory structure (output/ instead of output/reports/)
- Cleaner export filename format (all_posts_YYYY-MM-DD.csv)

### Commands:
- export: Export all posts from WordPress sites
- analyze [csv]: Analyze posts with AI (optional CSV input)
- recategorize [csv]: Recategorize posts with AI
- seo_check: Check SEO quality
- categories: Manage categories across sites
- approve [files]: Review and approve recommendations
- full_pipeline: Run complete workflow
- analytics, gaps, opportunities, report, status

### Changes:
- Moved all scripts to scripts/ directory
- Created config.yaml for configuration
- Updated all scripts to use output/ directory
- Deprecated old seo-cli.py in favor of new ./seo
- Added AGENTS.md and CHANGELOG.md documentation
- Consolidated README.md with updated usage

### Technical:
- Added PyYAML dependency
- Removed hardcoded configuration values
- All scripts now properly integrated
- Better error handling and user feedback

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
This commit is contained in:
Kevin Bataille
2026-02-16 14:24:44 +01:00
parent 3b51952336
commit 8c7cd24685
57 changed files with 16095 additions and 560 deletions

View File

@@ -0,0 +1,484 @@
# Multi-Site Content Strategy
**Status:** Strategic Framework
**Scope:** 3 websites, 260+ posts, content redistribution
**Goal:** Maximize traffic and monetization across your network
---
## 🌐 Your Website Ecosystem
### mistergeek.net (Main Site - Core Brand)
- **Focus:** Tech, software, VPN, gaming, tutorials
- **Monetization:** Sponsors, affiliate links (high CPM topics)
- **Content Type:** Quality guides, comparisons, in-depth tutorials
- **Target Traffic:** 70% of total network traffic
- **Current:** ~717 visits/month → Target: 1,200+ visits/month
### webscroll.fr (Secondary - Niche Focus)
- **Focus:** Torrenting, file-sharing, tracker guides
- **Monetization:** Limited (low CPM), but targeted audience
- **Content Type:** Tracker guides, ratio guides, tutorials
- **Target Traffic:** 20% of network traffic
- **Current:** Unknown → Target: 300-400 visits/month
### hellogeek.net (Experimental - Off-Brand)
- **Focus:** Everything else - experimental, low-traffic, niche
- **Monetization:** Secondary, experimental
- **Content Type:** Mixed, exploratory
- **Target Traffic:** 10% of network traffic
- **Current:** Unknown → Target: 100-150 visits/month
---
## 📊 Content Classification System
### By Topic (How to Categorize Posts)
```
HIGH-VALUE (Keep on mistergeek.net):
├─ VPN & Privacy (CPM: $5-10)
├─ Software & Tools (CPM: $3-8)
├─ Gaming & Emulation (CPM: $2-4)
└─ General Tech Guides (CPM: $2-5)
MEDIUM-VALUE (Move to webscroll.fr):
├─ Torrenting Guides (CPM: $0.50-1)
├─ Tracker Reviews (CPM: $0.50-1)
└─ File-Sharing Tutorials (CPM: $0.50-1)
LOW-VALUE (Move to hellogeek.net):
├─ Experimental Content
├─ Low-Traffic Posts (<20 visits)
├─ Off-Brand Content
└─ Testing/Ideas
```
### By Status
```
PUBLISHED (262 posts)
├─ High Traffic (>100 visits) → Keep on mistergeek.net
├─ Medium Traffic (20-100 visits) → Consolidate or move
├─ Low Traffic (<20 visits) → Move to hellogeek.net
└─ Extremely Low (<5 visits) → Delete or merge
DRAFTS (Unknown quantity)
├─ Complete, ready to publish → Decide which site
├─ Incomplete, needs work → Complete for high-value topics
└─ Outdated/Off-topic → Delete
```
### By Author
```
By "Expert" (Sponsored Posts)
├─ Keep on mistergeek.net
├─ Highlight as sponsored content
├─ Use for monetization
└─ Track separately for revenue
```
---
## 🎯 Distribution Strategy
### STAGE 1: Analysis (Week 1)
**Run:** `content_strategy_analyzer.py`
**What it does:**
```
Input:
• All published posts (mistergeek.net)
• All draft posts
• Post metadata (traffic, author, category)
Output:
✓ content_distribution.csv
✓ content_strategy_report.md
✓ analysis_summary.json
```
**Outputs Include:**
```
Content by Site:
• mistergeek.net: 180 posts (recommended)
• webscroll.fr: 40 posts (recommended)
• hellogeek.net: 40 posts (recommended)
Content by Action:
• KEEP & OPTIMIZE: 120 posts
• CONSOLIDATE: 45 posts
• MOVE_TO_OTHER_SITE: 60 posts
• DELETE: 25 posts
• REPUBLISH_DRAFTS: 12 posts
```
### STAGE 2: Decision Making (Week 2)
**For each post, decide:**
#### Keep on mistergeek.net (Traffic >50, High CPM topics)
```
Post #42: "VPN for Gaming 2025"
✓ Traffic: 150 visits
✓ Topic: VPN (high CPM)
✓ Decision: KEEP & OPTIMIZE
→ Action: Improve, add links, monetize
Post #156: "Best Software for Productivity"
✓ Traffic: 80 visits
✓ Topic: Software (medium CPM)
✓ Decision: KEEP & OPTIMIZE
→ Action: Improve, affiliate links
```
#### Move to webscroll.fr (Torrent/File-sharing)
```
Post #12: "YggTorrent Ratio Guide"
✓ Topic: Torrenting
✓ Decision: MOVE_TO_WEBSCROLL
→ Action: Export, import, redirect
Post #45: "Best Torrent Trackers 2025"
✓ Topic: Torrenting
✓ Decision: MOVE_TO_WEBSCROLL
→ Action: Export, import, redirect
```
#### Move to hellogeek.net (Low traffic, experimental)
```
Post #234: "Random Tech Experiment"
✓ Traffic: 3 visits
✓ Topic: Other
✓ Decision: MOVE_TO_HELLOGEEK
→ Action: Export, import, redirect
Post #289: "Niche Gaming Topic"
✓ Traffic: 15 visits
✓ Topic: Gaming (but low traffic)
✓ Decision: MOVE_TO_HELLOGEEK
→ Action: Can potentially grow here
```
#### Consolidate (Merge duplicates)
```
Posts #12, #45, #88: "YggTorrent ratio"
✓ Same topic, competing
✓ Decision: CONSOLIDATE
→ Action: Keep best, merge others, redirect
Posts #34, #67: "Best VPN"
✓ Same intent
✓ Decision: CONSOLIDATE
→ Action: Merge into one comprehensive guide
```
#### Delete (Thin, off-brand, zero traffic)
```
Post #156: "Unrelated topic"
✓ Traffic: 0
✓ Impressions: 5
✓ Decision: DELETE
→ Action: No redirects, just remove
Post #203: "Test article"
✓ Traffic: 1
✓ Too thin
✓ Decision: DELETE
→ Action: Remove
```
#### Republish Drafts
```
Draft: "Complete VPN Guide"
✓ Complete, ready
✓ Topic: VPN (high CPM)
✓ Decision: PUBLISH_ON_MISTERGEEK
→ Action: Publish, promote, monetize
Draft: "Streaming guide"
✓ Incomplete
✓ Decision: COMPLETE_OR_ABANDON
→ Action: Decide if worth completing
```
### STAGE 3: Implementation (Weeks 3-8)
#### 3.1 Content Export/Import (WordPress)
**For mistergeek.net (Keep):**
```
WordPress:
• No action - stays published
• Update internal links
• Remove links to moved posts
• Add redirects for consolidated posts
```
**For webscroll.fr (Move):**
```
WordPress (source):
1. Export posts (use WordPress export plugin)
2. Get post IDs, URLs, content
3. Set up 301 redirects
webscroll.fr (destination):
1. Import posts (WordPress import)
2. Update internal links
3. Reorganize categories
```
**For hellogeek.net (Move):**
```
Same as webscroll.fr process
```
#### 3.2 URL Redirect Strategy
**Important: SEO-friendly redirects**
```
mistergeek.net/old-post/ → hellogeek.net/old-post/
(Use 301 permanent redirects)
Why:
• Preserve SEO value
• Pass link authority
• Maintain user experience
• Allow analytics tracking
```
#### 3.3 Sponsored Content Handling
**Posts by "Expert" (Sponsored):**
```
Rule: Keep on mistergeek.net or webscroll.fr
Reason: These drive revenue, don't move
Process:
1. Identify all "Expert" posts
2. Evaluate quality & performance
3. Keep in appropriate site
4. Highlight as sponsored
5. Track for revenue attribution
```
---
## 📈 Expected Impact
### Before Distribution
```
mistergeek.net: 262 posts
• 717 visits/month
• 2.7 visits/post
• 23/100 coherence score
• Low monetization potential
• Scattered authority
webscroll.fr: Unknown
hellogeek.net: Unknown
```
### After Distribution
```
mistergeek.net: 180-200 focused posts
• 1,000-1,200 visits/month (+40-70%)
• 5-6 visits/post (doubled)
• 80+/100 coherence score
• High monetization potential
• Strong authority in core topics
webscroll.fr: 40-50 posts
• 300-400 visits/month
• 6-8 visits/post
• Dedicated torrent audience
• Moderate monetization
hellogeek.net: 30-40 posts
• 100-150 visits/month
• Experimental content
• Testing ground for ideas
• Low monetization pressure
```
---
## 🛠️ Actionable Workflow
### Week 1: Analyze
```bash
# Run analysis
python scripts/content_strategy_analyzer.py
# Review outputs
open output/reports/content_strategy_report.md
open output/analysis/content_distribution.csv
```
### Week 2: Decide
```
For each post, decide:
✓ mistergeek.net (stay, optimize)
✓ webscroll.fr (move)
✓ hellogeek.net (move)
✓ Consolidate (merge)
✓ Delete (remove)
✓ Publish (drafts)
Create: Master spreadsheet with decisions
• Post ID
• Title
• Current site
• Recommended site
• Action
• Priority
```
### Week 3-4: Export/Import
```
For webscroll.fr:
1. Export torrent-related posts from mistergeek.net
2. Import to webscroll.fr
3. Set up 301 redirects
4. Update internal links
For hellogeek.net:
1. Export low-traffic/experimental posts
2. Import to hellogeek.net
3. Set up 301 redirects
4. Reorganize structure
```
### Week 5-6: Consolidate
```
For duplicate topics:
1. Identify duplicate posts
2. Keep the best performer
3. Merge unique content into winner
4. Set up 301 redirects from others
5. Update internal links
6. Remove thin versions
```
### Week 7-8: Optimize
```
For mistergeek.net (now focused):
1. Update internal linking
2. Reorganize navigation
3. Create topic pillars
4. Enhance monetization
5. Update category pages
6. Test user experience
```
---
## 📊 Monetization Strategy by Site
### mistergeek.net (Primary Income)
```
Topics & CPM:
• VPN: $5-10 CPM
• Software: $3-8 CPM
• Gaming: $2-4 CPM
• General Tech: $2-5 CPM
Monthly Potential:
• 1,200 visits × avg $0.005 = $6
• Better: Sponsored links = $50-100/month
• Affiliate partnerships = $20-50/month
• Total: $70-150/month
```
### webscroll.fr (Secondary Income)
```
Topics & CPM:
• Torrents: $0.50-1 CPM
• File-sharing: $0.50-1 CPM
Monthly Potential:
• 350 visits × avg $0.001 = $0.35
• Reality: Very low (sponsors avoid)
• Audience monetization: $10-20/month
• Total: $10-20/month
```
### hellogeek.net (Testing & Growth)
```
Purpose: Testing & experimental
• Low monetization pressure
• Growth playground
• Niche audience testing
• Monthly: $5-10/month
```
---
## ✅ Checklist
### Pre-Migration
- [ ] Analyze all content with content_strategy_analyzer.py
- [ ] Review content_strategy_report.md
- [ ] Decide distribution for each post
- [ ] Get drafts CSV ready
- [ ] Set up 301 redirects on mistergeek.net
- [ ] Install WordPress import/export plugins
### Migration Phase
- [ ] Export posts from mistergeek.net
- [ ] Import to webscroll.fr
- [ ] Import to hellogeek.net
- [ ] Set up 301 redirects
- [ ] Update internal links
- [ ] Test 404 vs redirects
### Post-Migration
- [ ] Consolidate duplicates
- [ ] Reorganize categories
- [ ] Update navigation
- [ ] Test user experience on each site
- [ ] Monitor analytics for issues
- [ ] Update XML sitemaps
---
## 🎯 Success Metrics
### Coherence
```
Before: 23/100 (scattered across 14 topics)
After: 80+/100 (focused on 3-4 topics)
```
### Traffic
```
Before: 717 visits/month
After: 1,300+ visits/month (+80%)
```
### Monetization
```
Before: $20-30/month
After: $85-160/month (+3-5x)
```
### Authority
```
Before: Scattered authority
After: Strong in core topics
```
---
## 🚀 Next Action
1. **Prepare draft CSV:** Export your draft posts to `input/drafts/drafts.csv`
2. **Run analysis:** `python scripts/content_strategy_analyzer.py`
3. **Review report:** `open output/reports/content_strategy_report.md`
4. **Make decisions:** Plan your content redistribution
5. **Execute:** Follow the week-by-week workflow
Ready to transform your content ecosystem? 🌐