@adgine/geo-cli 1.2.8

package/skills/adgine-geo-projects/scripts/list_projects.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""List GEO website projects for the authenticated user.
+
+Usage:
+  python3 scripts/list_projects.py [--limit N] [--json]
+"""
+import sys
+import os
+import argparse
+sys.path.insert(0, os.path.dirname(__file__))
+from _client import get_api_config, api_get, extract_data, print_json  # _notice printed on import
+
+parser = argparse.ArgumentParser(description="List GEO projects")
+parser.add_argument("--limit", type=int, default=50, help="Max results (default: 50)")
+parser.add_argument("--json", action="store_true", help="Output raw JSON")
+args = parser.parse_args()
+
+key, base = get_api_config()
+result = api_get("/api/projects", key, base, params={"limit": args.limit})
+data = extract_data(result)
+
+if args.json:
+    print_json(data)
+    sys.exit(0)
+
+items = data.get("items", []) if isinstance(data, dict) else data
+total = data.get("total", len(items)) if isinstance(data, dict) else len(items)
+
+if not items:
+    print("No projects found.")
+    print("Create your first project at: https://app.geoplatform.ai")
+    sys.exit(0)
+
+print(f"Found {total} project(s):\n")
+print(f"  {'ID':<36}  {'Name':<30}  {'Domain':<30}  {'Brand'}")
+print(f"  {'-'*36}  {'-'*30}  {'-'*30}  {'-'*5}")
+
+for p in items:
+    pid     = p.get("id", "")
+    name    = (p.get("name") or p.get("url") or "")[:30]
+    domain  = (p.get("domain") or "")[:30]
+    brand   = "✓" if p.get("has_brand_profile") else "—"
+    print(f"  {pid:<36}  {name:<30}  {domain:<30}  {brand}")
+
+print()
+print("To set the active project:")
+print("  export GEO_PROJECT_ID=<id>")

package/skills/adgine-geo-projects/scripts/manage_competitors.py

@@ -0,0 +1,122 @@
+#!/usr/bin/env python3
+"""Manage competitors for a GEO project.
+
+Subcommands:
+  list                                — list all competitors
+  add  --name <name> [--domain <url>] [--aliases a,b,c] [--source manual]
+  remove --competitor-id <id> --yes   — DESTRUCTIVE
+
+Usage examples:
+  python3 scripts/manage_competitors.py list
+  python3 scripts/manage_competitors.py add --name "Acme" --domain acme.com \\
+      --aliases "Acme Inc,Acme Corp"
+  python3 scripts/manage_competitors.py remove --competitor-id <id> --yes
+"""
+import sys
+import os
+import argparse
+
+sys.path.insert(0, os.path.dirname(__file__))
+from _client import (
+    get_api_config, get_project_id,
+    api_get, api_post, api_delete,
+    extract_data, print_json, truncate,
+    pad,
+)
+
+
+def cmd_list(args, key, base, pid):
+    result = api_get(f"/api/projects/{pid}/competitors", key, base)
+    data = extract_data(result)
+    items = data if isinstance(data, list) else (data or {}).get("competitors", [])
+
+    if args.json:
+        print_json(items)
+        return
+
+    print(f"Competitors for project {pid}")
+    print()
+    if not items:
+        print("No competitors yet. Use `add` to create one.")
+        return
+
+    print("```")
+    print("┌──────────────────────────────────────┬────────────────────┬────────────────────┐")
+    print("│ ID                                   │ Name               │ Domain             │")
+    print("├──────────────────────────────────────┼────────────────────┼────────────────────┤")
+    for c in items:
+        cid = truncate(c.get("id") or c.get("competitor_id") or c.get("brand_id"), 36)
+        name = truncate(c.get("name"), 18)
+        domain = truncate(c.get("domain") or "--", 18)
+        print(f"│ {pad(cid, 36)} │ {pad(name, 18)} │ {pad(domain, 18)} │")
+    print("└──────────────────────────────────────┴────────────────────┴────────────────────┘")
+    print("```")
+
+
+def cmd_add(args, key, base, pid):
+    body = {"name": args.name, "source": args.source}
+    if args.domain:
+        body["domain"] = args.domain
+    if args.aliases:
+        body["aliases"] = [a.strip() for a in args.aliases.split(",") if a.strip()]
+    result = api_post(f"/api/projects/{pid}/competitors", key, base, body=body)
+    data = extract_data(result)
+    if args.json:
+        print_json(data)
+        return
+    print(f"Added competitor: {args.name}")
+    if isinstance(data, dict):
+        cid = data.get("id") or data.get("competitor_id") or data.get("brand_id")
+        if cid:
+            print(f"  ID: {cid}")
+
+
+def cmd_remove(args, key, base, pid):
+    if not args.yes:
+        print(f"About to remove competitor {args.competitor_id} from project {pid}.")
+        print("Re-run with --yes to confirm.")
+        sys.exit(1)
+    result = api_delete(
+        f"/api/projects/{pid}/competitors/{args.competitor_id}",
+        key, base,
+    )
+    data = extract_data(result)
+    if args.json:
+        print_json(data if data is not None else {"ok": True})
+        return
+    print(f"Removed competitor: {args.competitor_id}")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Manage GEO project competitors")
+    parser.add_argument("--project-id", help="Project ID (or set GEO_PROJECT_ID env var)")
+    parser.add_argument("--json", action="store_true", help="Output raw JSON")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    sub.add_parser("list", help="List all competitors")
+
+    p_add = sub.add_parser("add", help="Add a competitor")
+    p_add.add_argument("--name", required=True, help="Competitor brand name")
+    p_add.add_argument("--domain", help="Competitor domain")
+    p_add.add_argument("--aliases", help="Comma-separated alias list")
+    p_add.add_argument("--source", default="manual",
+                       choices=["manual", "brand_profile", "ai_discovery"])
+
+    p_rm = sub.add_parser("remove", help="Remove a competitor (DESTRUCTIVE)")
+    p_rm.add_argument("--competitor-id", required=True)
+    p_rm.add_argument("--yes", action="store_true", help="Confirm deletion")
+
+    args = parser.parse_args()
+    key, base = get_api_config()
+    pid = get_project_id(args.project_id)
+
+    if args.command == "list":
+        cmd_list(args, key, base, pid)
+    elif args.command == "add":
+        cmd_add(args, key, base, pid)
+    elif args.command == "remove":
+        cmd_remove(args, key, base, pid)
+
+
+if __name__ == "__main__":
+    main()

package/skills/adgine-geo-projects/scripts/manage_project.py

@@ -0,0 +1,88 @@
+#!/usr/bin/env python3
+"""Get, create, update, or delete a GEO project.
+
+Usage:
+  python3 scripts/manage_project.py get    --project-id <id> [--json]
+  python3 scripts/manage_project.py create --url https://example.com [--description "text"]
+  python3 scripts/manage_project.py update --project-id <id> [--name "Name"] [--url "url"] [--description "text"]
+  python3 scripts/manage_project.py delete --project-id <id>
+"""
+import sys
+import os
+import argparse
+
+sys.path.insert(0, os.path.dirname(__file__))
+from _client import get_api_config, get_project_id, api_get, api_post, api_put, api_delete, extract_data, print_json
+
+parser = argparse.ArgumentParser(description="Manage a GEO project")
+parser.add_argument("action", choices=["get", "create", "update", "delete"])
+parser.add_argument("--project-id", help="Project ID (or set GEO_PROJECT_ID env var)")
+parser.add_argument("--url",         help="Website URL (required for create)")
+parser.add_argument("--name",        help="Project name")
+parser.add_argument("--description", help="Project description")
+parser.add_argument("--json",        action="store_true", help="Output raw JSON")
+args = parser.parse_args()
+
+key, base = get_api_config()
+
+# ── GET ──────────────────────────────────────────────────────────────────────
+if args.action == "get":
+    pid = get_project_id(args.project_id)
+    result = api_get(f"/api/projects/{pid}", key, base)
+    p = extract_data(result)
+    if args.json:
+        print_json(p)
+        sys.exit(0)
+    print(f"Project: {p.get('name') or p.get('url')}")
+    print(f"  ID          : {p.get('id')}")
+    print(f"  URL         : {p.get('url')}")
+    print(f"  Domain      : {p.get('domain') or '—'}")
+    print(f"  Description : {p.get('description') or '—'}")
+    print(f"  Brand ready : {'Yes' if p.get('has_brand_profile') else 'No'}")
+    print(f"  Created     : {p.get('created_at', '')[:10]}")
+
+# ── CREATE ───────────────────────────────────────────────────────────────────
+elif args.action == "create":
+    if not args.url:
+        print("ERROR: --url is required for create")
+        sys.exit(1)
+    body = {"url": args.url}
+    if args.description:
+        body["description"] = args.description
+    result = api_post("/api/projects", key, base, body)
+    p = extract_data(result)
+    if args.json:
+        print_json(p)
+        sys.exit(0)
+    print(f"✓ Project created")
+    print(f"  ID     : {p.get('id')}")
+    print(f"  Name   : {p.get('name') or p.get('url')}")
+    print(f"  Domain : {p.get('domain') or '—'}")
+    print()
+    print(f"To set as active: export GEO_PROJECT_ID={p.get('id')}")
+
+# ── UPDATE ───────────────────────────────────────────────────────────────────
+elif args.action == "update":
+    pid = get_project_id(args.project_id)
+    body = {}
+    if args.name:        body["name"]        = args.name
+    if args.url:         body["url"]         = args.url
+    if args.description: body["description"] = args.description
+    if not body:
+        print("ERROR: Provide at least one of --name, --url, --description")
+        sys.exit(1)
+    result = api_put(f"/api/projects/{pid}", key, base, body)
+    p = extract_data(result)
+    if args.json:
+        print_json(p)
+        sys.exit(0)
+    print(f"✓ Project updated: {p.get('name') or p.get('url')}")
+
+# ── DELETE ───────────────────────────────────────────────────────────────────
+elif args.action == "delete":
+    pid = get_project_id(args.project_id)
+    api_delete(f"/api/projects/{pid}", key, base)
+    print(f"✓ Project {pid} deleted")
+    if os.environ.get("GEO_PROJECT_ID") == pid:
+        print("  NOTE: Unset GEO_PROJECT_ID since the deleted project was active.")
+        print("  Run: unset GEO_PROJECT_ID")

package/skills/adgine-geo-saas/SKILL.md

@@ -0,0 +1,144 @@
+---
+name: adgine/geo-saas
+description: Creates and tracks GEO SaaS-hosted websites — checks if a subdomain is available, kicks off an async website deployment with brand details, and polls deployment task status. Use when the user wants to launch a new SaaS website on the GEO platform (创建 SaaS 网站, 新建网站, 部署网站, launch website, create SaaS site), check whether a subdomain is taken (检查域名, subdomain availability, 二级域名), or check the progress of a website deployment task (部署状态, deployment status, task progress).
+---
+
+# GEO SaaS
+
+Three-script flow for spinning up a SaaS-hosted website on the GEO platform:
+
+1. **Check** that the desired subdomain is available.
+2. **Create** the website (returns a task_id; deployment runs asynchronously).
+3. **Poll** the task until it reaches a terminal state.
+
+## Output rules — IDs (apply to every reply)
+
+These rules apply to **every list, table, and confirmation message** in this skill. Their goal: keep user-facing output friendly while preserving the IDs the agent needs internally.
+
+1. **Lists & tables — never show raw UUIDs in cells.** Use a 1-based `#` index column instead. Keep a private mental mapping of `#N → actual UUID` so that follow-up commands like *"delete #3"*, *"run citation test on #1 #2"*, *"show details of the 2nd one"* resolve to the right entity.
+   - Index numbers restart from 1 in each new list — they are not stable across calls.
+   - If the user references *"the topic about X"* / *"that Poki vs CrazyGames prompt"*, match by visible content (name / title / domain / prompt text), not by ID.
+
+2. **Single-item operations — prefer a human name over an ID.**
+   - ✅ *"Project **Poki vs Competitors** deleted."*
+   - ✅ *"Topic **Brand mentions in 2024** updated — name → 'Brand mentions 2025'."*
+   - ❌ *"Project `a4305b57-1c79-4cec-a17c-16eb1d959ea6` deleted."*
+   - If the entity has **no human-readable name** (e.g. an anonymous prompt or a job), use a short 8-character prefix: *"Prompt `2a2a8f4f…` deleted."* Never paste the full UUID.
+
+3. **Always exception: `--json` mode.** When the user passes `--json` to a script or explicitly asks for raw JSON / debug output, print the script output verbatim — do not strip IDs.
+
+4. **Internally, the agent still uses full UUIDs** for every API call (`--project-id`, `--topic-id`, `--prompt-id`, etc.). The display rules only affect what is shown back to the user.
+
+---
+
+## Step 1: Make sure GEO_API_KEY is configured
+
+Scripts auto-load `GEO_API_KEY` from `<skills-root>/.env` on import — **no `export` needed, no shell restart needed**. To check the configuration, run any script (it prints the exact `.env` path if the key is missing).
+
+- ✅ Key already in `<skills-root>/.env` → proceed.
+- ❌ Key missing, or user just gave you a new key → go to the **adgine-geo-projects** skill, **Step 0**, which runs `python3 <skills-root>/setup.py <KEY>` to write the key into the correct `.env` file. **Never** write the key to `~/.zshrc`, `~/.bashrc`, Hermes global config, or any user-secrets store.
+
+> ⚠️ **IMPORTANT:** In all shell/exec commands, always reference the key as `$GEO_API_KEY` (the environment variable). Never hardcode the literal value.
+
+## Scripts
+
+### 1) Check subdomain availability
+
+```bash
+python3 scripts/check_domain.py --subdomain mysite [--json]
+```
+
+### 2) Create the website (async)
+
+```bash
+python3 scripts/create_website.py --subdomain mysite \
+    --brand-name "My Site" \
+    --industry "SaaS" \
+    --description "An AI-first content platform" \
+    --language English \
+    [--json]
+```
+
+Returns a `task_id`. Pass it to the next step.
+
+### 3) Track the deployment task
+
+```bash
+python3 scripts/get_task.py --task-id <id> [--poll] [--json]
+```
+
+Add `--poll` to block until the task reaches `Completed` or `Failed`.
+
+> ⏳ **Expected duration: 5–15 minutes.** The script polls automatically (interval 10 s, timeout 20 min). Do NOT cancel early — website deployment involves provisioning infrastructure.
+
+## Recommended flow
+
+> 🌐 **Step 1.** Check `mysite` is available.
+>
+> 🚀 **Step 2.** Start deployment, capture `task_id`.
+>
+> ⏳ **Step 3.** Poll status (use `--poll`).
+>
+> ✅ When the task reports `Completed`, the script prints the site URL **and** the WordPress admin login URL, username, and password automatically.
+
+## Output Format
+
+ASCII tables only. Status vocabulary:
+`Pending` / `Generating` / `Completed` / `Failed`.
+
+```
+┌────────────────────┬──────────────────────────────┐
+│ Field              │ Value                        │
+├────────────────────┼──────────────────────────────┤
+│ status             │ Generating                   │
+│ progress           │ 60%                          │
+│ subdomain          │ mysite                       │
+└────────────────────┴──────────────────────────────┘
+```
+
+### Completed state — always show WordPress credentials
+
+When `status` is `Completed` **and** the response includes `wp_username` / `wp_password`, the script automatically appends a second table with the WordPress login details:
+
+```
+🎉 Your website is live! WordPress login details:
+
+┌────────────────────┬──────────────────────────────┐
+│ WordPress          │ Info                         │
+├────────────────────┼──────────────────────────────┤
+│ login URL          │ https://mysite.adgine.net/wp-login.php │
+│ username           │ admin                        │
+│ password           │ xxxxxxxx                     │
+└────────────────────┴──────────────────────────────┘
+```
+
+- The login URL is derived from the `domain` field in the task response: `https://<domain>/wp-login.php`. The `domain` is the full subdomain (e.g. `gamecalc.adgine.net`); `adgine.net` and `/wp-login.php` are always fixed.
+- **Never omit** the credentials table when status is Completed — this is the primary way the user learns how to access their new site.
+
+## Related endpoints
+
+| Method | Path |
+|---|---|
+| GET | `/api/saas/domain/check` |
+| POST | `/api/saas/websites` |
+| GET | `/api/saas/task/{task_id}` |
+
+---
+
+## Post-task recommendations
+
+After SaaS website deployment, guide the user to set up their GEO workflow:
+
+| Scenario | → use skill (agent-internal) |
+|---|---|
+| Deployment completed | 确认项目已创建，设置 `GEO_PROJECT_ID` *(→ adgine-geo-projects)*|
+| Site is live | 为新网站生成品牌画像 *(→ adgine-geo-brand)*|
+| Site is live | 创建主题和 AI 搜索提示词 *(→ adgine-geo-topics)*|
+| Deployment failed | 检查错误信息，修正后重试 *(→ adgine-geo-saas)*|
+| WordPress credentials received | 保存凭证后连接 WordPress 站点 *(→ adgine-geo-wordpress)* |
+
+**⚠️ Output rule:** Do NOT write skill names (e.g. `adgine-geo-xxx`) in user-facing suggestions. Each suggestion must be phrased as a natural-language prompt the user can copy and send directly to the agent.
+
+> 💡 **建议下一步：**
+> 1. **[行动标题]** — *"[可直接发送给 AI 的自然语言提示词]"*
+> 2. **[行动标题]** — *"[可直接发送给 AI 的自然语言提示词]"*