GEO Master - Brand AI Visibility Monitor

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

Version & Pricing

Free Tier Limits

• Max 1 brand per month
• Max 3 AI platforms (Kimi, Xunfei, Wenxin)
• Quota resets automatically on the 1st of each month

Pro Tier Core Advantage (🌐 Tavily Real-time Search)

Pro users get real-time search results via Tavily Search API:

• ✅ All 9 AI platforms (DeepSeek/Qwen/Doubao/Mita/Hunyuan, etc.)
• ✅ Covers real-time search recommendations (not training data)
• ✅ Routed through our server — no local environment needed
• ✅ Stable and efficient, no IP blocking

> After purchasing Pro/Enterprise, get your API key at https://yk-global.com and use --api-key YOUR_KEY to unlock all features. Verification: POST https://api.yk-global.com/v1/verify. On failure, auto-downgrades to Free — no disruption.

Supported AI Platforms

Pro tier detection: Training data indexed + real-time search results (full coverage)

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

# With API Key (Pro/Enterprise users)
python3 scripts/geo_report.py "Brand Name" --api-key YOUR_API_KEY

# Upgrade to Pro / Enterprise
python3 scripts/geo_report.py --upgrade-pro
python3 scripts/geo_report.py --upgrade-ent

Score Guide

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"
  }
}

> How to get Feishu Webhook: Feishu group settings → Add bot → Custom bot → copy the Webhook URL.

Environment Variables (Optional)

export GEO_QUOTA_FILE=/your/custom/path/.geo_quota.json

AI Analysis

GEO AI reason analysis uses local analysis framework by default. To connect an external AI (e.g. MiniMax), edit scripts/geo_analyzer.py, find the AI_ENDPOINT field and fill in your AI endpoint.

Development Progress

• [x] Phase 0: Technical validation (2026-04-15)
• [x] Phase 1: MVP development
• [x] geo_searcher.py - Core crawler module
• [x] geo_analyzer.py - AI reason analysis
• [x] geo_report.py - Report generation
• [x] geo_quota.py - Quota management (Free tier limits)
• [x] SKILL.md - This file
• [x] Phase 2: Manual validation testing (2026-04-16)
• [x] Xunfei CSS selector fix (textarea)
• [x] Wenxin CSS selector fix (div[contenteditable])
• [x] DeepSeek/Qwen login wall handling (disabled)
• [x] Feishu Webhook config
• [x] Phase 3: Code polish
• [x] xinhuo/xunfei merge (avoid duplicate detection)
• [x] Free tier quota system (1 brand + 3 platforms/month)
• [x] SKILL.md status sync
• [x] Phase 4: ClawHub listing (v1.0.0)
• [x] Phase 4 Update: Security scan fixes (v1.0.1)
• [x] Phase 5: Pro Tavily API architecture (v1.0.2)

Official Site

https://yk-global.com