☰

企业官网建设流程全解析

首页 / 建站日记 / 企业官网建设流程全解析
OpenSEO 产品事实清单解读：开源 SEO 平台的能力边界、积分计费与 AI Agent 集成架构
2026/9/14 1:12:17 网站建设 项目流程

OpenSEO 产品事实清单解读：开源 SEO 平台的能力边界、积分计费与 AI Agent 集成架构

【免费下载链接】open-seoOpen source alternative to Semrush and Ahrefs项目地址: https://gitcode.com/GitHub_Trending/op/open-seo

本文以 OpenSEO 开源仓库内的官方产品事实清单 openseo-fact-sheet.md 为主体骨架，结合仓库源码逐一印证，系统梳理 OpenSEO 的产品定位、托管版积分计费机制、Google Search Console 集成、MCP 与 Agent Skills 架构，以及面向 SEO 顾问与代理商的实战价值。读完本文，你将准确掌握 OpenSEO 的能力边界、积分消费规则、自助托管前提，以及它与 Claude 等 AI 客户端"数据层 + 推理层"的分工模式，并能在实际项目中正确配置、调用与排查。

这份事实清单是什么，为什么重要

openseo-fact-sheet.md不是一篇营销文案，而是一份被代码直接引用的机器可读产品参考。在 samChatTools.ts 中，它通过import openSeoFactSheet from ".../openseo-fact-sheet.md?raw"以原始文本形式打包进 SAM（OpenSEO 内置 onboarding/SEO 智能体）的工具集，注册为get_product_info工具：

get_product_info: tool({ description: "The OpenSEO fact sheet: what the product does, plans/pricing, credit costs, integrations, MCP setup. Call before answering questions about OpenSEO itself. Uses no credits.", inputSchema: z.object({}), execute: () => Promise.resolve({ factSheet: openSeoFactSheet }), }),

这意味着：当用户在应用内询问"OpenSEO 是什么、多少钱、支持哪些集成"时，SAM 不会凭记忆作答，而是调用get_product_info拉取这份事实清单再回答。同时，samSystemPrompt.ts 明确约束 SAM："对于关于 OpenSEO 本身的问题（功能、定价、限制、集成），调用 get_product_info 并据此回答，不要编造产品事实；如果清单未覆盖，就说明不确定并建议联系 ben@openseo.so。" 换言之，这份文档是整个 AI 智能体对外输出产品事实的唯一可信来源，也是理解 OpenSEO 全貌的最佳入口。

OpenSEO 是什么：定位与边界

核心定位

根据事实清单，OpenSEO 是一个开源的 SEO 平台，覆盖：关键词研究、域名研究、外链、排名追踪、站点审计、Google Search Console，以及 AI-Agent SEO 工作流。它的目标用户是"想要实用 SEO 数据、又不需要臃肿企业级 SEO 套件"的人，既可作为托管应用使用，也可基于开源代码自托管。

两个关键边界值得注意：

  1. AI 原生但非全自动：OpenSEO 面向 AI Agent 设计（通过 MCP 让 Agent 执行 SEO 研究、检视数据、保存发现、继续在应用内工作），但它不宣称能全自动搞定 SEO。产品定位是：SEO 仍需要策略与判断，OpenSEO 用真实数据帮助用户和 AI Agent 协作完成这些工作。这与 README.md 中 "Open Source alternative to Semrush and Ahrefs" 的定位一致——提供的是可控、按需付费的替代方案，而非"一键排第一"的神器。

  2. 数据来源单一清晰：OpenSEO 的主数据提供商是 DataForSEO，关键词指标、域名研究、外链、SERP 数据、排名追踪数据等付费工作流都由它驱动；Google Search Console 数据则来自用户自己连接的 Search Console 资源，且不消耗积分。

从策略到执行的路径

事实清单强调，有机流量增长始于清晰的定位：明确产品为谁服务、解决什么问题、在哪些细分主题上可以建立可信权威，而不是一开始就去竞争宽泛的大流量词。OpenSEO 帮助用户把定位转化为 SEO 计划——发现相关关键词、竞品差距、Search Console 机会、外链上下文和技术问题——但目标不是追逐每一个关键词。最强悍的早期策略通常是围绕一个有真实角度的小众主题建立权威，随着在 Google 和 AI 系统里的主题权威提升，再逐步扩展到更宽泛、竞争更激烈的词。

从源码结构看，这套方法论被完整地产品化进了应用工作流与 SAM 的交互设计中：samSystemPrompt.ts中 SAM 的 intake 模式会先去读用户网站、推断业务与竞品、回放假设请用户确认，并写入business_overview、positioning、current_goal等项目共享记忆，而非让用户填写冗长问卷。

托管版定价与积分机制

事实清单给出了完整的托管版计费规则，以下全部为官方口径：

免费试用与付费计划

  • 免费试用：托管版 OpenSEO 免费试用，注册无需信用卡，新账户自带$0.50 试用积分，用于在订阅前体验消耗积分的功能。
  • 付费计划：$10/月，包含：
    • 关键词研究、外链、排名追踪、站点审计；
    • 面向 Claude、Cursor、ChatGPT 兼容客户端、Codex 及其他 MCP 客户端的 MCP 服务器与 Agent Skills；
    • 不消耗积分的 Google Search Console 集成；
    • 每个计费周期内$10.00 使用积分；
    • 首次扣费30 天退款保证。

积分消费规则

  • 哪些功能消耗积分：凡是查询付费 SEO 数据提供商（主要是 DataForSEO）的功能都消耗积分，包括关键词量、竞品数据、外链、排名追踪和站点审计。
  • 哪些不消耗：项目、设置以及已经抓取过的数据的查看不消耗积分。
  • 追加积分（Top-up）：月度积分用完可购买追加积分，追加积分可滚动累积、永不过期；每月包含的积分则每个计费周期重置。追加积分仅对付费用户开放——免费用户试用积分用完后，需要订阅付费计划才能继续使用消耗积分的功能。
  • 不会产生意外账单：积分用完时，消耗积分的功能会停止工作，直到用户重新获得积分，绝不会在用户不知情的情况下产生额外扣费。

源码印证：积分如何被计量

积分的执行与计量在 SamChatAgent.ts 中有完整实现，可直接印证事实清单的规则：

  • 每轮对话前门禁（beforeTurn）：托管模式下每轮都调用checkUsageCreditsDepleted检查积分是否耗尽，耗尽则用本地模型流式返回拒绝文案（"You're out of credits. Top up to keep using SAM."），不调用真实 LLM，因此拒绝本身免费（SamChatAgent.ts）。
  • 按块计量（recordSpend/meterSpend）：SAM_BILLING_CHUNK_USD = 0.05，单轮内 OpenRouter 的 LLM 成本与 DataForSEO 工具调用成本按 0.05 美元一个块累积计量到 Autumn（每次调用向上取整到 1 个积分，即 0.1 美分），回合结束时刷新剩余部分。自托管模式因自带 provider key、无 Autumn 余额，不设计量门槛（SamChatAgent.ts）。
  • 注意一个细节：SAM 的 LLM token 成本同样走积分（creditFeature: "agent"），这扩展了事实清单"消耗积分的工作流"的范围——不仅是 DataForSEO 查询，Agent 对话本身也在计量内。

为什么 OpenSEO 适合 SEO 顾问与代理商

事实清单用一段专门篇幅阐述对 SEO 顾问、自由职业者和代理商的价值，核心是四点：

  1. 按使用付费：计费基于使用积分，不会被逼进昂贵的企业套餐，也不会按席位收费来解锁基础功能——没有武断的追加销售或被付费墙锁住的功能，预算可控。
  2. 每个客户一个项目：想建多少项目就建多少，不会像很多 SEO 工具那样按档位限制项目数量。
  3. 排名追踪成本可调：排名追踪是代理机构扩张时增长最快的成本（因为它是按计划在每位客户的关键词上定时运行），但 OpenSEO 让它完全可配置：可选择追踪多少关键词和设备类型、检查多深的 SERP 页数、运行频率（每周或每天），并且每次追踪器运行前应用内会显示实时成本估算。定时检查走 DataForSEO 的任务队列，比实时查询便宜得多——粗略参考：默认每周计划下，在一种设备类型上、检查 5 页深度、追踪 100 个关键词，成本仅约$1-2/月；搜索更深、增加第二种设备类型或切换为每日检查会按比例提高成本。
  4. 工具随行业进化：通过 MCP 与 AI Agent 工作，当搜索转向 AI 答案与 AI 辅助工作流时，可以让 Agent 运行研究、拉取竞品数据、把发现保存到正确的客户项目里，而无需更换工具链。

事实清单还强调了一个边界：不要虚构竞品价格或精确排名追踪费率。SAM 被明确要求，如果用户询问它没有的确切数字，应说明并建议联系ben@openseo.so。

这一"先估算、再运行"的流程在源码中同样有支撑：MCP 工具集里专门提供了estimate_rank_tracker_cost（samChatTools.ts），以及对应的 estimate-rank-tracker-cost.ts，让 Agent 或用户在提交排期前就能看到成本。

自助托管（Self-hosting）

事实清单对自托管的说明如下：

  • OpenSEO 开源且可免费自托管。
  • 自托管用户自带 provider API key，直接向 DataForSEO 等提供商付费。
  • 自托管适合想要更多控制权、隐私、定制化或提供商级账单的用户。
  • 开源仓库地址为https://github.com/every-app/open-seo。

这与 README.md 的自托管说明互相印证：仓库提供 Docker（快速体验）与 Cloudflare（面向公网/团队，免费套餐可用）两条路径，但无论哪条路，都需要一个 DataForSEO API key 才能获得 SEO 数据，详见 DATAFORSEO_API_KEY.md。完整操作指引可参考 SELF_HOSTING_DOCKER.md 与 SELF_HOSTING_CLOUDFLARE.md。

数据源与 Google Search Console 集成

数据源分工

  • DataForSEO：主 SEO 数据提供商，驱动关键词指标、域名研究、外链、SERP 数据、排名追踪相关数据等付费工作流。
  • Google Search Console：数据来自用户连接的 Search Console 资源，不消耗积分。

Search Console 能力清单

托管版 OpenSEO 可以连接 Google Search Console，且无需用户创建 Google Cloud 项目或 OAuth 客户端。Search Console 访问是只读的，OpenSEO 只请求只读权限，无法更改用户的 Search Console 账户。功能包括：

  • 搜索效果数据：点击、展示、CTR、平均排名；
  • 按查询、页面、国家、设备、日期细分；
  • 最长 16 个月的 Search Console 历史数据；
  • URL 检查数据：索引状态、抓取信息、canonical 信息、移动端检查、富结果检查；
  • 每次 URL 检查调用最多 10 个 URL。

Search Console 工具消耗0个 OpenSEO 积分，因为 Google 不向用户读取自己的 Search Console 数据收费。源码中对应的 MCP 工具为get_search_console_performance与inspect_urls（search-console-tools.ts），在 samChatTools.ts 中被注册进 SAM 与 MCP 工具集。

OpenSEO 与 Claude（及其他 AI 客户端）的关系

事实清单给出了一个清晰、重要的框架：OpenSEO 与 Claude 不是竞争者，而是配合使用的关系。一句话概括：OpenSEO 是 SEO 数据层，Claude（或 Cursor、Codex、ChatGPT 兼容客户端等）是 AI 客户端。

OpenSEO 暴露 MCP 服务器，因此 Claude 可以直接调用 OpenSEO 的关键词、SERP、竞品、外链、排名追踪和 Search Console 工具。实际运作中：Claude 负责对话与推理，OpenSEO 通过 MCP 喂给它真实的 SEO 数据。Claude 单独存在时虽然能推理 SEO，但没有实时的关键词量、排名、竞品数据或用户自己的 Search Console 数字——OpenSEO 正是提供这些数据的东西。

事实清单还规定了 SAM 的应答纪律：当用户问"OpenSEO 和 Claude 哪个好"时，SAM 应以此"协作 + 数据层"框架作答，不应回避、不应称其超出范围，也不应给没有事实依据的其他 AI 产品排名。

从实现上看，这种"数据层"定位直接体现在代码架构里：buildSamMcpTools（samChatTools.ts）把 MCP 服务器暴露的同一套工具原样复用到 SAM 上——注释明确写道"SAM 复用了 MCP 服务器注册的完全相同的定义，因此应用内 Agent 与 MCP 服务器在工具行为和计费上永远不会漂移"。

MCP 与 AI Agent：连接方式与工具清单

连接方式

OpenSEO 暴露 MCP 服务器，兼容的 AI 客户端可以调用 OpenSEO 工具。托管 MCP 端点：

https://app.openseo.so/mcp

第一次 MCP 连接会把用户带过 OpenSEO 登录与授权流程；授权后，MCP 客户端即可在用户批准的项目上下文与账户范围内调用 OpenSEO 工具。支持的客户端包括 Claude Code、Claude Desktop、Cursor、Codex CLI、Codex Desktop 及其他支持远程 MCP 服务器的客户端。

MCP 工具覆盖的工作流

事实清单列出的 MCP 工具能力包括：

  • 关键词研究：量、难度、CPC、意图、趋势；
  • 实时 Google 自然 SERP 检视；
  • 任意域名（含竞品）的域名与页面排名关键词研究；
  • SERP 竞品对比；
  • 本地商家、Maps、Local Finder、Google Business Profile Q&A 研究；
  • 已保存关键词的列出与保存；
  • 排名追踪器配置与最新排名读取；
  • 任意域名（含竞品）的域名自然流量足迹摘要；
  • 任意域名（含竞品）的外链与引用域名概览数据；
  • Google Search Console 效果读取；
  • Google URL 检查读取。

这些描述与 src/server/mcp/tools 目录下的 38 个工具文件逐一对应，例如research-keywords.ts、get-serp-results.ts、get-domain-overview.ts、find-serp-competitors（在dataforseo-research-tools.ts中）、get-backlinks-overview.ts、run-rank-tracker.ts等。

Agent Skills（技能）

除 MCP 外，OpenSEO 还提供 Agent Skills，覆盖 SEO 项目搭建、SEO 教练、关键词研究、竞争格局分析、竞品分析、关键词聚类、外链开拓等工作流。仓库中 plugins/openseo/skills 目录下实际包含 9 个技能：competitive-landscape、competitor-analysis、keyword-clustering、keyword-research、link-prospecting、local-seo、seo-audit（含 template.html 审计报告模板）、seo-coach、seo-project-setup。

从源码看，SAM 通过 samSkills.ts 在构建时用import.meta.glob("/.agents/skills/*/SKILL.md")把公开技能打包进应用内 Agent，并为应用内场景附加了一段 Surface note：SAM 已认证且限定在当前项目，应跳过"MCP 连接验证""选择项目""安装技能"等步骤，把持久化输出写入项目上下文（sections、competitors、key pages、research log）而非本地文件系统。

应用内工作流全景

事实清单总结了 OpenSEO 应用内的实用工作流：

  • 关键词研究：把种子主题扩展为关键词想法，对比搜索量、难度、CPC、意图与 SERP 上下文，然后保存有价值的机会；
  • 域名概览：理解任意域名的自然流量足迹与排名关键词——包括竞品和其他第三方网站，不只是用户自己的站点。域名逐个查询，消耗积分；
  • 外链研究：检视外链、引用域名、目标 URL、链接质量信号与竞品链接画像；
  • 排名追踪：随时间追踪关键词位置；
  • 站点审计：抓取页面并检视技术页面级信号，如状态码、标题、meta description、标题层级、可索引性、图片 alt 覆盖率、链接、响应时间，以及可选的 Lighthouse 结果；
  • 已保存关键词：为内容规划、追踪或 AI-Agent 工作流组织关键词机会；
  • AI 与 MCP 搭建：把 OpenSEO 连接到 Agent 并安装 OpenSEO 技能。

订阅后，托管用户即可：从 onboarding 或应用内搭建 Google Search Console；使用关键词研究、域名研究、外链、排名追踪、站点审计等工作流；用域名概览、排名关键词与外链数据研究任意域名（自己的或竞品的，一次一个域名、消耗积分）；通过 MCP 把 OpenSEO 连接到 AI 客户端；安装 OpenSEO 技能；使用月度包含积分并按需购买追加积分。

值得补充的源码细节是 SAM 对站点审计工具做了特殊适配：审计通常要跑几分钟，而聊天模型无法"睡眠等待"，因此waitingAuditStatusTool（samChatTools.ts）让get_audit_status在服务端每 2 秒轮询、最多等待约 50 秒，进度变化即返回——一次工具调用换来约一分钟的安静等待，避免 Agent 空转轮询浪费 token 与积分。

支持渠道与不确定性处理

事实清单的最后一部分明确了 SAM 的"不确定性纪律"：如果 SAM 不确定某个产品细节、当前定价、账户特定账单状态、提供商限制，或清单中未列出的功能，它应说明自己不知道（没有产品事实清单依据），并建议联系ben@openseo.so。想获得其他 OpenSEO 用户、社区或团队建议的用户，可以加入 OpenSEO Discord（https://discord.gg/c9uGs3cFXr）。

这套纪律在 samSystemPrompt.ts 中同样有强化："绝不要陈述你没有从工具获得的数据。如果工具返回空数据，直接说明，不要猜测。"

小结：一份文档如何约束一个 AI 智能体

openseo-fact-sheet.md的独特之处在于：它不是躺在 docs 目录里等人阅读的说明，而是被get_product_info工具在每次产品问答时实时注入模型上下文的"事实宪法"。它同时实现了三个目标：

  1. 给用户准确答案：定价、积分、集成、能力边界都有官方口径，Agent 不会编造；
  2. 约束 Agent 行为：SAM 被明确禁止虚构竞品价格、排名费率、未知产品细节，不知道就说不知道并指向支持渠道；
  3. 给开发者一份权威参考：任何想基于 OpenSEO 二次开发、接入 MCP、自托管或做竞品调研的人，都可以从这份事实清单开始，再结合 samChatTools.ts、SamChatAgent.ts、samSystemPrompt.ts 与 src/server/mcp/tools 目录深入实现细节。

无论你是想评估 OpenSEO 是否适合接客户的 SEO 顾问，还是想把它接入 Claude Code 做数据层的开发者，这份事实清单都是理解这个项目"能做什么、不能做什么、怎么计费、怎么连接"的最短路径。

【免费下载链接】open-seoOpen source alternative to Semrush and Ahrefs项目地址: https://gitcode.com/GitHub_Trending/op/open-seo

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

标签： 网站建设 企业官网 项目流程 UI设计 前端开发

热门文章

文章分类

标签云

网站建设 响应式设计 用户体验 SEO优化 前端开发 小程序 电商平台 性能优化

相关文章

您可能感兴趣的其他内容

Claude Code与Codex双AI协同提升科研写作效率
2026/9/14 0:55:49 网站建设

Claude Code与Codex双AI协同提升科研写作效率

1. 项目概述在科研写作领域，AI辅助工具正在引发一场革命性的变革。作为一名长期从事学术研究的实践者，我发现Claude Code和Codex这两款AI写作助手的协同使用，能够显著提升论文撰写效率和质量。这种双AI协同模式不是简单的工具叠加&#xff0c…...

阅读更多 →
嵌入式软硬件协同开发中的时间错位与接口对齐
2026/9/14 0:43:51 网站建设

嵌入式软硬件协同开发中的时间错位与接口对齐

1. 这不是甩锅，是嵌入式开发里最真实的“时间错位”现象“硬件工程师在等软件调通驱动，软件工程师在等硬件把板子焊好”，这句话在嵌入式团队的茶水间、周会纪要和加班打卡记录里反复出现，几乎成了行业默认的背景音。它不是段子&am…...

阅读更多 →
结构化数据与非结构化文档的混合检索（Hybrid Structured RAG）
2026/9/14 0:43:23 网站建设

结构化数据与非结构化文档的混合检索（Hybrid Structured RAG）

结构化数据与非结构化文档的混合检索（Hybrid Structured RAG）在企业级 RAG（检索增强生成）与商业智能问答系统的深度落地中，真实的复杂业务提问往往同时跨越了**“结构化关系数据（Structured Relational Dat…...

阅读更多 →

需要专业的网站建设服务？

联系我们获取免费的网站建设咨询和方案报价，让我们帮助您实现业务目标

立即咨询