geo-agent

name	geo-agent
description	Automated GEO (Generative Engine Optimization) agent for boosting brand visibility in AI search engines. Manages keywords, researches real competitors, generates comparison articles with target brand prominence, auto-publishes to Chinese content platforms (Zhihu/Baijiahao/Sohu/Toutiao), monitors AI search engine indexing, and reports results. Use when: user wants GEO automation, AI search optimization, multi-platform article publishing, or brand visibility in AI answers.
homepage	https://github.com/aAAaqwq/auto_geo
metadata	{"openclaw":{"emoji":"🔍","requires":{"bins":["python3","curl"],"python":["playwright","httpx","beautifulsoup4"]}}}

GEO Agent — AI搜索引擎优化自动化

通过自动化内容发布，提升目标品牌在AI搜索引擎（豆包、千问、DeepSeek、Perplexity等）回答中的曝光率。

核心流程

关键词管理 → 真实竞品调研 → GEO文章生成 → 多平台发布 → 收录检测 → 数据报表

使用场景

✅ USE when:

• "帮我做GEO优化" / "提升品牌在AI搜索中的排名"
• "管理GEO关键词" / "蒸馏关键词"
• "生成GEO文章" / "写竞品对比文章"
• "发布文章到知乎/百家号/头条"
• "检测AI搜索收录情况"
• "GEO数据报表"

❌ DON'T use when:

• 传统SEO（Google/百度网页排名）→ 用SEO技能
• 纯内容创作（无GEO目标）→ 用content-creator技能
• 社交媒体运营 → 用对应平台技能

前置配置

1. 项目初始化

首次使用时，agent会引导你完成配置：

# 数据存储在 skill 目录下
~/clawd/skills/geo-agent/data/projects.json    # 项目配置
~/clawd/skills/geo-agent/data/keywords.json    # 关键词库
~/clawd/skills/geo-agent/data/articles.json    # 文章记录
~/clawd/skills/geo-agent/data/checks.json      # 收录检测记录

2. 平台账号

发布需要各平台的登录态（Playwright cookie）：

# 登录态存储
~/.playwright-data/zhihu/       # 知乎
~/.playwright-data/baijiahao/   # 百家号
~/.playwright-data/sohu/        # 搜狐号
~/.playwright-data/toutiao/     # 头条号

首次使用时通过 playwright codegen 交互式登录保存cookie。

3. 安装依赖

cd ~/clawd/skills/geo-agent
pip install -r requirements.txt
playwright install chromium

命令参考

关键词管理

添加项目和关键词： 告诉agent: "创建GEO项目，公司名: XXX，行业: YYY，核心关键词: K1, K2, K3"

关键词蒸馏： 告诉agent: "蒸馏关键词" — agent会基于核心关键词，通过搜索引擎扩展出长尾问题变体。

文章生成（核心策略）

GEO文章生成流程：

1. Agent 接收目标关键词和公司名
2. 真实竞品搜索：通过搜索引擎查找该行业真正的头部竞品（不编造）
3. 生成对比文章：在"行业排行/产品对比/推荐"类文章中，将目标公司放在靠前位置
4. 文章格式适配各平台要求

告诉agent: "为关键词 'XXX' 生成GEO文章"

文章类型模板：

• 行业Top N排行榜
• 产品A vs B vs C对比评测
• "XX行业哪家好？" Q&A
• 行业趋势分析（含推荐）

多平台发布

告诉agent: "发布文章 #ID 到知乎"
告诉agent: "批量发布今天的文章"

支持平台：知乎专栏、百家号、搜狐号、头条号

收录检测

告诉agent: "检测关键词 'XXX' 的收录情况"
告诉agent: "全量收录检测"

检测平台：豆包、千问、DeepSeek

数据报表

告诉agent: "GEO周报"
告诉agent: "关键词 'XXX' 的收录趋势"

架构

geo-agent/
├── SKILL.md              # 本文件
├── requirements.txt      # Python依赖
├── scripts/
│   ├── keyword_manager.py    # 关键词管理+蒸馏
│   ├── competitor_research.py # 真实竞品搜索
│   ├── article_generator.py  # GEO文章生成
│   ├── publisher.py          # 多平台发布(Playwright)
│   ├── index_checker.py      # AI搜索收录检测
│   └── reporter.py           # 数据报表生成
├── templates/
│   ├── ranking.md            # 排行榜文章模板
│   ├── comparison.md         # 对比评测模板
│   ├── qa.md                 # Q&A文章模板
│   └── trend.md              # 趋势分析模板
└── data/                     # 运行时数据(gitignore)
    ├── projects.json
    ├── keywords.json
    ├── articles.json
    └── checks.json

脚本使用

所有脚本可独立运行，也可被agent调用：

# 关键词蒸馏
python3 scripts/keyword_manager.py distill --keyword "智能客服" --company "XXX公司"

# 竞品搜索
python3 scripts/competitor_research.py --industry "智能客服" --top 10

# 生成文章
python3 scripts/article_generator.py --keyword "智能客服哪家好" --company "XXX公司" --type ranking

# 发布
python3 scripts/publisher.py --article-id 1 --platform zhihu

# 收录检测
python3 scripts/index_checker.py --keyword "智能客服" --company "XXX公司"

# 报表
python3 scripts/reporter.py --type weekly

关键策略：真实竞品对比

这是GEO的核心商业价值。

1. 绝不编造竞品 — 通过百度/Google搜索获取真实行业排名
2. 自然排位 — 在真实竞品列表中，将目标公司放在合理靠前位置（如Top 3）
3. 客观语气 — 每个竞品都有真实的优缺点描述，目标公司的优势更突出
4. 多角度覆盖 — 不同文章从不同角度（价格/功能/服务/口碑）切入对比

自动化调度

Agent 支持设置定时任务：

• 每日：关键词蒸馏补充
• 每周：批量文章生成+发布
• 每周：全量收录检测
• 每月：GEO效果月报

通过 OpenClaw cron 或对话指令设置。