GEO Agent Crew 使用 CrewAI 来自动化执行由 AI 驱动的网页内容审计。输入一个 URL，系统将访问该网页、提取其标题，使用 带有 Google Search 工具的 Gemini 生成并汇总相关查询，通过 Bright Data SERP API 获取 Google AI Overviews，对比结果，并以 Markdown 文件输出可执行的页面级优化建议。

---

🤖 了解你的 Crew

ai-content-optimization-agent Crew 由六个 AI 代理组成，每个代理拥有独特的角色、目标与工具。这些代理协作完成在 config/tasks.yaml 中定义的一系列任务，利用集体能力实现复杂目标。config/agents.yaml 文件则概述了你团队中每个代理的能力与配置。

🛠️ 安装

请确保你的系统已安装 Python >=3.10 ❤️.14。

本项目使用 uv 进行依赖管理与包处理。
首先，如果尚未安装 uv，请执行：

pip install uv

接着，进入你的项目目录并安装项目依赖：

cd geo-ai-agent
uv sync

---

🔑 环境配置

本项目需要以下四个环境变量：

• GEMINI_API_KEY：你的 Gemini API key。
• MODEL：为你的代理团队提供能力的 Gemini 模型名称（例如：gemini/gemini-2.5-flash）。
• BRIGHT_DATA_API_KEY：你的 Bright Data API key。
• BRIGHT_DATA_ZONE：你希望连接的 Bright Data 仪表盘中的 Web Unlocker 区域 名称。

你可以在终端中直接设置它们，或在项目根目录放置一个 .env 文件：

geo-ai-agent/
├── ...
├── .env # <---
└── src/
    └── ai_content_optimization_agent/
        └── ...

以如下内容填充 .env 文件：

GEMINI_API_KEY="<YOUR_GEMINI_API_KEY>"
MODEL="<CHOSEN_GEMINI_MODEL>"
BRIGHT_DATA_API_KEY="<BRIGHT_DATA_API_KEY>"
BRIGHT_DATA_ZONE="<YOUR_BRIGHT_DATA_ZONE>"

▶️ 运行项目

激活由 uv sync 命令创建的 .venv：

 source .venv/bin/activate

或在 Windows 上：

.venv/Scripts/activate

在激活虚拟环境后，于项目根目录运行以下命令来启动你的 AI 代理团队：

crewai run

该命令会初始化 ai-content-optimization-agent 团队，按照 CrewAI 配置文件组装代理并分配任务。

☑️ 应用将生成一个 output/report.md 文件，以及其他包含代理中间数据与结果的 ouput/*.md 文件。

---

⚙️ 自定义

• 🔧 更新 MODEL 环境变量以更换该代理团队使用的 Gemini 模型。
• 🧑‍💻 编辑 src/ai_content_optimization_agent/config/agents.yaml 修改代理定义。
• 📋 编辑 src/ai_content_optimization_agent/config/tasks.yaml 修改分配给代理的任务定义。
• 🛠️ 更新 src/ai_content_optimization_agent/crew.py 以集成其他 AI 模型或加入你的自定义逻辑与工具。
• ⚡ 编辑 src/ai_content_optimization_agent/main.py 为代理与任务添加自定义输入。

---

💬 支持

关于 ai-content-optimization-agent 团队或 CrewAI 的支持、问题或反馈：

• ☀️ 访问 Bright Data 的 SERP API 文档
• 📖 访问 CrewAI 的 文档
• 🐙 通过 GitHub 仓库 联系 CrewAI
• 💬 加入 Discord
• 💡 与 CrewAI 的文档对话

---

✨ 借助 Bright Data 与 CrewAI 的强大与简洁，让我们一起创造奇迹。