使用说明
Superlines AEO代理
🚧 进行中 --该项目在当地进行，目前正在积极开发中。自动化部署（GitHub Actions，cron）即将推出。期待突破性的变化。
一个由人工智能驱动的内容智能和优化代理，每天运行一个7阶段的管道，用于 人工智能搜索引擎优化（AEO/GEO）.内置 马斯特拉, 超级线路MCP, 明亮数据MCP，以及 Sanity CMS.
它的作用
该代理每天使用3个专门的AI代理运行7个阶段：
| 阶段 | 代理 | 它做什么 |
|---|---|---|
| 1.情报收集 | 分析师 | 读取Superlines AI搜索数据：品牌知名度、引用、竞争差距、内容机会 |
| 2.Competitive Deep Dive | 分析师+研究员 | 识别获得AI引用的顶级竞争对手网址，抓取并分析其内容 |
| 3.内容健康审计 | 内容管理器 | 扫描现有的Sanity文章以查找过时的内容，标记需要更新的文章 |
| 4.事实核查 | 内容经理+研究员 | 从文章中提取定价/统计声明，根据实时来源进行验证 |
| 5.行业洞察 | 研究员 | 搜索热门话题、Reddit讨论、行业报告 |
| 6.数据故事 | 分析师 | 在分析数据中发现有趣的模式，以嵌入文章中 |
| 7.内容操作 | 内容管理器 | 创建新文章草稿、更新现有文章、修复不正确的事实 |
建筑
┌──────────────────────────────────────────────────────┐
│ Daily Pipeline │
│ │
│ ┌─────────┐ ┌────────────┐ ┌──────────────────┐ │
│ │ Analyst │ │ Researcher │ │ Content Manager │ │
│ │ Agent │ │ Agent │ │ Agent │ │
│ └────┬─────┘ └─────┬──────┘ └────────┬─────────┘ │
│ │ │ │ │
│ ┌────┴──────────────┴───────────────────┴─────────┐ │
│ │ Shared Memory (LibSQL) │ │
│ │ - Message History - Working Memory │ │
│ │ - Thread Isolation - Cross-run Persistence │ │
│ └──────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────┘
│ │ │
┌────┴────┐ ┌──────┴──────┐ ┌────┴─────┐
│Superlines│ │ Bright Data │ │ Sanity │
│ MCP(SSE) │ │ MCP (SSE) │ │ CMS │
└──────────┘ └─────────────┘ └──────────┘
技术栈：
- 马斯特拉 --带有MCP、内存和多步工具调用的TypeScript AI代理框架
- 超级线路MCP --32个人工智能搜索分析工具（品牌知名度、引用、竞争差距、网页审计）
- 明亮数据MCP --用于竞争对手研究和事实核查的网络抓取和搜索工具
- Sanity CMS --用于阅读和撰写文章的无头CMS
- LibSQL --持久内存存储（本地SQLite或Turso远程）
快速开始
先决条件
- Node.js 22.13+
- 超级线路 账户 （入门计划或以上），带有API密钥
- Anthropic API密钥 对于克劳德
- 开放人工智能 API密钥 用于嵌入
- 明亮的数据 API令牌 （免费等级：5000次请求/月）
- 理智 项目 带有写入令牌
1.克隆并安装
git clone https://github.com/Superlines/aeo-agent.git
cd aeo-agent
npm install
2.配置环境
cp .env.example .env
# Edit .env with your API keys
看 .env.example 对于所有可用的配置选项。
3.运行管道
npm start
根据文章数量和内容操作，管道需要5-15分钟。报告保存到 data/reports/.
文件结构
aeo-agent/
├── src/
│ ├── index.ts # Entry point, env validation
│ ├── pipeline.ts # 7-phase pipeline orchestrator
│ ├── report.ts # Report generator (markdown, Slack)
│ ├── mastra/
│ │ ├── index.ts # Mastra initialization (singleton)
│ │ ├── agents.ts # 3 agent definitions with specialized instructions
│ │ ├── mcp.ts # MCP client setup (Superlines + Bright Data)
│ │ ├── memory.ts # Memory config (LibSQL, working memory)
│ │ └── tools/
│ │ └── sanity.ts # Sanity CMS tools (list, get, create, update, fact-check)
│ └── utils/
│ ├── sanity-client.ts # Sanity API client + GROQ queries
│ ├── fact-check.ts # Claim extraction (pricing, stats, features, dates)
│ └── markdown-to-portable-text.ts # Markdown → Sanity Portable Text converter
├── data/ # Runtime data (memory DB, reports)
├── .env.example # Environment variable template
├── package.json
├── tsconfig.json
└── README.md
关键设计决策
为什么是3个代理而不是1个？ 将Superlines（32个工具）和Bright Data（8+个工具）中的所有MCP工具加载到单个代理中，会使组合工具模式超过Claude的20万令牌上下文限制。按角色划分可以使每个代理的上下文易于管理。
为什么禁用语义回忆？ 之前的管道运行包含大型MCP工具响应（100k+令牌）。当语义回忆将这些重新注入到未来的对话中时，它们就会突破上下文限制。工作记忆提供了一种结构紧凑的替代方案。
为什么每个阶段都有线程？ 每个流水线阶段都会写入自己的内存线程。这可以防止阶段1的工具结果挤占阶段7的上下文窗口。
为什么只写草稿？ 所有新文章都是通过以下方式创建的 draft=true代理人从不直接发布。一个人在Sanity Studio中对每篇文章进行评论，然后再发表。
成本估算
| 组件 | 每次运行成本 |
|---|---|
| 克劳德·十四行诗4 | ~0.50-2美元 |
| 克劳德作品4 | ~1-4美元 |
| 超级线路MCP | 包含在计划中 |
| 明亮数据MCP | 自由层（每月需要5k） |
| Sanity CMS | 免费版 |
| 每日总计（十四行诗） | ~$0.50-2 |
| 每日总计（Opus） | ~$1-4 |
大约 15-120美元/月 根据型号选择，每天运行。
安全
- 所有新文章创建为 草稿 --从未自动发布
- Superlines MCP工具 只读 --他们从不修改您的分析帐户
- 内容更新仅更改特定字段，从不删除内容
- 内存数据库中的完整审计跟踪
状态
| 功能 | 状态 |
|---|---|
| 本地管道执行 | ✅ 作品 |
| 7相日用管道 | ✅ 作品 |
| 超级线路MCP集成 | ✅ 作品 |
| Bright Data MCP集成 | ✅ 作品 |
| Sanity CMS读/写 | ✅ 作品 |
| 事实核查管道 | ✅ 作品 |
| 报告生成（标记） | ✅ 作品 |
| 延迟通知 | ✅ 作品 |
| GitHub操作部署 | 🚧 即将推出 |
| Vercel部署挂钩 | ✅ 作品 |
| 远程存储器（Turso） | ✅ 作品 |
相关
- 食谱：构建代理AEO内容管道 --分步指南
- Superlines MCP文档 --设置和工具参考
- Mastra文档 --代理框架参考
- 明亮数据MCP --Web抓取MCP服务器
许可证
麻省理工学院
