Brand Geo Master

SKILL.md

---
name: brand-geo-master
description: "Brand GEO Master — AI Platform Brand Visibility Monitor. Automatically search AI platforms (Kimi/Xunfei/Zhipu/Wenxin/DeepSeek/etc.), detect brand keyword visibility, generate 0-100 GEM score, Feishu push support. Trigger: GEO, AI visibility, brand monitoring, AI search visibility."
triggers:
  - GEO
  - AI visibility
  - brand monitoring
  - AI search visibility
  - competitor monitoring
allowed-tools: Bash(python3)
---

# 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

```bash
# 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`:

```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