Auto-sync from website-creator
This commit is contained in:
Kunthawat Greethong
335
skills/seo-context/SKILL.md
Normal file
335
skills/seo-context/SKILL.md
Normal file
@@ -0,0 +1,335 @@
|
||||
---
|
||||
name: seo-context
|
||||
description: Manage per-project context files (brand voice, keywords, guidelines). Each website has its own context/ folder in the website repo.
|
||||
---
|
||||
|
||||
# 📝 SEO Context - Per-Project Configuration
|
||||
|
||||
**Skill Name:** `seo-context`
|
||||
**Category:** `quick`
|
||||
**Load Skills:** `[]`
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Purpose
|
||||
|
||||
Manage context files for each website project:
|
||||
|
||||
- ✅ **brand-voice.md** - Brand voice, tone, messaging (Thai + English)
|
||||
- ✅ **target-keywords.md** - Keyword clusters by intent
|
||||
- ✅ **seo-guidelines.md** - SEO requirements (Thai-specific)
|
||||
- ✅ **internal-links-map.md** - Key pages for internal linking
|
||||
- ✅ **data-services.json** - Analytics service configurations
|
||||
- ✅ **style-guide.md** - Writing style, formality levels
|
||||
|
||||
**Location:** Each website has its own `context/` folder in the repo root.
|
||||
|
||||
**Use Cases:**
|
||||
1. Create context files for new website project
|
||||
2. Update context from existing content
|
||||
3. Analyze current brand voice from published content
|
||||
4. Generate keyword clusters from performance data
|
||||
5. Export/import context between projects
|
||||
|
||||
---
|
||||
|
||||
## 📁 Context File Structure
|
||||
|
||||
```
|
||||
website-name/
|
||||
└── context/
|
||||
├── brand-voice.md # Brand voice, tone, formality
|
||||
├── target-keywords.md # Keyword clusters, search intent
|
||||
├── seo-guidelines.md # Thai SEO requirements
|
||||
├── internal-links-map.md # Priority pages for linking
|
||||
├── data-services.json # Analytics configurations
|
||||
└── style-guide.md # Writing style, examples
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Context File Templates
|
||||
|
||||
### **brand-voice.md**
|
||||
|
||||
```markdown
|
||||
# Brand Voice & Messaging
|
||||
|
||||
## Voice Pillars
|
||||
|
||||
### 1. เป็นกันเอง (Casual/Friendly)
|
||||
- **What it means**: พูดเหมือนเพื่อนช่วยเพื่อน ไม่ทางการเกินไป
|
||||
- **Example**: "มาเริ่ม podcast กันเลย! ไม่ต้องรอให้พร้อม 100%"
|
||||
- **Avoid**: ภาษาทางการแบบเอกสารราชการ
|
||||
|
||||
### 2. น่าเชื่อถือ (Trustworthy)
|
||||
- **What it means**: ให้ข้อมูลที่ถูกต้อง มีหลักฐานรองรับ
|
||||
- **Example**: "จากการทดสอบ 10+ แพลตฟอร์ม เราพบว่า..."
|
||||
- **Avoid**: อ้างอิงไม่มีแหล่งที่มา
|
||||
|
||||
## Tone Guidelines
|
||||
|
||||
**General Tone**: เป็นกันเอง แต่ยังคงความน่าเชื่อถือ
|
||||
|
||||
**Content Types**:
|
||||
- How-To Guides: สอนเป็นขั้นตอน ใช้ภาษาง่ายๆ
|
||||
- Review Content: เปรียบเทียบตรงไปตรงมา มีข้อมูลสนับสนุน
|
||||
- News/Updates: กระชับ ได้ใจความ
|
||||
|
||||
## Formality Level
|
||||
|
||||
**Default**: ปกติ (Normal) - ผสมกันเองและทางการตามเหมาะสม
|
||||
|
||||
**For Social Media**: กันเอง (Casual) - ใช้คำฟุ่มเฟือยได้บ้าง
|
||||
|
||||
**For Blog**: ปกติ (Normal) - อ่านง่ายแต่ยังคงความน่าเชื่อถือ
|
||||
```
|
||||
|
||||
### **target-keywords.md**
|
||||
|
||||
```markdown
|
||||
# Target Keywords
|
||||
|
||||
## Primary Keyword Clusters
|
||||
|
||||
### Cluster: Podcast Hosting
|
||||
|
||||
**Intent**: Commercial Investigation
|
||||
|
||||
**Keywords (Thai)**:
|
||||
- บริการ podcast
|
||||
- host podcast
|
||||
- แพลตฟอร์ม podcast
|
||||
- podcast hosting ที่ดีที่สุด
|
||||
|
||||
**Keywords (English)**:
|
||||
- podcast hosting
|
||||
- best podcast platform
|
||||
- podcast host
|
||||
|
||||
**Search Volume**: 2,900/month (TH)
|
||||
|
||||
**Difficulty**: Medium
|
||||
|
||||
## Secondary Clusters
|
||||
|
||||
### Cluster: Podcast Equipment
|
||||
|
||||
[Similar structure]
|
||||
```
|
||||
|
||||
### **seo-guidelines.md**
|
||||
|
||||
```markdown
|
||||
# SEO Guidelines (Thai-Specific)
|
||||
|
||||
## Content Requirements
|
||||
|
||||
### Word Count
|
||||
- **Thai**: 1,500-3,000 words
|
||||
- **English**: 2,000-3,000 words
|
||||
|
||||
### Keyword Density
|
||||
- **Thai**: 1.0-1.5%
|
||||
- **English**: 1.5-2.0%
|
||||
|
||||
### Readability
|
||||
- **Thai Grade Level**: ม.6-ม.12
|
||||
- **Formality**:Auto-detect from brand-voice.md
|
||||
|
||||
## Meta Elements
|
||||
|
||||
### Title
|
||||
- Length: 50-60 characters
|
||||
- Must include primary keyword
|
||||
- Thai-friendly (no truncation issues)
|
||||
|
||||
### Description
|
||||
- Length: 150-160 characters
|
||||
- Include CTA
|
||||
- Thai or English matching content language
|
||||
|
||||
## URL Slug
|
||||
- Format: lowercase-with-hyphens
|
||||
- Thai: Keep Thai or use transliteration
|
||||
- Max 5 words
|
||||
```
|
||||
|
||||
### **data-services.json**
|
||||
|
||||
```json
|
||||
{
|
||||
"ga4": {
|
||||
"enabled": true,
|
||||
"property_id": "G-XXXXXXXXXX",
|
||||
"credentials_path": "./credentials/ga4.json"
|
||||
},
|
||||
"gsc": {
|
||||
"enabled": true,
|
||||
"site_url": "https://yoursite.com",
|
||||
"credentials_path": "./credentials/gsc.json"
|
||||
},
|
||||
"dataforseo": {
|
||||
"enabled": false,
|
||||
"login": "your_login",
|
||||
"password": "your_password"
|
||||
},
|
||||
"umami": {
|
||||
"enabled": true,
|
||||
"api_url": "https://analytics.yoursite.com",
|
||||
"api_key": "your_api_key"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Workflows
|
||||
|
||||
### **Workflow 1: Create Context for New Project**
|
||||
|
||||
```python
|
||||
Input: Website name, industry, target audience
|
||||
Process:
|
||||
1. Create context/ folder
|
||||
2. Generate brand-voice.md from industry standards
|
||||
3. Create target-keywords.md with initial research
|
||||
4. Set up seo-guidelines.md with Thai-specific rules
|
||||
5. Create empty data-services.json
|
||||
Output:
|
||||
- Complete context/ folder structure
|
||||
- Ready for customization
|
||||
```
|
||||
|
||||
### **Workflow 2: Analyze Existing Content**
|
||||
|
||||
```python
|
||||
Input: Website URL or content files
|
||||
Process:
|
||||
1. Scrape published content
|
||||
2. Analyze brand voice (formality, tone)
|
||||
3. Extract keyword usage
|
||||
4. Identify top-performing topics
|
||||
5. Update context files
|
||||
Output:
|
||||
- Updated brand-voice.md (data-driven)
|
||||
- target-keywords.md with actual usage
|
||||
- Recommendations
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📁 Commands
|
||||
|
||||
### **Create Context for New Project:**
|
||||
|
||||
```bash
|
||||
python3 skills/seo-context/scripts/context_manager.py \
|
||||
--create \
|
||||
--project "./my-website" \
|
||||
--industry "podcast" \
|
||||
--audience "Thai podcasters" \
|
||||
--formality "normal"
|
||||
```
|
||||
|
||||
### **Analyze Existing Content:**
|
||||
|
||||
```bash
|
||||
python3 skills/seo-context/scripts/context_manager.py \
|
||||
--analyze \
|
||||
--project "./my-website" \
|
||||
--content-path "./published-articles/" \
|
||||
--language th
|
||||
```
|
||||
|
||||
### **Update from Performance Data:**
|
||||
|
||||
```bash
|
||||
python3 skills/seo-context/scripts/context_manager.py \
|
||||
--update-keywords \
|
||||
--project "./my-website" \
|
||||
--gsc-data "./gsc-export.csv"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Environment Variables
|
||||
|
||||
**None required** - all configuration is per-project in context files.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Output Examples
|
||||
|
||||
### **Create Context Output:**
|
||||
|
||||
```
|
||||
✅ Context created for: my-website
|
||||
📁 Location: ./my-website/context/
|
||||
|
||||
Created files:
|
||||
✓ brand-voice.md (industry: podcast, formality: normal)
|
||||
✓ target-keywords.md (3 initial clusters)
|
||||
✓ seo-guidelines.md (Thai-specific)
|
||||
✓ internal-links-map.md (empty, ready to populate)
|
||||
✓ data-services.json (all services disabled)
|
||||
✓ style-guide.md (templates)
|
||||
|
||||
Next steps:
|
||||
1. Customize brand-voice.md with your actual voice
|
||||
2. Add target keywords based on your research
|
||||
3. Configure analytics services in data-services.json
|
||||
```
|
||||
|
||||
### **Analyze Content Output:**
|
||||
|
||||
```
|
||||
📊 Analyzing existing content...
|
||||
|
||||
Found 25 articles (Thai: 18, English: 7)
|
||||
|
||||
Brand Voice Analysis:
|
||||
- Formality: 65% Normal, 30% Casual, 5% Formal
|
||||
- Recommended: ปกติ (Normal)
|
||||
- Tone: เป็นกันเอง, น่าเชื่อถือ
|
||||
|
||||
Top Keywords:
|
||||
1. บริการ podcast (42 occurrences)
|
||||
2. podcast hosting (38 occurrences)
|
||||
3. แพลตฟอร์ม podcast (25 occurrences)
|
||||
|
||||
Recommendations:
|
||||
• เพิ่มคำหลัก "podcast hosting" ใน H2 มากขึ้น
|
||||
• รักษาระดับความเป็นกันแบบนี้ไว้
|
||||
• เพิ่ม internal links ระหว่างบทความ podcast
|
||||
|
||||
✅ Context files updated
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Context File Checklist
|
||||
|
||||
For each project, ensure:
|
||||
|
||||
- [ ] **brand-voice.md** - Voice pillars, tone guidelines, formality level
|
||||
- [ ] **target-keywords.md** - At least 3 keyword clusters with search intent
|
||||
- [ ] **seo-guidelines.md** - Thai word count, density, readability targets
|
||||
- [ ] **internal-links-map.md** - Top 10 pages to link to
|
||||
- [ ] **data-services.json** - At least one analytics service configured
|
||||
- [ ] **style-guide.md** - Writing examples (good and bad)
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Integration with Other Skills
|
||||
|
||||
- **seo-multi-channel:** Loads brand voice for content generation
|
||||
- **seo-analyzers:** Uses seo-guidelines for quality scoring
|
||||
- **seo-data:** Reads data-services.json for analytics connections
|
||||
- **website-creator:** Context in website repo root
|
||||
|
||||
---
|
||||
|
||||
**Use this skill when you need to set up or update context files for a website project.**
|
||||
|
||||
**Each website should have its own context/ folder with all configuration files.**
|
||||
4
skills/seo-context/scripts/.env.example
Normal file
4
skills/seo-context/scripts/.env.example
Normal file
@@ -0,0 +1,4 @@
|
||||
# SEO Context - Environment Variables
|
||||
|
||||
# No environment variables required
|
||||
# All configuration is per-project in context files
|
||||
501
skills/seo-context/scripts/context_manager.py
Normal file
501
skills/seo-context/scripts/context_manager.py
Normal file
@@ -0,0 +1,501 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Context Manager
|
||||
|
||||
Create, update, and manage per-project context files.
|
||||
Each website has its own context/ folder with brand voice, keywords, and guidelines.
|
||||
"""
|
||||
|
||||
import os
|
||||
import json
|
||||
import argparse
|
||||
from pathlib import Path
|
||||
from datetime import datetime
|
||||
from typing import Dict, List, Optional
|
||||
|
||||
|
||||
class ContextManager:
|
||||
"""Manage per-project context files"""
|
||||
|
||||
def __init__(self, project_path: str):
|
||||
self.project_path = project_path
|
||||
self.context_path = os.path.join(project_path, 'context')
|
||||
|
||||
# Ensure context directory exists
|
||||
os.makedirs(self.context_path, exist_ok=True)
|
||||
|
||||
def create_context(self, industry: str = 'general', audience: str = 'Thai audience',
|
||||
formality: str = 'normal') -> Dict[str, str]:
|
||||
"""Create complete context structure for new project"""
|
||||
created_files = {}
|
||||
|
||||
# 1. brand-voice.md
|
||||
brand_voice_content = self._generate_brand_voice(industry, audience, formality)
|
||||
brand_voice_path = os.path.join(self.context_path, 'brand-voice.md')
|
||||
with open(brand_voice_path, 'w', encoding='utf-8') as f:
|
||||
f.write(brand_voice_content)
|
||||
created_files['brand-voice.md'] = brand_voice_path
|
||||
|
||||
# 2. target-keywords.md
|
||||
keywords_content = self._generate_target_keywords(industry)
|
||||
keywords_path = os.path.join(self.context_path, 'target-keywords.md')
|
||||
with open(keywords_path, 'w', encoding='utf-8') as f:
|
||||
f.write(keywords_content)
|
||||
created_files['target-keywords.md'] = keywords_path
|
||||
|
||||
# 3. seo-guidelines.md
|
||||
seo_guidelines = self._generate_seo_guidelines()
|
||||
seo_guidelines_path = os.path.join(self.context_path, 'seo-guidelines.md')
|
||||
with open(seo_guidelines_path, 'w', encoding='utf-8') as f:
|
||||
f.write(seo_guidelines)
|
||||
created_files['seo-guidelines.md'] = seo_guidelines_path
|
||||
|
||||
# 4. internal-links-map.md
|
||||
links_map = "# Internal Links Map\n\nAdd your priority pages here:\n\n## Homepage\n- URL: /\n- Priority: High\n\n## Key Pages\n- Add your key pages here...\n"
|
||||
links_map_path = os.path.join(self.context_path, 'internal-links-map.md')
|
||||
with open(links_map_path, 'w', encoding='utf-8') as f:
|
||||
f.write(links_map)
|
||||
created_files['internal-links-map.md'] = links_map_path
|
||||
|
||||
# 5. data-services.json
|
||||
data_services = {
|
||||
'ga4': {'enabled': False, 'property_id': '', 'credentials_path': ''},
|
||||
'gsc': {'enabled': False, 'site_url': '', 'credentials_path': ''},
|
||||
'dataforseo': {'enabled': False, 'login': '', 'password': ''},
|
||||
'umami': {'enabled': False, 'api_url': '', 'api_key': ''}
|
||||
}
|
||||
data_services_path = os.path.join(self.context_path, 'data-services.json')
|
||||
with open(data_services_path, 'w', encoding='utf-8') as f:
|
||||
json.dump(data_services, f, indent=2)
|
||||
created_files['data-services.json'] = data_services_path
|
||||
|
||||
# 6. style-guide.md
|
||||
style_guide = self._generate_style_guide()
|
||||
style_guide_path = os.path.join(self.context_path, 'style-guide.md')
|
||||
with open(style_guide_path, 'w', encoding='utf-8') as f:
|
||||
f.write(style_guide)
|
||||
created_files['style-guide.md'] = style_guide_path
|
||||
|
||||
return created_files
|
||||
|
||||
def _generate_brand_voice(self, industry: str, audience: str, formality: str) -> str:
|
||||
"""Generate brand-voice.md template"""
|
||||
formality_th = {
|
||||
'casual': 'กันเอง (Casual)',
|
||||
'normal': 'ปกติ (Normal)',
|
||||
'formal': 'เป็นทางการ (Formal)'
|
||||
}.get(formality, 'ปกติ (Normal)')
|
||||
|
||||
return f"""# Brand Voice & Messaging
|
||||
|
||||
**Industry:** {industry}
|
||||
**Target Audience:** {audience}
|
||||
**Default Formality:** {formality_th}
|
||||
**Created:** {datetime.now().strftime('%Y-%m-%d')}
|
||||
|
||||
---
|
||||
|
||||
## Voice Pillars
|
||||
|
||||
### 1. เป็นกันเอง (Friendly)
|
||||
- **What it means**: พูดเหมือนเพื่อนช่วยเพื่อน ไม่ทางการเกินไป
|
||||
- **Example**: "มาเริ่มกันเลย! ไม่ต้องรอให้พร้อม 100%"
|
||||
- **Avoid**: ภาษาทางการแบบเอกสารราชการ
|
||||
|
||||
### 2. น่าเชื่อถือ (Trustworthy)
|
||||
- **What it means**: ให้ข้อมูลที่ถูกต้อง มีหลักฐานรองรับ
|
||||
- **Example**: "จากการทดสอบ เราพบว่า..."
|
||||
- **Avoid**: อ้างอิงไม่มีแหล่งที่มา
|
||||
|
||||
### 3. มีประโยชน์ (Helpful)
|
||||
- **What it means**: มุ่งให้ค่ากับผู้อ่าน ช่วยแก้ปัญหา
|
||||
- **Example**: "ทำตามขั้นตอนนี้ คุณจะได้..."
|
||||
- **Avoid**: ขายของเกินไปโดยไม่ให้คุณค่า
|
||||
|
||||
---
|
||||
|
||||
## Tone Guidelines
|
||||
|
||||
### General Tone
|
||||
|
||||
พูดแบบเพื่อนที่หวังดี อธิบายเรื่องยากให้ง่าย
|
||||
|
||||
### By Content Type
|
||||
|
||||
**How-To Guides**:
|
||||
- ใช้ภาษาง่ายๆ
|
||||
- เป็นขั้นตอน
|
||||
- มีตัวอย่างประกอบ
|
||||
|
||||
**Review Content**:
|
||||
- เปรียบเทียบตรงไปตรงมา
|
||||
- มีข้อมูลสนับสนุน
|
||||
- บอกข้อดีข้อเสีย
|
||||
|
||||
**News/Updates**:
|
||||
- กระชับ ได้ใจความ
|
||||
- เน้นข้อมูลสำคัญ
|
||||
- อัปเดตทันทีที่มีข้อมูลใหม่
|
||||
|
||||
---
|
||||
|
||||
## Formality Level
|
||||
|
||||
**Default**: {formality_th}
|
||||
|
||||
**Social Media**: กันเอง (Casual) - ใช้คำฟุ่มเฟือยได้บ้าง
|
||||
|
||||
**Blog**: ปกติ (Normal) - อ่านง่ายแต่ยังคงความน่าเชื่อถือ
|
||||
|
||||
**Product Pages**: ปกติถึงเป็นทางการเล็กน้อย - ให้ความน่าเชื่อถือ
|
||||
|
||||
---
|
||||
|
||||
## Messaging Framework
|
||||
|
||||
### Core Messages
|
||||
|
||||
1. **แก้ปัญหาจริง**: เน้นแก้ปัญหาที่ลูกค้าเจอจริง
|
||||
2. **ไม่ซับซ้อน**: อธิบายเรื่องยากให้ง่าย
|
||||
3. **น่าเชื่อถือ**: มีหลักฐาน ข้อมูลรองรับ
|
||||
|
||||
### Value Propositions
|
||||
|
||||
**For Beginners**: เริ่มต้นง่าย ไม่ต้องมีพื้นฐานก็ทำได้
|
||||
|
||||
**For Professionals**: เครื่องมือครบ จบในที่เดียว
|
||||
|
||||
---
|
||||
|
||||
## Writing Examples
|
||||
|
||||
### Excellent Voice ✅
|
||||
|
||||
"มาเริ่ม podcast กันเลย! ไม่ต้องรอให้พร้อม 100% แค่มีไอเดียดีๆ กับไมค์หนึ่งอัน คุณก็เริ่มต้นได้แล้ว ส่วนเรื่องเทคนิคที่เหลือ เราช่วยคุณเอง"
|
||||
|
||||
**Why this works**:
|
||||
- เป็นกันเอง
|
||||
- ให้กำลังใจ
|
||||
- ไม่ข่มขู่ด้วยความยาก
|
||||
|
||||
### Not Our Voice ❌
|
||||
|
||||
"การดำเนินการสร้าง podcast จำเป็นต้องมีการเตรียมการอย่างรอบคอบและใช้อุปกรณ์ที่มีคุณภาพสูง"
|
||||
|
||||
**Why this fails**:
|
||||
- เป็นทางการเกินไป
|
||||
- ดูน่ากลัว
|
||||
- ไม่เป็นมิตร
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** {datetime.now().strftime('%Y-%m-%d')}
|
||||
"""
|
||||
|
||||
def _generate_target_keywords(self, industry: str) -> str:
|
||||
"""Generate target-keywords.md template"""
|
||||
return f"""# Target Keywords
|
||||
|
||||
**Industry:** {industry}
|
||||
**Created:** {datetime.now().strftime('%Y-%m-%d')}
|
||||
|
||||
---
|
||||
|
||||
## Primary Keyword Clusters
|
||||
|
||||
### Cluster 1: [Main Topic]
|
||||
|
||||
**Intent:** Commercial Investigation
|
||||
|
||||
**Keywords (Thai)**:
|
||||
- [Keyword 1]
|
||||
- [Keyword 2]
|
||||
- [Keyword 3]
|
||||
|
||||
**Keywords (English)**:
|
||||
- [Keyword 1]
|
||||
- [Keyword 2]
|
||||
- [Keyword 3]
|
||||
|
||||
**Search Volume:** TBD (research needed)
|
||||
|
||||
**Difficulty:** Medium
|
||||
|
||||
---
|
||||
|
||||
### Cluster 2: [Secondary Topic]
|
||||
|
||||
[Same structure]
|
||||
|
||||
---
|
||||
|
||||
## Keyword Mapping
|
||||
|
||||
| Keyword | Intent | Priority | Target URL |
|
||||
|---------|--------|----------|------------|
|
||||
| [keyword] | Commercial | High | /page |
|
||||
| [keyword] | Informational | Medium | /blog |
|
||||
|
||||
---
|
||||
|
||||
**Notes:**
|
||||
- Update keyword data from GSC monthly
|
||||
- Add new clusters as business expands
|
||||
- Track ranking performance
|
||||
|
||||
**Last Updated:** {datetime.now().strftime('%Y-%m-%d')}
|
||||
"""
|
||||
|
||||
def _generate_seo_guidelines(self) -> str:
|
||||
"""Generate seo-guidelines.md"""
|
||||
return f"""# SEO Guidelines (Thai-Specific)
|
||||
|
||||
**Created:** {datetime.now().strftime('%Y-%m-%d')}
|
||||
|
||||
---
|
||||
|
||||
## Content Requirements
|
||||
|
||||
### Word Count
|
||||
- **Thai:** 1,500-3,000 words
|
||||
- **English:** 2,000-3,000 words
|
||||
|
||||
### Keyword Density
|
||||
- **Thai:** 1.0-1.5%
|
||||
- **English:** 1.5-2.0%
|
||||
|
||||
### Readability
|
||||
- **Thai Grade Level:** ม.6-ม.12
|
||||
- **Avg Sentence Length:** 15-25 words (Thai)
|
||||
- **Formality:** Auto-detect from brand-voice.md
|
||||
|
||||
---
|
||||
|
||||
## Meta Elements
|
||||
|
||||
### Title Tag
|
||||
- **Length:** 50-60 characters
|
||||
- **Must include:** Primary keyword
|
||||
- **Format:** [Keyword]: [Benefit] | [Brand]
|
||||
|
||||
### Meta Description
|
||||
- **Length:** 150-160 characters
|
||||
- **Must include:** Keyword + CTA
|
||||
- **Format:** [Problem]? [Solution]. [CTA].
|
||||
|
||||
### URL Slug
|
||||
- **Format:** lowercase-with-hyphens
|
||||
- **Thai:** Keep Thai or use transliteration
|
||||
- **Max:** 5 words
|
||||
|
||||
---
|
||||
|
||||
## Content Structure
|
||||
|
||||
### Headings
|
||||
- **H1:** 1 per page, includes keyword
|
||||
- **H2:** 4-7 per article
|
||||
- **H3:** As needed for subsections
|
||||
|
||||
### Internal Links
|
||||
- **Minimum:** 3 per article
|
||||
- **Maximum:** 7 per article
|
||||
- **Anchor text:** Descriptive with keywords
|
||||
|
||||
### External Links
|
||||
- **Minimum:** 2 per article
|
||||
- **Authority sources only**
|
||||
- **No competitor links**
|
||||
|
||||
---
|
||||
|
||||
## Images
|
||||
|
||||
### Requirements
|
||||
- **Alt text:** Descriptive with keywords
|
||||
- **File names:** descriptive-name.jpg
|
||||
- **Compression:** WebP preferred
|
||||
- **Size:** Optimized for web
|
||||
|
||||
---
|
||||
|
||||
## Quality Checklist
|
||||
|
||||
Before publishing:
|
||||
- [ ] Keyword in H1
|
||||
- [ ] Keyword in first 100 words
|
||||
- [ ] Keyword in 2+ H2s
|
||||
- [ ] Keyword density 1.0-1.5% (Thai)
|
||||
- [ ] 3-5 internal links
|
||||
- [ ] 2-3 external authority links
|
||||
- [ ] Meta title 50-60 chars
|
||||
- [ ] Meta description 150-160 chars
|
||||
- [ ] Images have alt text
|
||||
- [ ] Readability checked
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** {datetime.now().strftime('%Y-%m-%d')}
|
||||
"""
|
||||
|
||||
def _generate_style_guide(self) -> str:
|
||||
"""Generate style-guide.md"""
|
||||
return f"""# Writing Style Guide
|
||||
|
||||
**Created:** {datetime.now().strftime('%Y-%m-%d')}
|
||||
|
||||
---
|
||||
|
||||
## General Principles
|
||||
|
||||
1. **Clear over clever** - ความชัดเจนสำคัญกว่าการเล่นคำ
|
||||
2. **Helpful over promotional** - ให้ค่ามากกว่าขาย
|
||||
3. **Conversational over formal** - พูดคุยมากกว่าทางการ
|
||||
|
||||
---
|
||||
|
||||
## Sentence Structure
|
||||
|
||||
### Thai Sentences
|
||||
- **Average:** 15-25 words
|
||||
- **Active voice:** 80%+
|
||||
- **Short paragraphs:** 2-4 sentences
|
||||
|
||||
### Formatting
|
||||
- **Use bullets:** For lists of 3+ items
|
||||
- **Use bold:** For key concepts
|
||||
- **Use white space:** Generously
|
||||
|
||||
---
|
||||
|
||||
## Word Choice
|
||||
|
||||
### Use This, Not That
|
||||
|
||||
| Say This | Not That |
|
||||
|----------|----------|
|
||||
| เริ่มเลย | ดำเนินการเริ่มต้น |
|
||||
| ง่ายมาก | ไม่มีความซับซ้อน whatsoever |
|
||||
| ช่วยคุณ | ให้ความช่วยเหลือแก่ท่าน |
|
||||
|
||||
---
|
||||
|
||||
## Examples
|
||||
|
||||
### Good Introduction
|
||||
|
||||
"คุณกำลังมองหาวิธีเริ่มต้น podcast ใช่ไหม? บทความนี้จะบอกทุกอย่างที่ต้องรู้ ตั้งแต่การเลือกอุปกรณ์จนถึงการเผยแพร่"
|
||||
|
||||
**Why it works:**
|
||||
- ตรงประเด็น
|
||||
- บอกสิ่งที่ผู้อ่านจะได้
|
||||
- อ่านเข้าใจง่าย
|
||||
|
||||
---
|
||||
|
||||
## Thai-Specific Guidelines
|
||||
|
||||
### Particles
|
||||
- Use ครับ/ค่ะ appropriately
|
||||
- Don't overuse นะ, จ้ะ in formal content
|
||||
- Match formality level to content type
|
||||
|
||||
### Transliteration
|
||||
- Use consistent Thai spelling for English terms
|
||||
- Example: "podcast" = "พ็อดคาสท์" (not พอดแคสต์, พ็อดคาสต์)
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** {datetime.now().strftime('%Y-%m-%d')}
|
||||
"""
|
||||
|
||||
|
||||
def main():
|
||||
"""Main entry point"""
|
||||
parser = argparse.ArgumentParser(
|
||||
description='Manage per-project context files'
|
||||
)
|
||||
|
||||
parser.add_argument(
|
||||
'--action',
|
||||
choices=['create', 'analyze', 'update-keywords'],
|
||||
default='create',
|
||||
help='Action to perform'
|
||||
)
|
||||
|
||||
parser.add_argument(
|
||||
'--create',
|
||||
action='store_true',
|
||||
help='Create context files (shortcut for --action create)'
|
||||
)
|
||||
|
||||
parser.add_argument(
|
||||
'--project', '-p',
|
||||
required=True,
|
||||
help='Path to project folder'
|
||||
)
|
||||
|
||||
parser.add_argument(
|
||||
'--industry', '-i',
|
||||
default='general',
|
||||
help='Industry (for create action)'
|
||||
)
|
||||
|
||||
parser.add_argument(
|
||||
'--audience', '-a',
|
||||
default='Thai audience',
|
||||
help='Target audience (for create action)'
|
||||
)
|
||||
|
||||
parser.add_argument(
|
||||
'--formality', '-f',
|
||||
choices=['casual', 'normal', 'formal'],
|
||||
default='normal',
|
||||
help='Formality level (for create action)'
|
||||
)
|
||||
|
||||
args = parser.parse_args()
|
||||
|
||||
# Handle --create shortcut
|
||||
if args.create:
|
||||
args.action = 'create'
|
||||
|
||||
# Initialize manager
|
||||
print(f"\n📝 Context Manager")
|
||||
print(f"Project: {args.project}\n")
|
||||
|
||||
manager = ContextManager(args.project)
|
||||
|
||||
if args.action == 'create':
|
||||
print(f"Creating context files...")
|
||||
print(f"Industry: {args.industry}")
|
||||
print(f"Audience: {args.audience}")
|
||||
print(f"Formality: {args.formality}\n")
|
||||
|
||||
created = manager.create_context(args.industry, args.audience, args.formality)
|
||||
|
||||
print(f"\n✅ Context created successfully!")
|
||||
print(f"\n📁 Created files:")
|
||||
for filename, path in created.items():
|
||||
print(f" ✓ {filename}")
|
||||
|
||||
print(f"\n📍 Location: {manager.context_path}")
|
||||
print(f"\nNext steps:")
|
||||
print(f" 1. Customize brand-voice.md with your actual voice")
|
||||
print(f" 2. Add target keywords based on your research")
|
||||
print(f" 3. Configure analytics in data-services.json")
|
||||
print()
|
||||
|
||||
elif args.action == 'analyze':
|
||||
print("Content analysis not yet implemented.")
|
||||
print("This will analyze existing content and update context files.")
|
||||
print()
|
||||
|
||||
elif args.action == 'update-keywords':
|
||||
print("Keyword update not yet implemented.")
|
||||
print("This will update keywords from GSC data.")
|
||||
print()
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
104
skills/seo-context/scripts/my-website/context/brand-voice.md
Normal file
104
skills/seo-context/scripts/my-website/context/brand-voice.md
Normal file
@@ -0,0 +1,104 @@
|
||||
# Brand Voice & Messaging
|
||||
|
||||
**Industry:** podcast
|
||||
**Target Audience:** Thai audience
|
||||
**Default Formality:** ปกติ (Normal)
|
||||
**Created:** 2026-03-08
|
||||
|
||||
---
|
||||
|
||||
## Voice Pillars
|
||||
|
||||
### 1. เป็นกันเอง (Friendly)
|
||||
- **What it means**: พูดเหมือนเพื่อนช่วยเพื่อน ไม่ทางการเกินไป
|
||||
- **Example**: "มาเริ่มกันเลย! ไม่ต้องรอให้พร้อม 100%"
|
||||
- **Avoid**: ภาษาทางการแบบเอกสารราชการ
|
||||
|
||||
### 2. น่าเชื่อถือ (Trustworthy)
|
||||
- **What it means**: ให้ข้อมูลที่ถูกต้อง มีหลักฐานรองรับ
|
||||
- **Example**: "จากการทดสอบ เราพบว่า..."
|
||||
- **Avoid**: อ้างอิงไม่มีแหล่งที่มา
|
||||
|
||||
### 3. มีประโยชน์ (Helpful)
|
||||
- **What it means**: มุ่งให้ค่ากับผู้อ่าน ช่วยแก้ปัญหา
|
||||
- **Example**: "ทำตามขั้นตอนนี้ คุณจะได้..."
|
||||
- **Avoid**: ขายของเกินไปโดยไม่ให้คุณค่า
|
||||
|
||||
---
|
||||
|
||||
## Tone Guidelines
|
||||
|
||||
### General Tone
|
||||
|
||||
พูดแบบเพื่อนที่หวังดี อธิบายเรื่องยากให้ง่าย
|
||||
|
||||
### By Content Type
|
||||
|
||||
**How-To Guides**:
|
||||
- ใช้ภาษาง่ายๆ
|
||||
- เป็นขั้นตอน
|
||||
- มีตัวอย่างประกอบ
|
||||
|
||||
**Review Content**:
|
||||
- เปรียบเทียบตรงไปตรงมา
|
||||
- มีข้อมูลสนับสนุน
|
||||
- บอกข้อดีข้อเสีย
|
||||
|
||||
**News/Updates**:
|
||||
- กระชับ ได้ใจความ
|
||||
- เน้นข้อมูลสำคัญ
|
||||
- อัปเดตทันทีที่มีข้อมูลใหม่
|
||||
|
||||
---
|
||||
|
||||
## Formality Level
|
||||
|
||||
**Default**: ปกติ (Normal)
|
||||
|
||||
**Social Media**: กันเอง (Casual) - ใช้คำฟุ่มเฟือยได้บ้าง
|
||||
|
||||
**Blog**: ปกติ (Normal) - อ่านง่ายแต่ยังคงความน่าเชื่อถือ
|
||||
|
||||
**Product Pages**: ปกติถึงเป็นทางการเล็กน้อย - ให้ความน่าเชื่อถือ
|
||||
|
||||
---
|
||||
|
||||
## Messaging Framework
|
||||
|
||||
### Core Messages
|
||||
|
||||
1. **แก้ปัญหาจริง**: เน้นแก้ปัญหาที่ลูกค้าเจอจริง
|
||||
2. **ไม่ซับซ้อน**: อธิบายเรื่องยากให้ง่าย
|
||||
3. **น่าเชื่อถือ**: มีหลักฐาน ข้อมูลรองรับ
|
||||
|
||||
### Value Propositions
|
||||
|
||||
**For Beginners**: เริ่มต้นง่าย ไม่ต้องมีพื้นฐานก็ทำได้
|
||||
|
||||
**For Professionals**: เครื่องมือครบ จบในที่เดียว
|
||||
|
||||
---
|
||||
|
||||
## Writing Examples
|
||||
|
||||
### Excellent Voice ✅
|
||||
|
||||
"มาเริ่ม podcast กันเลย! ไม่ต้องรอให้พร้อม 100% แค่มีไอเดียดีๆ กับไมค์หนึ่งอัน คุณก็เริ่มต้นได้แล้ว ส่วนเรื่องเทคนิคที่เหลือ เราช่วยคุณเอง"
|
||||
|
||||
**Why this works**:
|
||||
- เป็นกันเอง
|
||||
- ให้กำลังใจ
|
||||
- ไม่ข่มขู่ด้วยความยาก
|
||||
|
||||
### Not Our Voice ❌
|
||||
|
||||
"การดำเนินการสร้าง podcast จำเป็นต้องมีการเตรียมการอย่างรอบคอบและใช้อุปกรณ์ที่มีคุณภาพสูง"
|
||||
|
||||
**Why this fails**:
|
||||
- เป็นทางการเกินไป
|
||||
- ดูน่ากลัว
|
||||
- ไม่เป็นมิตร
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** 2026-03-08
|
||||
@@ -0,0 +1,22 @@
|
||||
{
|
||||
"ga4": {
|
||||
"enabled": false,
|
||||
"property_id": "",
|
||||
"credentials_path": ""
|
||||
},
|
||||
"gsc": {
|
||||
"enabled": false,
|
||||
"site_url": "",
|
||||
"credentials_path": ""
|
||||
},
|
||||
"dataforseo": {
|
||||
"enabled": false,
|
||||
"login": "",
|
||||
"password": ""
|
||||
},
|
||||
"umami": {
|
||||
"enabled": false,
|
||||
"api_url": "",
|
||||
"api_key": ""
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,10 @@
|
||||
# Internal Links Map
|
||||
|
||||
Add your priority pages here:
|
||||
|
||||
## Homepage
|
||||
- URL: /
|
||||
- Priority: High
|
||||
|
||||
## Key Pages
|
||||
- Add your key pages here...
|
||||
@@ -0,0 +1,88 @@
|
||||
# SEO Guidelines (Thai-Specific)
|
||||
|
||||
**Created:** 2026-03-08
|
||||
|
||||
---
|
||||
|
||||
## Content Requirements
|
||||
|
||||
### Word Count
|
||||
- **Thai:** 1,500-3,000 words
|
||||
- **English:** 2,000-3,000 words
|
||||
|
||||
### Keyword Density
|
||||
- **Thai:** 1.0-1.5%
|
||||
- **English:** 1.5-2.0%
|
||||
|
||||
### Readability
|
||||
- **Thai Grade Level:** ม.6-ม.12
|
||||
- **Avg Sentence Length:** 15-25 words (Thai)
|
||||
- **Formality:** Auto-detect from brand-voice.md
|
||||
|
||||
---
|
||||
|
||||
## Meta Elements
|
||||
|
||||
### Title Tag
|
||||
- **Length:** 50-60 characters
|
||||
- **Must include:** Primary keyword
|
||||
- **Format:** [Keyword]: [Benefit] | [Brand]
|
||||
|
||||
### Meta Description
|
||||
- **Length:** 150-160 characters
|
||||
- **Must include:** Keyword + CTA
|
||||
- **Format:** [Problem]? [Solution]. [CTA].
|
||||
|
||||
### URL Slug
|
||||
- **Format:** lowercase-with-hyphens
|
||||
- **Thai:** Keep Thai or use transliteration
|
||||
- **Max:** 5 words
|
||||
|
||||
---
|
||||
|
||||
## Content Structure
|
||||
|
||||
### Headings
|
||||
- **H1:** 1 per page, includes keyword
|
||||
- **H2:** 4-7 per article
|
||||
- **H3:** As needed for subsections
|
||||
|
||||
### Internal Links
|
||||
- **Minimum:** 3 per article
|
||||
- **Maximum:** 7 per article
|
||||
- **Anchor text:** Descriptive with keywords
|
||||
|
||||
### External Links
|
||||
- **Minimum:** 2 per article
|
||||
- **Authority sources only**
|
||||
- **No competitor links**
|
||||
|
||||
---
|
||||
|
||||
## Images
|
||||
|
||||
### Requirements
|
||||
- **Alt text:** Descriptive with keywords
|
||||
- **File names:** descriptive-name.jpg
|
||||
- **Compression:** WebP preferred
|
||||
- **Size:** Optimized for web
|
||||
|
||||
---
|
||||
|
||||
## Quality Checklist
|
||||
|
||||
Before publishing:
|
||||
- [ ] Keyword in H1
|
||||
- [ ] Keyword in first 100 words
|
||||
- [ ] Keyword in 2+ H2s
|
||||
- [ ] Keyword density 1.0-1.5% (Thai)
|
||||
- [ ] 3-5 internal links
|
||||
- [ ] 2-3 external authority links
|
||||
- [ ] Meta title 50-60 chars
|
||||
- [ ] Meta description 150-160 chars
|
||||
- [ ] Images have alt text
|
||||
- [ ] Readability checked
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** 2026-03-08
|
||||
67
skills/seo-context/scripts/my-website/context/style-guide.md
Normal file
67
skills/seo-context/scripts/my-website/context/style-guide.md
Normal file
@@ -0,0 +1,67 @@
|
||||
# Writing Style Guide
|
||||
|
||||
**Created:** 2026-03-08
|
||||
|
||||
---
|
||||
|
||||
## General Principles
|
||||
|
||||
1. **Clear over clever** - ความชัดเจนสำคัญกว่าการเล่นคำ
|
||||
2. **Helpful over promotional** - ให้ค่ามากกว่าขาย
|
||||
3. **Conversational over formal** - พูดคุยมากกว่าทางการ
|
||||
|
||||
---
|
||||
|
||||
## Sentence Structure
|
||||
|
||||
### Thai Sentences
|
||||
- **Average:** 15-25 words
|
||||
- **Active voice:** 80%+
|
||||
- **Short paragraphs:** 2-4 sentences
|
||||
|
||||
### Formatting
|
||||
- **Use bullets:** For lists of 3+ items
|
||||
- **Use bold:** For key concepts
|
||||
- **Use white space:** Generously
|
||||
|
||||
---
|
||||
|
||||
## Word Choice
|
||||
|
||||
### Use This, Not That
|
||||
|
||||
| Say This | Not That |
|
||||
|----------|----------|
|
||||
| เริ่มเลย | ดำเนินการเริ่มต้น |
|
||||
| ง่ายมาก | ไม่มีความซับซ้อน whatsoever |
|
||||
| ช่วยคุณ | ให้ความช่วยเหลือแก่ท่าน |
|
||||
|
||||
---
|
||||
|
||||
## Examples
|
||||
|
||||
### Good Introduction
|
||||
|
||||
"คุณกำลังมองหาวิธีเริ่มต้น podcast ใช่ไหม? บทความนี้จะบอกทุกอย่างที่ต้องรู้ ตั้งแต่การเลือกอุปกรณ์จนถึงการเผยแพร่"
|
||||
|
||||
**Why it works:**
|
||||
- ตรงประเด็น
|
||||
- บอกสิ่งที่ผู้อ่านจะได้
|
||||
- อ่านเข้าใจง่าย
|
||||
|
||||
---
|
||||
|
||||
## Thai-Specific Guidelines
|
||||
|
||||
### Particles
|
||||
- Use ครับ/ค่ะ appropriately
|
||||
- Don't overuse นะ, จ้ะ in formal content
|
||||
- Match formality level to content type
|
||||
|
||||
### Transliteration
|
||||
- Use consistent Thai spelling for English terms
|
||||
- Example: "podcast" = "พ็อดคาสท์" (not พอดแคสต์, พ็อดคาสต์)
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** 2026-03-08
|
||||
@@ -0,0 +1,50 @@
|
||||
# Target Keywords
|
||||
|
||||
**Industry:** podcast
|
||||
**Created:** 2026-03-08
|
||||
|
||||
---
|
||||
|
||||
## Primary Keyword Clusters
|
||||
|
||||
### Cluster 1: [Main Topic]
|
||||
|
||||
**Intent:** Commercial Investigation
|
||||
|
||||
**Keywords (Thai)**:
|
||||
- [Keyword 1]
|
||||
- [Keyword 2]
|
||||
- [Keyword 3]
|
||||
|
||||
**Keywords (English)**:
|
||||
- [Keyword 1]
|
||||
- [Keyword 2]
|
||||
- [Keyword 3]
|
||||
|
||||
**Search Volume:** TBD (research needed)
|
||||
|
||||
**Difficulty:** Medium
|
||||
|
||||
---
|
||||
|
||||
### Cluster 2: [Secondary Topic]
|
||||
|
||||
[Same structure]
|
||||
|
||||
---
|
||||
|
||||
## Keyword Mapping
|
||||
|
||||
| Keyword | Intent | Priority | Target URL |
|
||||
|---------|--------|----------|------------|
|
||||
| [keyword] | Commercial | High | /page |
|
||||
| [keyword] | Informational | Medium | /blog |
|
||||
|
||||
---
|
||||
|
||||
**Notes:**
|
||||
- Update keyword data from GSC monthly
|
||||
- Add new clusters as business expands
|
||||
- Track ranking performance
|
||||
|
||||
**Last Updated:** 2026-03-08
|
||||
8
skills/seo-context/scripts/requirements.txt
Normal file
8
skills/seo-context/scripts/requirements.txt
Normal file
@@ -0,0 +1,8 @@
|
||||
# SEO Context - Dependencies
|
||||
|
||||
# No external dependencies required
|
||||
# Pure Python with standard library only
|
||||
|
||||
# Optional: For advanced content analysis
|
||||
# pythainlp>=3.2.0
|
||||
# pandas>=2.1.0
|
||||
Reference in New Issue
Block a user