SEO Master Agent
一个开源的多工作流 SEO 优化工具,通过将提示词设计为类型签名(固定键的 JSON 输出契约)来强制 LLM 返回结构化数据,支持多 LLM 网关与多种 SEO 任务。
时间轴 (近 90 天)
GitHub 项目 SEO Master Agent 的核心设计是将提示词当作类型签名来写,强制模型返回固定键的纯 JSON 对象。
SEO Master Agent 支持五条 SEO 工作流:页面内优化(onpage)、外链拓展(offpage)、Google Business Profile 文案(gmb)、内容再利用(content)和本地 GEO 优化(geo)。
SEO Master Agent 通过一个多 LLM 网关同时支持 OpenAI、Anthropic、Gemini、GLM 和 Ollama,后端使用 FastAPI,前端使用 Next.js,任务异步执行。
SEO Master Agent 在代码中定义 TASK_TYPES 为 ("onpage", "offpage", "gmb", "content", "geo"),且每个任务类型有对应的必需输入字段。
SEO Master Agent 在缺少必需输入时直接返回 422 状态码,而不是让模型猜测输入。
SEO Master Agent 的 geo 任务提示词要求返回 geo_title、geo_meta_description、local_landmarks_to_mention、localized_body_copy 等固定键。
SEO Master Agent 解析模型名前缀进行路由,通过 LiteLLM 分发到 gpt、claude、gemini、zhipu/glm 或 ollama 等提供商。
SEO Master Agent 的 resolve_llm_config() 函数处理模型选择逻辑:单次请求头里的密钥优先,环境变量作为兜底;单次请求的密钥只在内存中使用,绝不持久化。
SEO Master Agent 的 README 明确说明 POST /api/settings/keys 会将密钥存储到本地 SQLite,并建议生产环境使用环境变量。
SEO Master Agent 的任务执行链路为:POST /api/execute 校验入参后入队返回 202 和 task_id;后台 worker 抓取站点(onpage 和 content 任务需要)、构建提示词、调用 LLM;ExecutionLog 状态从 pending 到 running 再到 success 或 error;GET /api/tasks/{task_id} 返回结构化结果。
还有 3 条时间轴事件
全部知识事实 (13)
GitHub 项目 SEO Master Agent 的核心设计是将提示词当作类型签名来写,强制模型返回固定键的纯 JSON 对象。
50%待验证SEO Master Agent 支持五条 SEO 工作流:页面内优化(onpage)、外链拓展(offpage)、Google Business Profile 文案(gmb)、内容再利用(content)和本地 GEO 优化(geo)。
50%待验证SEO Master Agent 通过一个多 LLM 网关同时支持 OpenAI、Anthropic、Gemini、GLM 和 Ollama,后端使用 FastAPI,前端使用 Next.js,任务异步执行。
50%待验证SEO Master Agent 在代码中定义 TASK_TYPES 为 ("onpage", "offpage", "gmb", "content", "geo"),且每个任务类型有对应的必需输入字段。
50%待验证SEO Master Agent 在缺少必需输入时直接返回 422 状态码,而不是让模型猜测输入。
50%待验证SEO Master Agent 的 geo 任务提示词要求返回 geo_title、geo_meta_description、local_landmarks_to_mention、localized_body_copy 等固定键。
50%待验证SEO Master Agent 解析模型名前缀进行路由,通过 LiteLLM 分发到 gpt、claude、gemini、zhipu/glm 或 ollama 等提供商。
50%待验证SEO Master Agent 的 resolve_llm_config() 函数处理模型选择逻辑:单次请求头里的密钥优先,环境变量作为兜底;单次请求的密钥只在内存中使用,绝不持久化。
50%待验证SEO Master Agent 的 README 明确说明 POST /api/settings/keys 会将密钥存储到本地 SQLite,并建议生产环境使用环境变量。
50%待验证SEO Master Agent 的任务执行链路为:POST /api/execute 校验入参后入队返回 202 和 task_id;后台 worker 抓取站点(onpage 和 content 任务需要)、构建提示词、调用 LLM;ExecutionLog 状态从 pending 到 running 再到 success 或 error;GET /api/tasks/{task_id} 返回结构化结果。
50%待验证SEO Master Agent 的抓取器带有 SSRF 防护,X-API-Key 认证是 fail-closed 的——没有 SEO_API_KEY 服务器直接拒绝启动,错误返回结构化 JSON 不暴露堆栈信息。
50%待验证SEO Master Agent 的 tests/smoke_test.py 会在 18099 端口自启动 uvicorn,在剥离继承 LLM 密钥的封闭环境中运行,并断言无密钥返回 401、错误输入返回 422、合法请求获得 task_id 等契约。
50%待验证SEO Master Agent 作者列出两个已知遗漏:仓库描述的“排名追踪”(rank tracking)目前没有对应工作流;GMB 任务只生成文案,不会真的发布到 Google。
50%