How to Optimize D2C Site for AI Agent Discovery

import os, requests

API_KEY = os.environ['SCAVIO_API_KEY']
SH = {'x-api-key': API_KEY, 'Content-Type': 'application/json'}

def check_visibility(brand, product):
    queries = [
        f'best {product} 2026',
        f'{product} recommendations',
        f'buy {product} online direct',
        f'{brand} {product} review',
    ]
    results = {'found': 0, 'total': 0, 'positions': []}
    for q in queries:
        data = requests.post('https://api.scavio.dev/api/v1/search',
            headers=SH, json={'query': q, 'country_code': 'us'}).json()
        organic = data.get('organic_results', [])
        results['total'] += 1
        for i, r in enumerate(organic):
            if brand.lower() in r.get('link', '').lower() or brand.lower() in r.get('title', '').lower():
                results['found'] += 1
                results['positions'].append(i + 1)
                break
    visibility = results['found'] / results['total'] * 100 if results['total'] else 0
    avg_pos = sum(results['positions']) / len(results['positions']) if results['positions'] else 0
    print(f'Brand: {brand}')
    print(f'Visibility: {visibility:.0f}% ({results["found"]}/{results["total"]} queries)')
    print(f'Avg position when found: {avg_pos:.1f}')
    print(f'Cost: ${results["total"] * 0.005:.3f}')
    return results

check_visibility('YourBrand', 'organic face cream')

def audit_agent_readiness(domain):
    """Check if a D2C site is ready for AI agent discovery."""
    checks = []
    # Check llms.txt
    data = requests.post('https://api.scavio.dev/api/v1/search',
        headers=SH, json={'query': f'site:{domain} llms.txt', 'country_code': 'us'}).json()
    has_llms = len(data.get('organic_results', [])) > 0
    checks.append(('llms.txt exists', has_llms))
    # Check structured data
    data = requests.post('https://api.scavio.dev/api/v1/search',
        headers=SH, json={'query': f'site:{domain} product', 'country_code': 'us'}).json()
    results = data.get('organic_results', [])
    has_rich = any(r.get('rich_snippet') for r in results)
    checks.append(('Rich snippets on product pages', has_rich))
    # Check sitemap
    data = requests.post('https://api.scavio.dev/api/v1/search',
        headers=SH, json={'query': f'site:{domain} sitemap.xml', 'country_code': 'us'}).json()
    has_sitemap = len(data.get('organic_results', [])) > 0
    checks.append(('Sitemap indexed', has_sitemap))
    print(f'\nAgent Readiness Audit: {domain}')
    for check, passed in checks:
        status = 'PASS' if passed else 'FAIL'
        print(f'  [{status}] {check}')
    score = sum(1 for _, p in checks if p)
    print(f'\nScore: {score}/{len(checks)}')
    return checks

audit_agent_readiness('example-d2c-brand.com')

def generate_llms_txt(brand, domain, products):
    """Generate llms.txt for a D2C brand."""
    lines = [
        f'# {brand}',
        f'',
        f'> {brand} sells directly to consumers at {domain}.',
        f'> All products ship from our warehouse. Free returns within 30 days.',
        f'',
        f'## Products',
    ]
    for p in products:
        lines.append(f'- [{p["name"]}](https://{domain}/products/{p["slug"]}): {p["description"]}')
    lines.extend([
        f'',
        f'## Ordering',
        f'- [Shop All](https://{domain}/shop)',
        f'- [FAQ](https://{domain}/faq)',
        f'- [Shipping Policy](https://{domain}/shipping)',
        f'- [Returns](https://{domain}/returns)',
    ])
    content = '\n'.join(lines)
    print(content)
    return content

# Example product catalog
products = [
    {'name': 'Organic Face Cream', 'slug': 'organic-face-cream', 'description': '50ml, $28, for sensitive skin'},
    {'name': 'Vitamin C Serum', 'slug': 'vitamin-c-serum', 'description': '30ml, $22, brightening formula'},
]

llms_txt = generate_llms_txt('GlowCo', 'glowco.com', products)
print(f'\nSave this as /llms.txt on your domain root')

import json

def track_agent_visibility(brand, domain, products, history_file='visibility_log.json'):
    try:
        with open(history_file) as f:
            history = json.load(f)
    except FileNotFoundError:
        history = []
    today = {'date': '2026-05-20', 'queries': []}
    for product in products:
        query = f'best {product} 2026'
        data = requests.post('https://api.scavio.dev/api/v1/search',
            headers=SH, json={'query': query, 'country_code': 'us'}).json()
        organic = data.get('organic_results', [])
        position = None
        for i, r in enumerate(organic):
            if domain in r.get('link', ''):
                position = i + 1
                break
        today['queries'].append({'query': query, 'position': position})
    history.append(today)
    found = sum(1 for q in today['queries'] if q['position'])
    print(f'Visibility check: {found}/{len(products)} products found in SERP')
    for q in today['queries']:
        pos = f'#{q["position"]}' if q['position'] else 'Not found'
        print(f'  {q["query"][:40]:40} | {pos}')
    if len(history) >= 2:
        prev = history[-2]
        prev_found = sum(1 for q in prev['queries'] if q['position'])
        delta = found - prev_found
        print(f'\nChange vs last check: {delta:+d} products visible')
    print(f'Cost: ${len(products) * 0.005:.3f}')

track_agent_visibility('GlowCo', 'glowco.com', ['organic face cream', 'vitamin c serum'])