mcpField
S
seo-project-setup

seo-project-setup

github.com/every-app营销与增长25.5k6.7k 次安装2 天前更新
代码仓库

关于 seo-project-setup

seo-project-setup 是 OpenSEO 技能，通过访谈了解网站或 SEO 项目，并将确认的信息保存到共享项目上下文。它为后续 SEO 工作流整理目标、定位、竞争对手、关键页面和 Search Console 状态。

主要功能

  1. 01定位 OpenSEO 项目
  2. 02查看并更新现有上下文
  3. 03收集网站范围与 SEO 目标
  4. 04保存定位、竞争对手和关键页面
  5. 05记录 Search Console 设置与文件
  6. 06推荐后续 SEO 工作流

适用场景

  1. 01为新的 SEO 项目建立共享上下文
  2. 02使用其他技能前更新项目详情
  3. 03整理 SEO 工作的目标与目标页面

MCP 相关

该技能使用 OpenSEO MCP 工具查找项目、读取和更新共享项目上下文，并处理 Search Console 连接。MCP 不可用时无法保存上下文。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/every-app/open-seo --skill seo-project-setup

安装后在 Claude Code 中输入/seo-project-setup确认已加载。

详细介绍

OpenSEO SEO 项目设置

目标

围绕一个网站或 SEO 项目访谈用户一次，并通过 update_project_context 将答案保存到该项目在 OpenSEO 中的共享上下文。所有其他技能都会读取这些上下文，用户也能在项目侧边栏「AI」下的「上下文」页面查看——因此，即使开启新会话、换用新设备或更换 Agent，这些信息也会保留。这是一个上下文设置工作流，并非完整审计。

语气

友好、务实、条理清晰。分小批次提问。仅在有帮助时说明每项内容的重要性。不要用术语让初学者不知所措。

答案的保存位置

两个项目上下文 MCP 工具负责所有写入操作，且都是免费的——不会消耗额度。

  • get_project_context(projectId)：返回项目的所有已知信息，以及 missingSections 列表。
  • update_project_context(projectId, updates)：接收补丁操作列表。本技能会使用以下操作：
    • { section: "business_overview" | "current_goal" | "positioning" | "writing_preferences", content }
    • { addCompetitors: [{ domain, name?, notes? }] }
    • { addKeyPages: [{ url, role: "hub" | "spoke" | "money" | "other", topic?, notes? }] }
    • { customSection: "<slug>", title?, content }，用于保存无法归入已有类型分区的内容
    • { appendResearchLog: { summary } }，用于记录本次会话中消耗额度的操作

随着访谈进行，分批写入内容——不要等到最后才保存所有答案。每个分区都是一段约 4,000 个字符的文本，因此只需几个精炼的段落，无需记录完整对话。

检查清单

1. 验证 OpenSEO MCP 并确定项目

写入操作需要 projectId，因此首先执行以下步骤：

  1. 如果可以，使用 whoami。
  2. 使用 list_projects 确认用户可以访问项目。
  3. 根据用户希望提升排名的网站或域名匹配项目。
  4. 如果项目列表中有多个可能的匹配项，询问用户应使用哪个项目。
  5. 如果没有匹配的项目，询问用户是否要通过 create_project 创建一个项目。
  6. 如果 MCP 不可用，告知用户连接 OpenSEO MCP；没有它就无法保存任何内容。

不要仅为测试连接而运行研究工具；whoami 和 list_projects 已足够。

2. 查看已有内容

调用 get_project_context。简要告知用户 OpenSEO 已知的信息和缺失的信息。确认或更正已有条目，而不要重复询问已回答过的问题——用户经常会在其他技能填入部分上下文后再次运行本技能。

3. 收集网站范围信息

询问以下内容：

  • 主要网站或域名
  • 其他域名或子域名
  • 重要的产品、服务、类别或页面
  • 目标国家/地区和语言
  • 网站处于新建、已运营、迁移中还是流量下滑后的恢复阶段
  • 如适用，使用的 CMS 或发布工作流

将持久有效的信息写入 business_overview：业务内容、目标受众、目标市场/地区，以及网站当前所处阶段。

4. 记录目标

询问用户希望通过 SEO 实现什么：

  • 获取更多高质量潜在客户
  • 提高注册量/试用量
  • 增加电商收入
  • 扩大新闻通讯订阅量/受众规模
  • 提升品牌/品类知名度
  • 从流量下滑中恢复
  • 提升特定页面的排名

询问成功指标和时间范围。如果目标比较模糊，帮助用户将其转化为可衡量的目标，例如「增加非品牌词带来的自然注册量」或「在 20 个有购买意向的关键词上进入前 10 名」。

将结果写入 current_goal，包括指标和时间范围。

5. 收集定位和战略背景

询问他们已经对公司、产品、受众和竞争对手做过哪些研究。请他们分享可以提供的笔记、文档、客户访谈、定位文档、演示文稿、落地页或战略备忘录。

深入了解：

  • 产品或网站面向哪些人
  • 它解决了什么痛点
  • 用户为什么选择它而不是其他方案
  • 竞争对手和替代方案
  • 明确的观点或定位主张
  • 最理想的客户和不匹配的客户
  • 已经能带来转化的现有内容
  • 他们不希望覆盖的主题

如果用户还没有做过这些研究，可以提出利用公司网站、竞争对手页面、评论、论坛和网络搜索来协助研究定位。

将受众、问题、差异化优势以及用户希望捍卫的任何主张写入 positioning。询问品牌语气、禁用词或短语以及需要避免的话题，并将这些内容写入 writing_preferences——内容起草工作流会读取这一部分。

6. 保存竞争对手

将第 5 步中的竞争对手和替代方案整理成 addCompetitors 条目：每个域名一行，并用简短的 notes 说明其重要性（例如“直接竞争对手，拥有相关对比页面”）。如果用户不确定哪些网站在搜索中构成竞争，可以针对少量种子关键词使用 find_serp_competitors 来找出竞争对手——保存前请与用户确认列表，并记录支出。

此处保存的竞争对手会在 competitive-landscape、competitor-analysis 和 link-prospecting 中重复使用。

7. 梳理关键资产

询问或查找：

  • 站点地图或重要 URL 列表
  • 当前的博客、资源或内容库
  • 产品、类别或功能页面
  • 现有关键词列表
  • 当前排名追踪工具
  • 反向链接或公关资产
  • 可用于获取链接的资产，例如研究报告、模板、工具、数据集、计算器或原创观点

使用 addKeyPages 保存真正重要的页面——转化页面、主题中心和可用于获取链接的资产。这是一份经过筛选的短名单，而不是完整的站点清单：通常为 10 到 30 个 URL。为每个页面指定一个 role，并在已知时填写其目标 topic。

8. 连接 Google Search Console

GSC 是最丰富的第一方信号来源：已有展示次数、接近获得排名的词、关键词蚕食，以及已有搜索需求的页面。

首选方式（托管）：原生连接。 在项目的 Integrations 页面连接 Google Search Console，并使用 get_search_console_performance 获取实时数据。如果用户已在该页面连接 Google 账号，你可以自行选择资源：list_search_console_sites 会显示每个已连接账号可以访问的资源，set_search_console_site 可将其中一个绑定到项目（GA4 的对应操作是 list_google_analytics_properties / set_google_analytics_property）。连接后，Agent 会在 keyword-research 和 keyword-clustering 中直接读取数据——无需手动维护文件。

备用方式（自托管，或用户偏好使用文件时）： 请用户将 Search Console 的 CSV 导出到本地工作文件夹（见第 9 步）。

建议导出：

  • 查询：最近 3 个月的数据；如有，另导出最近 16 个月的数据
  • 页面：最近 3 个月的数据；如有，另导出最近 16 个月的数据
  • 条件允许时，导出查询 + 页面组合数据
  • 相关时，导出国家/地区和设备数据

请他们将文件放入 gsc/，并使用如下名称：

gsc/queries-last-3-months.csv
gsc/pages-last-3-months.csv
gsc/queries-last-16-months.csv
gsc/pages-last-16-months.csv
9. 仅在处理文件时设置本地文件夹

项目知识保存在 OpenSEO 中，而不是磁盘上。本地文件夹仍适合存放实际文件：GSC CSV 导出、网站抓取结果、草稿、内容简报和报告。

如果用户需要，可以建议使用 ~/SEO/<company-or-site>/，或在网站/内容代码库旁创建文件夹，结构如下：

seo-workspace/
  gsc/
  drafts/
  reports/

除非用户提出要求，否则不要创建文件夹；也不要将目标、定位或竞争对手信息复制到本地文件中——这些内容应保存在项目上下文中。

10. 推荐首个工作流

完成信息收集后，推荐一个接下来可使用的 OpenSEO 工作流：

  • seo-audit：网站已经上线，用户想知道需要修复什么或首先该做什么时，尤其是用户刚接触 SEO 时
  • keyword-research：用户需要从种子主题中获取创意时
  • keyword-clustering：用户已有关键词或 GSC 数据，需要将其映射到页面时
  • competitive-landscape：市场情况不明朗时
  • competitor-analysis：用户知道要研究的竞争对手时
  • link-prospecting：用户有可用于获取链接的资源或目标页面时

输出格式

使用包含以下状态的清单：

步骤状态备注后续操作

然后总结：

  • OpenSEO MCP/项目状态
  • 涉及的网站
  • 目标
  • 已知定位
  • 已保存的竞争对手
  • 已保存的关键页面
  • Search Console 状态及任何本地文件
  • 项目上下文中仍缺少的部分
  • 推荐的下一步工作流

告诉用户，他们可以在项目侧边栏「AI」下的 Context 页面中查看和编辑此处保存的所有内容。

注意事项

  • 保持设置流程轻量。让用户清楚了解情况，而不是觉得被布置了作业。
  • 写入事实前先向用户确认。可以提出基于网站得出的推断，但应将其作为经确认的答案保存，而不是猜测。
  • 除非确实能看到 GSC CSV，否则不要声称其已上传；除非 get_search_console_performance 确认 Search Console 已连接（否则会返回「未连接」消息），否则不要声称 Search Console 已连接。
  • 除非用户要求进行实时研究，否则项目设置应专注于设置和上下文。如果某个步骤会消耗额度，请追加一条研究日志记录，以免其他技能重复购买。
  • 如果使用网页搜索或抓取进行定位研究，请区分来源证据和推断。
  • 覆盖某个部分会替换该部分的内容。如果上下文中已有内容，请将新答案合并到现有文本中，而不是将其丢弃。

评论

支持 Markdown