Brand GEO Master

Detect your brand's visibility across AI search platforms, generate scores and optimization recommendations.

---

Core Features

• Multi-platform detection: Search 9 AI platforms simultaneously
• GEM Score: 0-100 visibility score with grade classification
• AI Reason Analysis: Understand why brand is not recommended
• Feishu Push: Auto-send report as interactive card
• No API key required: Local Playwright for free tier

---

Quick Start

# Detect a single brand
python3 scripts/geo_report.py "Brand Name"

# Detect multiple brands (including competitors)
python3 scripts/geo_report.py "Brand A" "Brand B"

# No Feishu push (for debugging)
python3 scripts/geo_report.py "Brand Name" --no-push

# Check quota status
python3 scripts/geo_report.py --status

---

Score Guide

| Score | Level | Description | |------:|:-----:|-------------| | 80-100 | Excellent | AI actively recommends, strong brand exposure | | 60-79 | Good | Mentioned by some AI platforms | | 30-59 | Fair | Rare mentions, needs optimization | | 0-29 | Weak | Completely invisible |

---

Platform Coverage

| Platform | Coverage | |----------|----------| | Kimi | Supported | | Xunfei | Supported | | Wenxin | Supported | | Zhipu | Supported | | DeepSeek | Supported | | Qwen | Supported | | Doubao | Supported | | Mita | Supported | | Hunyuan | Supported |

---

Config File

Config is at config.json:

{
  "platforms": {
    "kimi": {"enabled": true, "weight": 1.0},
    "xinhuo": {"enabled": true, "weight": 0.9},
    "yiyan": {"enabled": true, "weight": 0.9},
    "zhipu": {"enabled": true, "weight": 0.8},
    "deepseek": {"enabled": false},
    "qianwen": {"enabled": false},
    "doubao": {"enabled": false},
    "mita": {"enabled": false},
    "hunyuan": {"enabled": false},
    "xunfei": {"enabled": false}
  },
  "report": {
    "push_to_feishu": true,
    "feishu_webhook": "Your Feishu group bot webhook URL"
  }
}

---

Billing

• Pay-per-call: $0.0100 USDT per execution via SkillPay.me
• Balance insufficient: Payment URL returned — user tops up at https://skillpay.me/brand-geo-master
• External data flow: FEISHU_USER_ID transmitted to skillpay.me for billing identification
• Billing model: Each full scan (single brand or batch) = 1 call = $0.0100 USDT

---

Required Environment Variables

| Variable | Description | |----------|-------------| | FEISHU_USER_ID | User open_id for billing (passed by Feishu runtime) | | SKILL_BILLING_API_KEY | SkillPay Builder API Key | | SKILL_BILLING_SKILL_ID | SkillPay Skill ID (defaults to brand-geo-master) | | GEO_QUOTA_FILE | Path to quota file (defaults to .geo_quota.json) |

---

License

MIT