opencode-skill/SEO_SKILLS_INSTALLATION_GUIDE.md

🚀 SEO Multi-Channel Skills - Installation & Testing Guide

Last Updated: 2026-03-08
Status: ✅ Ready for Testing

---

📦 INSTALLATION

Step 1: Install Python Dependencies

# Navigate to skills directory
cd /Users/kunthawatgreethong/Gitea/opencode-skill/skills

# Option A: Install all at once (recommended)
pip install "pythainlp[default]" pyyaml python-dotenv pandas aiohttp tqdm rich markdown python-frontmatter GitPython Pillow

# Option B: Install per skill
pip install -r seo-multi-channel/scripts/requirements.txt
pip install -r seo-analyzers/scripts/requirements.txt

Step 2: Verify Installation

# Test PyThaiNLP
python3 -c "from pythainlp import word_tokenize; print(word_tokenize('บริการ podcast hosting'))"

# Expected output: ['บริการ', ' ', 'podcast', ' ', 'hosting']

Step 3: Install with Conda (Alternative)

# If using conda instead of pip
conda install pythainlp
pip install pyyaml python-dotenv pandas tqdm rich

---

🧪 TESTING COMMANDS

Test 1: Keyword Analyzer (seo-analyzers)

cd /Users/kunthawatgreethong/Gitea/opencode-skill/skills/seo-analyzers/scripts

python3 thai_keyword_analyzer.py \
  --text "บริการ podcast hosting ที่ดีที่สุดช่วยให้คุณเผยแพร่ podcast ไปยัง Apple Podcasts, Spotify ได้ง่าย" \
  --keyword "บริการ podcast" \
  --language th

Expected Output:

📊 Keyword Analysis Results

Keyword: บริการ podcast
Word Count: 15
Occurrences: 2
Density: 13.33% (target: 1.0-1.5%)
Status: too_high

💡 Recommendations:
  • ลดการใช้คำหลักลง อาจถูกมองว่า keyword stuffing

---

Test 2: Readability Analyzer (seo-analyzers)

cd /Users/kunthawatgreethong/Gitea/opencode-skill/skills/seo-analyzers/scripts

python3 thai_readability.py \
  --text "มาเริ่ม podcast กันเลย! ไม่ต้องรอให้พร้อม 100% แค่มีไอเดียดีๆ กับไมค์หนึ่งอัน คุณก็เริ่มต้นได้แล้ว" \
  --output text

Expected Output:

📖 Thai Readability Analysis

Sentence Count: 3
Word Count: 28
Avg Sentence Length: 9.3 words

Grade Level: ง่าย (ม.6-ม.9)
Formality: กันเอง (Casual)

Readability Score: 75/100

---

Test 3: Content Quality Scorer (seo-analyzers)

cd /Users/kunthawatgreethong/Gitea/opencode-skill/skills/seo-analyzers/scripts

python3 content_quality_scorer.py \
  --text "# คู่มือ Podcast Hosting

บริการ podcast hosting เป็นสิ่งสำคัญสำหรับ podcaster ทุกคน..." \
  --keyword "podcast hosting" \
  --output text

Expected Output:

⭐ Content Quality Score

Overall Score: 65.0/100
Status: fair
Action: Address priority fixes

Category Scores:
  • Keyword Optimization: 15/25
  • Readability: 18/25
  • Structure: 17/25
  • Brand Voice: 15/25

---

Test 4: Multi-Channel Generation (seo-multi-channel)

cd /Users/kunthawatgreethong/Gitea/opencode-skill/skills/seo-multi-channel/scripts

python3 generate_content.py \
  --topic "บริการ podcast hosting" \
  --channels facebook google_ads blog \
  --language th \
  --output test-output

Expected Output:

🎯 Generating content for: บริการ podcast hosting
📱 Channels: facebook, google_ads, blog
🌐 Language: th

  Generating facebook...
  [Image Generation] Would generate image for facebook
    Topic: บริการ podcast hosting, Type: social
    
  Generating google_ads...
  Generating blog...

✅ Results saved to: output/บริการ-podcast-hosting/results.json

📊 Summary:
  Topic: บริการ podcast hosting
  Channels generated: 3
    - facebook: 5 variations
    - google_ads: 3 variations
    - blog: 1 variations

✨ Done!

---

Test 5: Create Context Files (seo-context)

cd /Users/kunthawatgreethong/Gitea/opencode-skill/skills/seo-context/scripts

python3 context_manager.py \
  --create \
  --project "/Users/kunthawatgreethong/Gitea/opencode-skill/test-website" \
  --industry "podcast" \
  --formality "normal"

OR using --action:

python3 context_manager.py \
  --action create \
  --project "/Users/kunthawatgreethong/Gitea/opencode-skill/test-website" \
  --industry "podcast"

Expected Output:

📝 Context Manager
Project: /Users/kunthawatgreethong/Gitea/opencode-skill/test-website

Creating context files...
Industry: podcast
Audience: Thai audience
Formality: normal

✅ Context created successfully!

📁 Created files:
  ✓ brand-voice.md
  ✓ target-keywords.md
  ✓ seo-guidelines.md
  ✓ internal-links-map.md
  ✓ data-services.json
  ✓ style-guide.md

📍 Location: /Users/kunthawatgreethong/Gitea/opencode-skill/test-website/context

---

🐛 TROUBLESHOOTING

Error: No module named 'pythainlp'

# Solution: Install PyThaiNLP
pip install pythainlp

# Or with conda
conda install pythainlp

Error: yaml.parser.ParserError

# Solution: Template files have been fixed
# Pull latest version or manually fix YAML syntax
# Check that template values don't have unquoted text with special chars

Error: unrecognized arguments: --create

# Solution: Use either --create flag OR --action create
python3 context_manager.py --create --project ./my-website

# OR
python3 context_manager.py --action create --project ./my-website

Error: PyThaiNLP download failed

# Solution: Skip download - basic tokenizers work without it
# PyThaiNLP includes built-in tokenizers that work immediately
pip install pythainlp
# That's enough for basic functionality

Thai text displays as garbage characters

# Solution: Ensure UTF-8 encoding
export PYTHONIOENCODING=utf-8
python3 your_script.py

---

📊 EXPECTED BEHAVIOR

What Works Now:

✅ Thai keyword density analysis
✅ Thai readability scoring
✅ Content quality scoring (0-100)
✅ Multi-channel content generation (structure)
✅ Context file creation
✅ YAML template loading
✅ CLI argument parsing

What's Placeholder:

⏳ Actual content generation (returns template structure)
⏳ Image generation/edit integration (design ready)
⏳ Website auto-publish (design ready)
⏳ API connectors for analytics (manager pattern ready)

---

🎯 NEXT STEPS AFTER TESTING

1. Run all 5 tests above
2. Report any bugs (unexpected errors)
3. Test with your real content
4. Customize templates for your brand voice
5. Integrate with actual LLM for content generation (future)

---

📞 SUPPORT

If you encounter issues:

1. Check error message carefully
2. Verify all dependencies installed
3. Try with simple Thai text first
4. Check file encoding is UTF-8
5. Report bug with full error traceback

---

All core features are implemented and ready for testing! 🎉