DispatchSEO

DispatchSEO

 

网站  ·  Discord  ·  讨论区  ·  托管版本

可自托管版本没有任何功能限制。付费
云服务能做的一切，这个仓库现在都能做到，使用你自己的账户，费用为 $0。

## ⚡ 工作原理

1. AI 负责研究。 claude.ai 上的 Claude 应用，或编码 Agent（Claude Code、Codex、Cursor），通过 MCP 连接到 DispatchSEO，读取所提供的操作手册，并根据你的 Search Console 数据、Google Autocomplete 以及它已有的产品知识挖掘关键词。创意会连同推理依据一起进入队列。
2. 由你决定是否批准。 每个创意都会以卡片形式显示在仪表板上：关键词、为什么有机会胜出，以及切入角度。你可以批准、拒绝或重新排序。更喜欢全自动模式？开启自动模式，完全跳过队列即可。
3. 流水线开始构建。 每天早上，定时任务会选取最早获批的创意，并针对你的网站代码仓库将其构建成一个真正的拉取请求：一篇指南或一个小型免费工具。内容会经过实时 SERP 检查，并由避免内容雷同的审查器审核，确保第 12 页的内容读起来不会像第 3 页。
4. 追踪后续情况。 每日排名检查、每小时 Search Console 快照、索引验证，以及展示你当前实际处于哪个 SEO 阶段的旅程视图。定时任务出错时，你会看到红色横幅并收到邮件，而不是毫无动静。

后端刻意保持简单：状态、调度和审批关卡。思考工作由你的 Agent 完成，你的产品知识本来就在那里。

🤖 选择哪种编码 Agent

DispatchSEO 通过 MCP 与你的 Agent 对话，因此“选择哪种 Agent”是个有实际答案的问题——包括尚未完成的部分。

Agent	连接并使用所有工具	无人值守的夜间构建器
Claude Code	✅	✅
Codex	✅	✅
Cursor	✅ 一次粘贴即可连接，使用全部 61 个工具	✅ 通过其 API 密钥（任何套餐都能生成密钥）
Gemini CLI · Copilot · 任意 MCP 客户端	✅	❌

只需粘贴一次即可完成连接并使用整套工具：研究、队列、审批、反向链接、报告，以及按需构建指南。夜间构建器则是另一项独立功能——定时任务会在无人监看时运行 Agent——这三种 Agent 都支持该功能。每个工作流都支持所有 Agent，并会询问仪表板要运行哪一种，因此切换 Agent 后，无需更改代码仓库，下次定时运行时就会生效。

实际区别在于由谁付费：Claude Code 使用你已有的订阅运行，Cursor 使用 Cursor 套餐中的 API 密钥运行，而 Codex 则由 OpenAI 按运行次数计费。

你也可以完全跳过编码 Agent。在 claude.ai 上将 DispatchSEO 添加到普通 Claude 应用中作为自定义连接器，Claude 就会使用你已有的订阅进行研究和写作，然后将文章交回后端检查、完善并发布。它无法构建交互式工具或运行夜间构建器，而且 claude.ai 必须能够访问你的安装，因此这种方式需要使用公共 URL，而不是笔记本电脑。本地 ChatGPT 还无法连接。

docs/AGENTS.md 介绍了详细信息、支持级别以及如何添加 Agent。

✅ 开始前的准备

• 发布平台。 可以是自行托管的 WordPress：在“设置”中使用应用程序密码连接一次，然后直接发布；也可以是网站所在的 GitHub 仓库，内容会以拉取请求的形式提交。Wix、Squarespace、Shopify、Webflow 和 Ghost 都没有这两种方式，因此无法使用。
• 驱动它的 AI。 AI 是引擎，可以是 claude.ai 上的普通 Claude 应用，也可以是编码 Agent。Claude Code 使用你已经付费订阅的 Claude 服务；Codex 和 Cursor 都能完成 Claude Code 在这里能做的所有事，包括夜间构建器。Codex 按运行次数由 OpenAI 计费，Cursor 构建则使用 Cursor 计划中包含的额度。请参阅上方的表格。
• 装有 Docker 的设备（约 1 GB RAM）。笔记本电脑可以用于试用，但日常使用最好选择一台始终开机的设备——5 美元的 VPS、Raspberry Pi，或一台永不休眠的台式电脑。设备只有在开机时才会按计划运行。
• 你的网站的 Google Search Console 访问权限。

以上就是全部要求。不用购买 API 密钥，也不需要在我们这边注册账号。

📖 文档

所有内容都在 dispatchseo.com/docs——每个页面、每项设置和每个工具。

初次使用	DispatchSEO 是什么 · 工作原理 · 云端还是可自托管
安装	快速入门 - 使用自己的电脑、VPS，或从源代码安装
设置	安装 Claude Code · 安装 Codex · 安装 Cursor · 设置向导 · Search Console · 关键词数据 · 发布 · 连接你的网站
使用	日常使用 · 控制面板 · 自动化 · Agent 命令
参考	概念 · MCP 工具 · 环境变量 · 计划任务 · 架构
帮助	故障排除 · 常见问题 · 安全 · 升级

要让 Agent 参考这些文档？ 在任意文档 URL 后添加 .md，即可获取格式简洁的 Markdown；也可以通过一次请求获取全部文档： llms-full.txt。另有索引 llms.txt，以及指导 Agent 连接网站的 SKILL.md。

设置过程中遇到问题？ 故障排除页面涵盖了大家实际遇到的错误。如果没有你遇到的问题，可以在 Discord 或 Discussions 中提问——问题会得到解答，通常也会促成文档改进。

🗓️ 日常使用

向导完成后，工作流程刻意设计得很简单：

何时	你要做什么	它会做什么
每周一次，5 分钟	打开控制面板，处理队列：批准、拒绝、调整顺序	补充经过调研的创意，并附上每条创意背后的理由
每天早上	无需操作	将最早获批的创意构建为你代码仓库中的拉取请求
PR 合并后	审核并合并（或交由自动合并处理）	记录页面、请求编入索引，并开始跟踪其关键词
随时	向你的 Agent 提问："帮我研究关键词""我接下来应该写什么？""我们的排名如何？"	通过 MCP 根据实时数据作答——与控制面板显示的状态一致

控制面板的主页始终会指出下一步操作，因此你打开它时不必琢磨该做什么。

🧰 包含的内容

• MCP 服务，包含完整的工具集：队列、关键词、排名、页面、GSC 统计数据、反向链接潜在对象、趋势主题和网站资料。控制面板能做的任何事，你的 Agent 都能通过 MCP 完成；本代码库严格要求两者功能一致。
• 趋势雷达：扫描你所在领域中热度上升的主题，将主题扩展为具体的指南角度，并把合适的创意加入队列。
• 指南和工具构建器：指南每天最多发布一篇，采用扁平且永久的链接结构（因此，队列中的 30 个获批创意不会在一周内变成 30 篇文章）；免费工具创意获批后即可构建。
• 反向链接攻略：潜在对象列表会预先填入你产品的文案，并逐次跟踪提交情况。
• 多站点：一次部署即可管理任意数量的网站。每个项目都有自己的 MCP 令牌、数据和设置。
• 由密码保护的控制面板，供参与流程的一位人工使用。

💵 运行成本

除非你需要付费数据，否则无需费用。各层级可叠加：

层级	价格	可获得的内容
仅 Search Console	$0	来自 GSC 的排名、来自 Autocomplete 的关键词创意，以及你自己的展示数据
+ SerpApi 免费密钥	$0	实时 SERP 检查、每周获取真实排名（每月 250 次免费搜索）
+ DataForSEO	按调用付费	搜索量、关键词难度、域名评级

免费模式能找到你有机会胜出的关键词。付费模式还能判断哪些关键词值得争取。

☁️ 云端版本

如果你不想运行机器，也可以使用托管版本：我们负责托管，将 SERP 和搜索量数据合并为一笔账单，并用一次点击取代配置 Google 服务账号的繁琐步骤。访问 dispatchseo.com。无论选择哪种方式，自托管版本都保留完整功能——云端版卖的是便利，而非能力。

🧑‍💻 从源代码开发

git clone https://github.com/NeoZi12/dispatchseo
cd dispatchseo
pnpm install
cp .env.local.example .env.local
pnpm dev

这是贡献者的开发流程，并非自托管方式——自托管只需点击页面顶部按钮，即可通过一条 Docker 安装命令完成。启动前，请填写 .env.local（Supabase 和三个密钥），然后打开 localhost:3000 上的控制面板。

pnpm build 用于类型检查——提交 PR 前请先运行。没有单独的 lint 或测试配置。

🏗️ 架构简介

Next.js App Router，使用 Postgres 保存状态（自托管时使用内置容器，云端版本使用 Supabase），使用 mcp-handler 在 /api/mcp 提供 MCP 服务。计划任务和构建在应用栈内运行（cron + 构建器容器），或通过 GitHub Actions 运行。一次部署支持多租户：MCP bearer token 用于选择项目，cron 会遍历所有项目，控制面板则通过 cookie 切换项目。

架构对此有详细介绍。 CLAUDE.md包含完整的约定；它是为 Agent 编写的，结果也成了相当不错的用户文档。

🤝 参与贡献

先提交 Issue，再提交 PR；你必须理解自己提交的每一行内容，包括 AI 辅助生成的部分。详情请见 CONTRIBUTING.md。如有疑问，请前往 Discussions 或 Discord；漏洞请通过私密报告提交。

📄 许可证

AGPL-3.0。你可以使用、自托管或分叉。如果你将修改后的版本作为服务运行，请公开源代码。就这么简单。

---

_{由 NeoZi12 构建 · 如果 DispatchSEO 对你有帮助，点个 ⭐ 可以让更多人发现它。}