# Quick Start Guide - Blog Post Improvement

**Last Updated:** 2026-03-16

Quick reference guide for starting the blog post improvement process. Use this when you're ready to improve your first post.

**Single entry point:** See [CONTENT_OPTIMIZATION_WORKFLOW.md](CONTENT_OPTIMIZATION_WORKFLOW.md) for the streamlined flow. Use `run-post-improvement-pipeline.php` for Phase 1.

## Before You Start

### Prerequisites

- ✅ Post slug and category identified
- ✅ Current post content reviewed
- ✅ Process documentation read (optional but recommended)

### Required Reading

**Essential:**

- [Content Optimization Workflow](CONTENT_OPTIMIZATION_WORKFLOW.md) - Streamlined entry point
- [Blog Post Improvement Process](BLOG_POST_IMPROVEMENT_PROCESS.md) - Complete workflow

**Reference (as needed):**

- [GSC/GA4 Content Decision Guide](GSC_GA4_CONTENT_DECISION_GUIDE.md) - GSC/GA4 decision logic
- [Improvement Data Collection Guide](IMPROVEMENT_DATA_COLLECTION_GUIDE.md) - Data collection
- [SERP Analysis Workflow](SERP_ANALYSIS_WORKFLOW.md) - SERP analysis
- [Content Creation Workflow](CONTENT_CREATION_WORKFLOW_IMPROVEMENT.md) - Content creation
- [SEO/GEO/AEO Checklist](SEO_GEO_AEO_CHECKLIST.md) - Optimization
- [Content Quality Checklist](CONTENT_QUALITY_CHECKLIST_IMPROVEMENT.md) - Quality standards

## Quick Start Commands

### Step 1: Set Variables

```bash
POST_SLUG="your-post-slug"
CATEGORY="ratgeber"  # or "lexikon" or "inside-ordio"
```

### Step 2: Run Improvement Pipeline (Recommended)

**Single command** – runs all data collection steps (GA4, GSC, derive-keywords, SISTRIX, PAA, SERP, FAQ, competition-levels, search-intent, competitor analysis, Firecrawl, content-depth-report, analysis, docs, SERP skeleton, pre-content checklist):

```bash
php v2/scripts/blog/run-post-improvement-pipeline.php --post=$POST_SLUG --category=$CATEGORY
```

**Options:** `--skip-backup`, `--skip-ga4`, `--skip-gsc`, `--skip-sistrix`, `--skip-competitor`, `--collect-supplemental-faqs`, `--no-firecrawl-remediate`, `--full-rework`

**Estimated Time:** 15-30 minutes  
**Estimated Credits:** 30-50 SISTRIX credits

### Step 2 (Alternative): Collect Data Manually

If you prefer step-by-step collection:

```bash
php v2/scripts/blog/collect-post-performance-ga4.php --post=$POST_SLUG --category=$CATEGORY
php v2/scripts/blog/collect-post-performance-gsc.php --post=$POST_SLUG --category=$CATEGORY
php v2/scripts/blog/derive-target-keywords.php --post=$POST_SLUG --category=$CATEGORY --update-post
php v2/scripts/blog/collect-post-keywords-sistrix.php --post=$POST_SLUG --category=$CATEGORY
php v2/scripts/blog/collect-post-serp-features.php --post=$POST_SLUG --category=$CATEGORY
php v2/scripts/blog/collect-post-search-intent.php --post=$POST_SLUG --category=$CATEGORY
php v2/scripts/blog/collect-post-competition-levels.php --post=$POST_SLUG --category=$CATEGORY
php v2/scripts/blog/validate-data-collection.php --post=$POST_SLUG --category=$CATEGORY
```

### Step 3: Generate Analysis Documentation

```bash
# Run analyses
php v2/scripts/blog/analyze-post-content.php --post=$POST_SLUG --category=$CATEGORY
php v2/scripts/blog/analyze-post-seo.php --post=$POST_SLUG --category=$CATEGORY
php v2/scripts/blog/analyze-post-links.php --post=$POST_SLUG --category=$CATEGORY

# Generate documentation
php v2/scripts/blog/generate-post-documentation.php --post=$POST_SLUG --category=$CATEGORY
```

### Step 4: Conduct SERP Analysis

**Manual Process (Browser-Based):**

1. Open browser in incognito mode
2. Search primary keyword in Google
3. Analyze top 5 results
4. Document findings in `SERP_ANALYSIS.md`

**See:** [SERP Analysis Workflow](SERP_ANALYSIS_WORKFLOW.md) for complete process

**Estimated Time:** 1-2 hours

### Step 5: Create Improved Content

**Process:**

1. Extract valuable elements (calculators, videos, images)
2. Create content outline (based on analysis)
3. Write new content from scratch
4. Reintegrate elements at appropriate positions
5. Create FAQs (from PAA and GSC queries)

**See:** [Content Creation Workflow](CONTENT_CREATION_WORKFLOW_IMPROVEMENT.md) for complete process

**Estimated Time:** 4-8 hours

### Step 6: Optimize

**Checklists:**

- [SEO/GEO/AEO Checklist](SEO_GEO_AEO_CHECKLIST.md)
- [Content Quality Checklist](CONTENT_QUALITY_CHECKLIST_IMPROVEMENT.md)
- [Internal Linking Guide](INTERNAL_LINKING_IMPROVEMENT_GUIDE.md)

**Estimated Time:** 1-2 hours

### Step 7: Validate

```bash
# Content flow validation
php v2/scripts/blog/validate-content-flow.php --post=$POST_SLUG --category=$CATEGORY

# FAQ validation
php v2/scripts/blog/validate-faq-quality.php --post=$POST_SLUG --category=$CATEGORY
php v2/scripts/blog/validate-faq-schema.php --post=$POST_SLUG --category=$CATEGORY

# SEO validation
php v2/scripts/blog/seo-validation-tier1.php --post=$POST_SLUG --category=$CATEGORY
```

**Browser Testing:**

- Load post in browser
- Test all links
- Test calculators/interactive elements
- Test mobile responsiveness

**Estimated Time:** 30 minutes

### Step 8: Publish

```bash
# Backup before updating
cp v2/data/blog/posts/$CATEGORY/$POST_SLUG.json v2/data/blog/posts/$CATEGORY/$POST_SLUG.json.backup-$(date +%Y%m%d_%H%M%S)

# Update JSON file (manual edit)
# Then validate
php -l v2/data/blog/posts/$CATEGORY/$POST_SLUG.json
```

## Checklist Summary

### Data Collection Checklist

- [ ] GA4 data collected
- [ ] GSC data collected
- [ ] SISTRIX keywords collected
- [ ] SERP features collected
- [ ] Search intent collected
- [ ] Competition levels collected
- [ ] Data validated

### SERP Analysis Checklist

- [ ] Primary keyword searched
- [ ] SERP features documented
- [ ] Top 5 results analyzed
- [ ] Content gaps identified
- [ ] Ranking factors analyzed
- [ ] SERP_ANALYSIS.md created

### Content Creation Checklist

- [ ] Valuable elements extracted
- [ ] Content outline created
- [ ] New content written
- [ ] Elements reintegrated
- [ ] FAQs created (10-15 questions)
- [ ] Definition within first 20%

### Optimization Checklist

- [ ] SEO optimized (meta tags, schema, keywords)
- [ ] GEO optimized (AI-ready content)
- [ ] AEO optimized (featured snippets, PAA)
- [ ] Internal links added (10-15 links)
- [ ] Natural anchor text used

### Validation Checklist

- [ ] Content flow validated (score ≥80)
- [ ] FAQ quality validated
- [ ] FAQ schema validated
- [ ] SEO validation passed
- [ ] Browser testing passed
- [ ] Mobile testing passed

## Common Issues & Solutions

### Issue: Data Collection Fails

**Solution:**

- Check API access: `php v2/scripts/blog/test-api-access.php --all`
- Verify credentials exist
- Check credit limits (SISTRIX)

### Issue: SERP Analysis Overwhelming

**Solution:**

- Focus on top 3 results first
- Use template from SERP_ANALYSIS_WORKFLOW.md
- Document findings as you go

### Issue: Content Creation Takes Too Long

**Solution:**

- Break into smaller sections
- Focus on one section at a time
- Use outline to stay organized

### Issue: Validation Fails

**Solution:**

- Check specific validation errors
- Fix issues one at a time
- Re-run validation after fixes

## Time Management

### Estimated Time Breakdown

- **Data Collection:** 15-30 minutes
- **SERP Analysis:** 1-2 hours
- **Content Creation:** 4-8 hours
- **Optimization:** 1-2 hours
- **Validation:** 30 minutes
- **Total:** 7-13 hours per post

### Tips for Efficiency

1. **Batch Data Collection:** Collect data for multiple posts at once
2. **Template Usage:** Use SERP analysis template
3. **Checklist Reference:** Keep checklists open while working
4. **Incremental Validation:** Validate as you go, not just at the end

## Next Steps After Setup

1. **Review Process:** Read `BLOG_POST_IMPROVEMENT_PROCESS.md`
2. **Prepare:** Set up workspace, bookmark checklists
3. **Start:** Provide first post slug and category
4. **Execute:** Follow complete workflow
5. **Iterate:** Refine process based on learnings

## Support Resources

**Documentation:**

- [Complete Process](BLOG_POST_IMPROVEMENT_PROCESS.md)
- [Process Flow](BLOG_IMPROVEMENT_PROCESS_FLOW.md)
- [Setup Complete](IMPROVEMENT_PROCESS_SETUP_COMPLETE.md)

**Scripts:**

- [Data Collection Scripts](DATA_COLLECTION_SCRIPTS_INVENTORY.md)
- [Analysis Scripts](ANALYSIS_SCRIPTS_GUIDE.md)

**Checklists:**

- [SEO/GEO/AEO](SEO_GEO_AEO_CHECKLIST.md)
- [Content Quality](CONTENT_QUALITY_CHECKLIST_IMPROVEMENT.md)
- [Internal Linking](INTERNAL_LINKING_IMPROVEMENT_GUIDE.md)

## Ready to Start?

When you're ready to improve your first post:

1. **Provide:** Post slug and category
2. **I will:** Follow the complete workflow
3. **You review:** Content and provide feedback
4. **We iterate:** Until perfect

**Let's create amazing content! 🚀**