AI导哈

AI SEO代理

一个生产就绪的Python SEO代理，将GPT-4o、Google Search Console、Google Analytics 4和DataForSEO集成到一个自主循环中，具有持久内存、Streamlit仪表板和VS Code MCP服务器，使GitHub Copilot可以直接从编辑器中运行SEO查询。

  • by SimplerSoftwareIO
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 SimplerSoftwareIO/seo-ai-agent

使用说明

🔍 AI SEO代理

一个生产就绪的Python SEO代理，可以连接 GPT-4o, Google搜索控制台, 谷歌分析4，以及 DataForSEO 进入一个单一的自治循环——具有持久内存、Streamlit仪表板和VS Code MCP服务器，因此GitHub Copilot可以直接从您的编辑器运行SEO查询。

📖 完整架构演练: 如何用Python构建AI SEO代理

这有什么不同

大多数开源AI SEO脚本都是围绕单个API调用的薄包装。相比之下，商业工具不会向您自己的代码库公开这些功能：

功能 此代理 其他开源脚本
持久内存（SQLite） ✅ 每周跟踪关键字移动 ❌
MCP服务器（VS代码集成） ✅ GitHub Copilot聊天中的39个工具❌
自主周计划 ✅ 运行周一08:00，保存Markdown报告 ❌
多源数据融合 ✅ GSC+GA4+DataForSEO+Firecrawl ❌
撰写并发布至 你的 博客 ✅ 生成Astro就绪的Markdown，提交到您的仓库 ❌
Shopify应用商店ASO+网络搜索引擎优化✅ 一个代理中的两个属性 ❌
AI概述/LLM品牌跟踪 ✅ 检查SGE/ChatGPT/Gemini中的品牌知名度 ❌

建筑

特性

🔎 GSC和关键字智能

  • 热门查询、页面性能、速赢机会（位置4-20）
  • URL检查（索引状态、规范、覆盖状态）
  • 存储在SQLite中的每周排名增量跟踪

📊 GA4流量分析

  • 按频道、首页、12周趋势划分的会议
  • 支持多种属性（网站+辅助应用程序/店面）

🎯 DataForSEO集成

  • SERP查找、排名跟踪、关键字难度（0-100）
  • 竞争对手关键字分析、反向链接配置文件
  • 相关关键词、域名权威

🤖 AI概述/SGE跟踪

  • 检测目标查询是否显示AI概述
  • 统计品牌提及次数和情绪信号

✍️ 内容生成

  • 完整博客作者：内容简介→ SERP分析→ 已发布Markdown
  • 元标签生成器：标题（≤60个字符）+描述（140-155个字符）
  • 登录页面副本（英雄、福利、常见问题解答、CTA）
  • 内部链接分析器：孤立页面+特定添加链接建议

🛍️ 应用商店狗（Shopify）

  • 获取自己和竞争对手的列表
  • 回顾情绪分析
  • App Store查询的搜索可见性

🕸️ MCP服务器（VS代码）

  • 39个工具注册为FastMCP服务器
  • 适用于GitHub Copilot Chat、Cursor和任何兼容MCP的客户端
  • 跑 check quick wins 或 write a blog post about X 直接从你的编辑

⏰ 自主调度器

  • 每周一08:00跑步
  • 将每周Markdown报告保存到 reports/
  • 跟踪排名移动并在SQLite中缓存API响应

快速开始

1.克隆并安装

git clone https://github.com/your-org/seo-agent.git
cd seo-agent
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

2.配置凭据

cp .env.example .env

编辑 .env --所需的凭据和密钥设置：

变量 必填 从哪里获取/备注
OPENAI_API_KEY ✅ platform.openai.com
DATAFORSEO_LOGIN ✅ dataforseo.com --按次付费，每次通话约$0.001/次
DATAFORSEO_PASSWORD ✅ 相同帐户
FIRECRAWL_API_KEY ✅ firecrawl.dev --500次免费爬行/月
GOOGLE_SERVICE_ACCOUNT_JSON ✅ GCP控制台→ 服务账户→ JSON密钥（授予GSC所有者+GA4查看器）
GSC_SITE_URL ✅ Google搜索控制台中的精确URL（例如。 https://yoursite.com/)
GA4_PROPERTY_ID ✅ GA4 → 管理员→ 属性设置→ 物业ID
TARGET_WEBSITE ✅ 您的域名没有协议（例如。 yoursite.com)
GA4_PROPERTY_ID_APP ➖ 第二个GA4属性（例如用于Shopify应用程序列表）
SHOPIFY_APP_SLUG ➖ 你的应用程序的slug来自 apps.shopify.com/your-slug
BRAND_NAME ➖ 在生成的副本中使用--默认为大写域名
TRACKED_PAGES ➖ 在仪表板中监视逗号分隔的URL
TRACKED_KEYWORDS ➖ 逗号分隔的关键字用于每周排名跟踪
OPENAI_MODEL ➖ 违约： gpt-4o
OPENAI_MODEL_DEEP ➖ 违约： o3-mini --用于复杂的分析任务
COPYWRITER_MODEL ➖ 违约： gpt-4o --交换到 claude-3-7-sonnet 为了更好的散文
BLOG_AUTHOR ➖ 将作者姓名写入生成的帖子封面
BLOG_CONTENT_DIR ➖ Astro博客内容文件夹的绝对路径（如果未设置，则自动检测）

3.运行CLI代理

python agent.py

示例提示：

  • What are my quick wins this week?
  • Write a blog post about AI product photography
  • Check if https://yoursite.com/blog/post is indexed
  • Analyse internal links for https://yoursite.com

4.运行Streamlit仪表板

streamlit run ui.py

开放时间： http://localhost:8501 一个完整的多页仪表板，涵盖了所有9个功能领域。

5.作为MCP服务器连接到VS Code

添加到您的VS代码 settings.json （或 mcp.json 在您的工作空间中）：

{
  "mcp": {
    "servers": {
      "seo-agent": {
        "command": "python",
        "args": ["/absolute/path/to/seo-agent/mcp_server.py"],
        "env": {
          "PYTHONPATH": "/absolute/path/to/seo-agent"
        }
      }
    }
  }
}

然后打开 GitHub Copilot 聊天助手 (@workspace)并询问：

“查看我的网站的速赢结果” 或 “我排名4-20的关键词是什么？”

6.运行每周日程表

python scheduler.py

在后台运行，每周一08:00点火，并保存一个 reports/YYYY-MM-DD.md 报告。

项目结构

seo-agent/
├── agent.py          # CLI entry point + GPT-4o tool-calling loop
├── mcp_server.py     # FastMCP server (VS Code / Copilot Chat integration)
├── ui.py             # Streamlit dashboard (1,600+ lines, 9 pages)
├── scheduler.py      # Autonomous weekly report runner
├── memory.py         # SQLite schema + helpers (5 tables)
├── config.py         # All credentials loaded from .env
├── requirements.txt
├── .env.example      # Copy → .env and fill in credentials
└── tools/
    ├── gsc.py        # Google Search Console (9 functions)
    ├── ga4.py        # Google Analytics 4
    ├── dataforseo.py # SERP, keywords, backlinks, domain authority
    ├── crawler.py    # Firecrawl page crawl + extraction
    ├── appstore.py   # Shopify App Store ASO
    ├── copywriter.py # Blog post + meta tag + landing page writer
    ├── content_brief.py # SERP-driven content brief generator
    └── internal_links.py # Internal link graph analysis

型号和成本

设置 默认值 注释
OPENAI_MODEL gpt-4o 代理推理循环
OPENAI_MODEL_DEEP o3-mini 复杂的多步骤分析
COPYWRITER_MODEL gpt-4o 博客文章写作（交换到 claude-3-7-sonnet 为了更好的散文）

典型成本： 每次代理会话<0.10美元 （主要是DataForSEO API调用，而不是LLM令牌）。

贡献

PR欢迎。添加功能最干净的地方是中的新文件 tools/那么：

  1. 在中注册该函数 TOOLS 数组in agent.py
  2. 添加 @mcp.tool() 包装 mcp_server.py
  3. 在中添加UI选项卡 ui.py

许可证

麻省理工学院——见 许可证.

由构建并开源 %s的名单越来越多.阅读 全建筑岗位 深入了解每个组件是如何组合在一起的。

相关 MCP