Skill: jeffersplind92/geo-brand-master (version 1.0.0)

--- name: geo-master description: "GEO Master · Brand AI Visibility Monitor — automatically search AI platforms (Kimi/Xunfei/Zhipu/Wenxin/DeepSeek/etc.), detect brand keyword visibility, generate 0-100 GEM score, AI analysis of why brand was not recommended, Feishu push support." triggers: - GEO - AI visibility - brand monitoring - AI search visibility - competitor monitoring allowed-tools: Bash(python3) --- # GEO Master - Brand AI Visibility Monitor Detect your brand's visibility across AI search platforms, generate scores and optimization recommendations. ## Version & Pricing | Version | Price | Brand Limit | Platform Count | Tech | |---------|-------|:-----------:|:--------------:|------| | **Free** | ¥0/mo | 1/month | 3 platforms | Local Playwright | | **Standard** | ¥29/mo | Unlimited | All 9 platforms | Local Playwright | | **Pro** | ¥99/mo | Unlimited | All 9 platforms | 🌐 Tavily API (real-time) | | **Enterprise** | ¥399/mo | Unlimited | All 9+ deep analysis | Dedicated support | ### 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](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 | Platform | Free | Standard | Pro | Tech | |----------|:----:|:--------:|:---:|------| | Kimi | ✅ | ✅ | ✅ | Playwright direct | | Xunfei | ✅ | ✅ | ✅ | Playwright direct | | Wenxin | ✅ | ✅ | ✅ | Playwright direct | | Zhipu | ❌ | ✅ | ✅ | Playwright direct | | DeepSeek | ❌ | ✅ | ✅ | 🌐 Tavily API | | Qwen | ❌ | ✅ | ✅ | 🌐 Tavily API | | Doubao | ❌ | ✅ | ✅ | 🌐 Tavily API | | Mita | ❌ | ✅ | ✅ | 🌐 Tavily API | | Hunyuan | ❌ | ✅ | ✅ | 🌐 Tavily API | **Pro tier detection**: Training data indexed + real-time search results (full coverage) ## 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 # 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 | 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 | ## 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" } } ``` > **How to get Feishu Webhook**: Feishu group settings → Add bot → Custom bot → copy the Webhook URL. ## Environment Variables (Optional) | Variable | Default | Description | |----------|---------|-------------| | `GEO_QUOTA_FILE` | `.geo_quota.json` | Quota file path (recommended to keep default) | | `GEO_API_KEY` | (empty) | Pro API key (from yk-global.com) | | `TAVILY_API_KEY` | (required for Pro) | Tavily Search API key | ```bash 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](https://yk-global.com)

path: api/__init__.py
content: # GEO API Service


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector:  ()