`SEO_TESTING_GUIDE.md`

533 lines
# SEO Testing & Verification Guide
## Red Thunder Wine Membership Platform

---

## QUICK TEST COMMANDS

### 1. Test Sitemap Accessibility
```bash
curl http://45.61.58.125:7250/sitemap.xml
```

**Expected Output:**
```xml
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>http://45.61.58.125:7250</loc>
    <lastmod>2025-11-15</lastmod>
    <changefreq>daily</changefreq>
    <priority>1</priority>
  </url>
  <url>
    <loc>http://45.61.58.125:7250/membership</loc>
    ...
  </url>
</urlset>
```

---

### 2. Test Robots.txt
```bash
curl http://45.61.58.125:7250/robots.txt
```

**Expected Output:**
```
User-Agent: *
Allow: /
Disallow: /api/
Disallow: /admin/
Disallow: /_next/

User-Agent: Googlebot
Allow: /
Disallow: /api/
Disallow: /admin/

Sitemap: http://45.61.58.125:7250/sitemap.xml
```

---

### 3. Test Meta Tags
```bash
curl -s http://45.61.58.125:7250/membership | grep -E '<title>|<meta.*description|<meta.*keywords|<meta.*og:|canonical' | head -20
```

**Expected Tags:**
- `<title>Tokenized Wine Membership | Rare Wine Investment & Shares | Wine DAO</title>`
- `<meta name="description" content="Invest in tokenized rare wine bottles..."`
- `<meta property="og:title" content="..."`
- `<link rel="canonical" href="http://45.61.58.125:7250/membership" />`

---

### 4. Test Structured Data
```bash
curl -s http://45.61.58.125:7250/membership | grep -o '<script type="application/ld+json">.*</script>' | head -1
```

**Expected:** JSON-LD structured data with @context and @graph

---

### 5. Test Response Headers
```bash
curl -I http://45.61.58.125:7250/membership
```

**Expected Headers:**
- `X-Frame-Options: SAMEORIGIN`
- `X-Content-Type-Options: nosniff`
- `Referrer-Policy: origin-when-cross-origin`
- `X-DNS-Prefetch-Control: on`
- `Content-Encoding: gzip` (if compression enabled)

---

## ONLINE TESTING TOOLS

### 1. Google Rich Results Test
**URL:** https://search.google.com/test/rich-results

**Steps:**
1. Enter URL: `http://45.61.58.125:7250/membership`
2. Click "Test URL"
3. Verify detected schema types:
   - Organization
   - Product (×2 for wine bottles)
   - Service
   - FAQPage
   - BreadcrumbList

**Expected Result:** ✅ "Page is eligible for rich results"

---

### 2. Schema.org Validator
**URL:** https://validator.schema.org/

**Steps:**
1. Choose "Fetch URL" tab
2. Enter: `http://45.61.58.125:7250/membership`
3. Click "Run Test"

**Expected:** No errors, all schema types validated

---

### 3. Facebook Sharing Debugger
**URL:** https://developers.facebook.com/tools/debug/

**Steps:**
1. Enter URL: `http://45.61.58.125:7250/membership`
2. Click "Debug"
3. Verify Open Graph tags:
   - Title: "Tokenized Wine Membership - Invest in Rare Wine Shares"
   - Description: Shows correctly
   - Image: Shows og-membership.jpg (once created)

---

### 4. Twitter Card Validator
**URL:** https://cards-dev.twitter.com/validator

**Steps:**
1. Enter URL: `http://45.61.58.125:7250/membership`
2. Click "Preview card"

**Expected:** Summary card with large image showing platform details

---

### 5. Google PageSpeed Insights
**URL:** https://pagespeed.web.dev/

**Test both:**
- Desktop: `http://45.61.58.125:7250/membership`
- Mobile: Same URL with mobile UA

**Target Scores:**
- Performance: 80+ (client-side React limitation)
- Accessibility: 95+
- Best Practices: 95+
- SEO: 95+

---

### 6. Mobile-Friendly Test
**URL:** https://search.google.com/test/mobile-friendly

**Steps:**
1. Enter: `http://45.61.58.125:7250/membership`
2. Click "Test URL"

**Expected:** ✅ "Page is mobile friendly"

---

### 7. Lighthouse SEO Audit (Chrome DevTools)

**Steps:**
1. Open Chrome browser
2. Navigate to: `http://45.61.58.125:7250/membership`
3. Press F12 (DevTools)
4. Click "Lighthouse" tab
5. Select "SEO" category
6. Click "Generate report"

**SEO Checklist (should all pass):**
- ✅ Document has a `<title>` element
- ✅ Document has a meta description
- ✅ Page has successful HTTP status code
- ✅ Links have descriptive text
- ✅ Page has viewport meta tag
- ✅ Document has valid `hreflang` (if applicable)
- ✅ Document uses legible font sizes
- ✅ Tap targets are sized appropriately
- ✅ Links are crawlable
- ✅ Robots.txt is valid
- ✅ Image elements have `alt` attributes

**Target Score:** 95-100

---

## MANUAL VERIFICATION CHECKLIST

### Page Load Testing
- [ ] Page loads in <3 seconds on desktop
- [ ] Page loads in <5 seconds on mobile
- [ ] No JavaScript errors in console
- [ ] All images load correctly
- [ ] No broken links

### Content Verification
- [ ] H1 contains primary keyword "Tokenized Wine Investment"
- [ ] H2 headings are descriptive and keyword-rich
- [ ] Body content mentions "Château Margaux" and "DRC La Tâche"
- [ ] Footer includes educational content about wine tokenization
- [ ] All buttons have descriptive aria-labels

### Metadata Verification
- [ ] Browser tab shows correct title
- [ ] View page source → verify canonical URL
- [ ] View page source → verify Open Graph tags
- [ ] View page source → verify Twitter Card tags
- [ ] View page source → verify JSON-LD structured data

### Mobile Responsiveness
- [ ] Test on iPhone (Safari)
- [ ] Test on Android (Chrome)
- [ ] Test on tablet (iPad)
- [ ] Navigation menu works on mobile
- [ ] All buttons are tappable (44×44px minimum)
- [ ] No horizontal scrolling
- [ ] Text is readable without zooming

### Accessibility Testing
- [ ] Tab through page with keyboard only
- [ ] Screen reader can navigate (use NVDA/JAWS)
- [ ] Color contrast meets WCAG AA standards
- [ ] Form inputs have associated labels
- [ ] Skip to main content link exists

---

## GOOGLE SEARCH CONSOLE SETUP

### Step 1: Verify Ownership

**Option A: HTML Tag Method**
1. Go to: https://search.google.com/search-console
2. Add property: `http://45.61.58.125:7250`
3. Choose "HTML tag" verification method
4. Copy verification code
5. Add to `/app/membership/layout.tsx`:
   ```typescript
   verification: {
     google: 'YOUR_VERIFICATION_CODE_HERE',
   }
   ```
6. Redeploy application
7. Click "Verify" in Search Console

**Option B: File Upload Method**
1. Download verification file from Google
2. Place in `/public/` directory
3. Verify file is accessible: `http://45.61.58.125:7250/google*.html`

---

### Step 2: Submit Sitemap
1. In Search Console → Sitemaps
2. Enter sitemap URL: `http://45.61.58.125:7250/sitemap.xml`
3. Click "Submit"
4. Wait 24-48 hours for Google to crawl

---

### Step 3: Monitor Performance
**Check weekly:**
- Total clicks
- Total impressions
- Average CTR
- Average position
- Top queries
- Top pages

**Top Expected Queries:**
- "tokenized wine"
- "wine investment platform"
- "buy wine shares"
- "Château Margaux investment"
- "rare wine DAO"

---

## BING WEBMASTER TOOLS SETUP

### Step 1: Verify Ownership
1. Go to: https://www.bing.com/webmasters
2. Add site: `http://45.61.58.125:7250`
3. Choose verification method (XML tag or file)
4. Update metadata verification code:
   ```typescript
   verification: {
     yandex: 'YOUR_BING_CODE_HERE',
   }
   ```

### Step 2: Submit Sitemap
1. Sitemaps → Add sitemap
2. URL: `http://45.61.58.125:7250/sitemap.xml`

---

## COMPETITIVE SEO ANALYSIS

### Tools to Use:
1. **Ahrefs** - Backlink analysis and keyword research
2. **SEMrush** - Competitor keyword tracking
3. **Moz** - Domain authority and page authority
4. **Ubersuggest** - Free keyword suggestions

### Competitors to Monitor:
1. **Vinovest** (vinovest.co) - Wine investment platform
2. **Cult Wine Investment** (cultwines.com) - Rare wine marketplace
3. **WineFi** (winefi.com) - Tokenized wine (if exists)

### Keyword Gap Analysis:
```bash
# Check which keywords competitors rank for that we don't
# Use Ahrefs or SEMrush for this analysis
```

**Target:** Identify 10-20 high-value keywords where competitors rank Page 1 but we don't

---

## BACKLINK BUILDING STRATEGY

### Priority 1: Wine Industry Sites
- [ ] Submit to wine directories (WineSearcher, Wine-Searcher)
- [ ] Guest post on wine blogs
- [ ] Get featured in wine investment news sites
- [ ] Partner with wine education platforms

### Priority 2: Investment/Finance Sites
- [ ] Submit to alternative investment directories
- [ ] Get featured on fintech blogs
- [ ] Partner with investment education sites
- [ ] Press release to financial news outlets

### Priority 3: Social & Community
- [ ] Reddit wine communities (/r/wine, /r/winemaking)
- [ ] Wine forums and discussion boards
- [ ] LinkedIn wine investment groups
- [ ] Twitter wine influencers

---

## CONTENT MARKETING PLAN

### Month 1: Educational Content
1. "What is Tokenized Wine? A Beginner's Guide"
2. "Top 5 Wines to Invest In (2025)"
3. "How Wine DAO Governance Works"
4. "Château Margaux vs. DRC: Investment Comparison"

### Month 2: Comparison Content
1. "Traditional Wine Investment vs. Tokenized Wine"
2. "Vinovest vs. Red Thunder: Which is Better?"
3. "Best Wine Investment Platforms in 2025"
4. "Wine Investment Calculator & ROI Analysis"

### Month 3: Advanced Topics
1. "Tax Implications of Wine Investment"
2. "How to Evaluate Wine for Investment Potential"
3. "Wine Storage & Insurance Best Practices"
4. "Building a Diversified Wine Portfolio"

---

## TRACKING METRICS

### Weekly Metrics
- Organic traffic to /membership
- Average position for target keywords
- Click-through rate (CTR) from search
- Bounce rate and session duration

### Monthly Metrics
- Total indexed pages
- Backlink growth
- Domain authority (Moz)
- Keyword rankings (top 10, top 20, top 50)

### Quarterly Metrics
- Revenue from organic traffic
- Conversion rate (visits → share purchases)
- Customer acquisition cost (CAC) from SEO
- Return on investment (ROI)

---

## TROUBLESHOOTING

### Issue: Sitemap not loading
**Solution:**
```bash
# Verify Next.js sitemap route exists
ls -la /root/Projects/wine-finder-next/app/sitemap.ts

# Restart the application
pm2 restart wine-finder-next

# Test sitemap
curl http://45.61.58.125:7250/sitemap.xml
```

---

### Issue: Metadata not showing in search results
**Solution:**
1. Wait 48-72 hours for Google to re-crawl
2. Force recrawl in Google Search Console (URL Inspection → Request Indexing)
3. Verify metadata exists in page source
4. Check robots.txt isn't blocking the page

---

### Issue: Structured data errors
**Solution:**
1. Test with Google Rich Results Test
2. Validate with Schema.org validator
3. Check JSON-LD syntax (commas, brackets)
4. Verify all required properties exist

---

### Issue: Low click-through rate (CTR)
**Solution:**
1. A/B test different meta descriptions
2. Add power words (Free, Exclusive, Limited)
3. Include numbers and specifics ($67,500, 10,000 shares)
4. Add call-to-action in description
5. Use schema markup for rich snippets

---

## SUCCESS CRITERIA

### Week 1
- [ ] All pages indexed by Google
- [ ] Sitemap processed without errors
- [ ] No structured data errors
- [ ] Mobile-friendly test passes
- [ ] PageSpeed Insights SEO score 95+

### Month 1
- [ ] Ranking for 5+ branded keywords
- [ ] 100+ organic visits
- [ ] 10+ backlinks acquired
- [ ] Featured in 1+ wine publications

### Month 3
- [ ] Ranking in top 20 for 3+ primary keywords
- [ ] 500+ organic visits/month
- [ ] 50+ backlinks from quality domains
- [ ] 5+ featured snippets

### Month 6
- [ ] Ranking in top 10 for primary keyword "tokenized wine"
- [ ] 1,000+ organic visits/month
- [ ] 100+ backlinks from wine/investment sites
- [ ] 10+ featured snippets
- [ ] Domain authority 30+

---

## MAINTENANCE SCHEDULE

### Daily
- Monitor Search Console for errors
- Check website uptime (45.61.58.125:7250)

### Weekly
- Review keyword rankings
- Check backlink growth
- Analyze traffic patterns
- Update content based on queries

### Monthly
- SEO performance report
- Competitor analysis
- Content strategy review
- Technical SEO audit

### Quarterly
- Comprehensive SEO audit
- Strategy adjustment
- ROI analysis
- New keyword research

---

## RESOURCES

### SEO Tools
- **Google Search Console** - Free
- **Bing Webmaster Tools** - Free
- **Google Analytics** - Free
- **Screaming Frog** - Free (up to 500 URLs)
- **Ahrefs** - Paid ($99/mo)
- **SEMrush** - Paid ($119/mo)

### Learning Resources
- Google SEO Starter Guide
- Moz Beginner's Guide to SEO
- Ahrefs Blog
- Search Engine Journal

### Support
- **Technical Issues:** Check Next.js documentation
- **SEO Questions:** SEO subreddit, Moz Q&A
- **Schema Markup:** Schema.org documentation

---

## CONTACT

**Project:** Red Thunder Wine Membership Platform
**URL:** http://45.61.58.125:7250/membership
**Last Updated:** November 15, 2025
**Next Audit:** December 15, 2025

---

**Remember:** SEO is a marathon, not a sprint. Consistent effort over 6-12 months yields the best results.