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调用的薄包装。相比之下，商业工具不会向您自己的代码库公开这些功能：

______________________________________________________________________

建筑

______________________________________________________________________

特性

🔎 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 --所需的凭据和密钥设置：

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

______________________________________________________________________

型号和成本

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

______________________________________________________________________

贡献

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

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

______________________________________________________________________

许可证

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

______________________________________________________________________

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