Auto-sync from website-creator
This commit is contained in:
Kunthawat Greethong
305
SEO_SKILLS_INSTALLATION_GUIDE.md
Normal file
305
SEO_SKILLS_INSTALLATION_GUIDE.md
Normal file
@@ -0,0 +1,305 @@
|
||||
# 🚀 SEO Multi-Channel Skills - Installation & Testing Guide
|
||||
|
||||
**Last Updated:** 2026-03-08
|
||||
**Status:** ✅ Ready for Testing
|
||||
|
||||
---
|
||||
|
||||
## 📦 INSTALLATION
|
||||
|
||||
### **Step 1: Install Python Dependencies**
|
||||
|
||||
```bash
|
||||
# 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**
|
||||
|
||||
```bash
|
||||
# Test PyThaiNLP
|
||||
python3 -c "from pythainlp import word_tokenize; print(word_tokenize('บริการ podcast hosting'))"
|
||||
|
||||
# Expected output: ['บริการ', ' ', 'podcast', ' ', 'hosting']
|
||||
```
|
||||
|
||||
### **Step 3: Install with Conda (Alternative)**
|
||||
|
||||
```bash
|
||||
# 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)**
|
||||
|
||||
```bash
|
||||
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)**
|
||||
|
||||
```bash
|
||||
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)**
|
||||
|
||||
```bash
|
||||
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)**
|
||||
|
||||
```bash
|
||||
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)**
|
||||
|
||||
```bash
|
||||
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:**
|
||||
|
||||
```bash
|
||||
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'**
|
||||
|
||||
```bash
|
||||
# Solution: Install PyThaiNLP
|
||||
pip install pythainlp
|
||||
|
||||
# Or with conda
|
||||
conda install pythainlp
|
||||
```
|
||||
|
||||
### **Error: yaml.parser.ParserError**
|
||||
|
||||
```bash
|
||||
# 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**
|
||||
|
||||
```bash
|
||||
# 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**
|
||||
|
||||
```bash
|
||||
# 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**
|
||||
|
||||
```bash
|
||||
# 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!** 🎉
|
||||
Reference in New Issue
Block a user