📧 Complete Gmail + qwen Code Workflow Guide

# 📧 Complete Gmail + qwen Code Workflow Guide

## ✅ Your System is Ready!

- ✅ Gmail integration configured
- ✅ 18 unread emails detected
- ✅ qwen Code installed (v0.12.3)
- ✅ Orchestrator enhanced with intelligent routing

---

## 🎯 How It Works

### Workflow Overview

```
1. You send an email (or receive one)
   ↓
2. Gmail Watcher detects it (checks every 5 minutes)
   ↓
3. Creates action file in /Content_Ideas
   ↓
4. Orchestrator detects new file
   ↓
5. Analyzes content type (Keyword Research / Writing / Optimization)
   ↓
6. Triggers qwen Code with specialized prompt
   ↓
7. qwen Code creates brief/content/analysis
   ↓
8. Files saved to appropriate folders
   ↓
9. Dashboard updated
```

---

## 📝 Test the Complete Workflow

### Step 1: Send Yourself a Test Email

From any email account, send an email to your Gmail address with one of these subjects:

**For Keyword Research:**
```
Subject: Keyword research needed for "AI SEO tools 2026"

Body:
I need comprehensive keyword research for the topic "AI SEO tools 2026". 
Find related keywords, analyze difficulty, and identify quick wins.
```

**For Content Writing:**
```
Subject: Write an article about local SEO tips for small businesses

Body:
Please create a comprehensive guide about local SEO for small businesses.
Include Google Business Profile optimization, local citations, and review management.
```

**For Content Optimization:**
```
Subject: Optimize my content about technical SEO checklist

Body:
I have an article about technical SEO that needs optimization.
Please analyze and provide recommendations for improving rankings.
```

### Step 2: Start the Watchers

Open **three separate terminal windows**:

**Terminal 1 - Gmail Watcher:**
```bash
cd /Users/arshah/Documents/GitHub/ai-seo-fte
source venv/bin/activate
python src/gmail_watcher.py
```

**Terminal 2 - Orchestrator:**
```bash
cd /Users/arshah/Documents/GitHub/ai-seo-fte
source venv/bin/activate
python src/orchestrator.py
```

**Terminal 3 - Optional: File System Watcher**
```bash
cd /Users/arshah/Documents/GitHub/ai-seo-fte
source venv/bin/activate
python src/filesystem_watcher.py
```

### Step 3: Watch the Magic Happen

Within 5 minutes, you should see:

1. **Gmail Watcher** detects your email:
   ```
   Found 1 content-related emails
   Created action file: GMAIL_20260314_...md
   ```

2. **Orchestrator** picks it up:
   ```
   Found 1 pending item(s)
   Processing: GMAIL_...md
   Detected content type: keyword_research
   Running qwen Code...
   ```

3. **qwen Code** processes the request:
   - Reads Content_Handbook.md and Content_Strategy.md
   - Creates content brief in /Content_Briefs/
   - Updates Dashboard.md
   - Moves file to /Done/

### Step 4: Check Results in Obsidian

1. Open Obsidian with your vault
2. Check these folders:
   - `/Content_Ideas/` - New action file created
   - `/Content_Briefs/` - qwen Code's analysis and brief
   - `Dashboard.md` - Updated with recent activity

---

## 🎬 Quick Demo (Without Email)

Want to test right now without sending an email? Run this:

```bash
cd /Users/arshah/Documents/GitHub/ai-seo-fte

# Create a test content idea manually
cat > SEO_Employee_Vault/Content_Ideas/MANUAL_keyword_research_ai_seo.md << 'EOF'
---
type: manual_request
source: user
created: 2026-03-14T01:30:00
priority: high
status: pending
---

# Keyword Research Request

Please do comprehensive keyword research for "AI SEO tools 2026".

I need:
- Primary and related keywords
- Search volume and difficulty analysis
- Competition analysis
- Content recommendations
- Quick win opportunities
EOF

# Now run the orchestrator
source venv/bin/activate
python src/orchestrator.py
```

The orchestrator will:
1. Detect the manual request
2. Identify it as `keyword_research`
3. Trigger qwen Code
4. Create a comprehensive keyword brief

---

## 📊 Content Types Detected

The orchestrator intelligently routes requests:

| Content Type | Trigger Words | Output |
|-------------|---------------|--------|
| **Keyword Research** | "keyword research", "find keywords", "search volume", "KD score" | Keyword Research Report |
| **Content Writing** | "write an article", "create content", "blog post", "guide about" | Content Brief + Outline |
| **Content Optimization** | "optimize", "improve SEO", "meta description", "refresh" | SEO Audit + Recommendations |
| **General** | Everything else | Analysis + Recommendations |

---

## 🔧 Monitoring and Debugging

### Check Logs

```bash
# Orchestrator logs
tail -f orchestrator.log

# Gmail watcher logs (in system log)
```

### Check Processed Files

```bash
# See what's been processed
cat SEO_Employee_Vault/.processed_files.txt

# See what's pending
ls -la SEO_Employee_Vault/Content_Ideas/
```

### Stop Watchers

Press `Ctrl+C` in each terminal window to stop the watchers.

---

## 🎯 Example Workflows

### Workflow 1: Keyword Research

**Email Subject:** `Keyword research for "best CRM software 2026"`

**What Happens:**
1. Gmail Watcher creates: `GMAIL_...keyword_research_crm.md`
2. Orchestrator detects type: `keyword_research`
3. qwen Code creates in `/Content_Briefs/`:
   - Primary keyword analysis
   - 15+ related keywords with metrics
   - Search intent breakdown
   - Competition analysis
   - Content recommendations

### Workflow 2: Content Writing

**Email Subject:** `Write a guide about link building strategies`

**What Happens:**
1. Gmail Watcher creates action file
2. Orchestrator detects: `content_writing`
3. qwen Code creates:
   - Content brief with outline
   - Target keywords
   - Word count recommendation
   - Internal linking plan
   - Meta description draft

### Workflow 3: Content Optimization

**Email Subject:** `Optimize my article about on-page SEO`

**What Happens:**
1. Gmail Watcher detects request
2. Orchestrator identifies: `content_optimization`
3. qwen Code provides:
   - SEO audit
   - Title/meta optimization
   - Header structure improvements
   - Keyword placement suggestions
   - Featured snippet opportunities

---

## ⚡ Pro Tips

### 1. Use Specific Subject Lines

✅ Good:
- "Keyword research for AI writing tools"
- "Write article about local SEO for dentists"
- "Optimize content about technical SEO"

❌ Vague:
- "SEO help needed"
- "Content idea"
- "Write something"

### 2. Include Details in Email Body

The more context you provide, the better qwen Code can help:

```
Good:
"Write a comprehensive guide about keyword research for 2026.
Target audience: Small business owners
Include: Tools, step-by-step process, common mistakes
Word count: 2000+ words"
```

### 3. Check Dashboard Daily

Open `Dashboard.md` in Obsidian every morning to see:
- What was processed overnight
- New content briefs created
- Pending approvals

### 4. Approve Content for Publishing

When qwen Code creates content:
1. Check `/Pending_Approval/`
2. Review the content
3. **Approve:** Move to `/Approved/`
4. **Request changes:** Move to `/Rejected/` with comments

---

## 🚨 Troubleshooting

### Gmail Watcher Not Detecting Emails

1. Check if watcher is running
2. Verify authentication: `ls -la token.json`
3. Re-authenticate if needed: `python auth_gmail.py`

### Orchestrator Not Processing

1. Check qwen Code is installed: `qwen --version`
2. Verify vault path in `.env`
3. Check logs: `tail orchestrator.log`

### qwen Code Timing Out

- Complex tasks may take time
- Increase timeout in orchestrator.py (default: 10 min)
- Break large requests into smaller tasks

---

## 📚 Next Steps

After testing:

1. **Set up WordPress MCP** for auto-publishing
2. **Add Google Search Console** integration
3. **Configure Ahrefs/SEMrush** API for keyword data
4. **Set up cloud deployment** for 24/7 operation

---

## 🎉 You're All Set!

Your SEO Content Writing Employee is fully configured and ready to work!

**Start by:**
1. Sending yourself a test email
2. Running the watchers
3. Watching qwen Code create amazing content briefs!

---

**Questions?** Check:
- `README.md` - Full documentation
- `QUICKSTART.md` - Getting started guide
- `GMAIL_SETUP.md` - Gmail setup details