Back to Details

seo-project-setup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

OpenSEO SEO Project Setup

OpenSEO SEO项目设置

Goal

目标

Help the user set up a local SEO workspace for one website or SEO project. The folder is where the agent saves notes, goals, exports, briefs, reports, preferences, and project context over time. This is a workspace and context setup workflow, not a full audit.
帮助用户为单个网站或SEO项目搭建本地SEO工作区。该文件夹是Agent长期保存笔记、目标、导出文件、简报、报告、偏好设置和项目背景的位置。这是一个工作区与背景设置流程，而非完整的审计流程。

Tone

语气

Be friendly, practical, and structured. Ask questions in small batches. Explain why each item matters only when useful. Do not overwhelm a beginner with jargon.
友好、务实且有条理。分批提出问题。仅在必要时解释每个事项的重要性。不要用专业术语让初学者不知所措。

Checklist

检查清单

1. Pick a working folder

1. 选择工作文件夹

Suggest that the user choose or create a local folder for SEO work, for example:
  • ~/SEO/<company-or-site>/
  • ~/Documents/SEO/<company-or-site>/
  • A repo or workspace folder if SEO work should live beside website/content files
Explain that keeping notes, exports, briefs, scraped pages, reports, and preferences in one folder helps the agent build context over time. Future SEO workflows can use that folder rather than starting from a blank conversation.
Recommended starter structure:
text
seo-workspace/
  README.md
  gsc/
  keywords/
  competitors/
  content/
  outreach/
  reports/
Do not create folders unless the user asks. If file tools are available and the user asks, create a simple structure and a short 
README.md
with the current goals, known sites, and user preferences for how the agent should approach SEO for this project.
建议用户选择或创建一个用于SEO工作的本地文件夹，例如：
  • ~/SEO/<公司或网站名称>/
  • ~/Documents/SEO/<公司或网站名称>/
  • 如果SEO工作需要与网站/内容文件放在一起，可选择代码仓库或工作区文件夹
解释说明：将笔记、导出文件、简报、抓取页面、报告和偏好设置集中存放在一个文件夹中，有助于Agent逐步构建项目背景。未来的SEO工作流程可以直接使用该文件夹，无需从零开始对话。
推荐初始结构：
text
seo-workspace/
  README.md
  gsc/
  keywords/
  competitors/
  content/
  outreach/
  reports/
除非用户要求，否则不要创建文件夹。如果有可用的文件工具且用户提出要求，可创建一个简单的结构，并生成一份简短的
README.md
，包含当前目标、已知站点以及用户对Agent处理该项目SEO工作的偏好设置。

2. Collect website scope

2. 收集网站范围信息

Ask for:
  • Primary website/domain
  • Additional domains or subdomains
  • Important products, services, categories, or pages
  • Target countries/languages
  • Whether the site is new, established, migrating, or recovering from a drop
  • CMS or publishing workflow, if relevant
请用户提供：
  • 主网站/域名
  • 其他域名或子域名
  • 重要产品、服务、分类或页面
  • 目标国家/语言
  • 网站状态：新站、已建站、迁移中或正从流量下滑中恢复
  • 相关的CMS或发布流程（如有）

3. Capture goals

3. 明确目标

Ask the user what they want from SEO:
  • More qualified leads
  • More signups/trials
  • More ecommerce revenue
  • More newsletter/audience growth
  • More brand/category awareness
  • Recovery from traffic loss
  • Better ranking for specific pages
Ask for success metrics and timeframe. If goals are vague, help turn them into measurable goals such as "increase non-branded organic signups" or "rank top 10 for 20 buying-intent terms."
询问用户希望通过SEO实现的成果：
  • 获得更多优质线索
  • 增加注册/试用用户数
  • 提升电商营收
  • 扩大通讯订阅/受众规模
  • 增强品牌/品类知名度
  • 恢复流失的流量
  • 提升特定页面的排名
请用户提供成功指标和时间范围。如果目标模糊，帮助用户将其转化为可衡量的目标，例如“提升非品牌自然流量带来的注册量”或“让20个具有购买意向的关键词进入搜索结果前10名”。

4. Capture positioning and strategy context

4. 收集定位与策略背景

Ask what research they have already done about the company, product, audience, and competitors. Request any notes, docs, customer interviews, positioning docs, pitch decks, landing pages, or strategy memos they can share.
Probe for:
  • Who the product or site is for
  • What pain it solves
  • Why users choose it over alternatives
  • Competitors and substitutes
  • Strong opinions or positioning claims
  • Best customers and bad-fit customers
  • Existing content that already converts
  • Topics they do not want to target
If the user has not done this yet, offer to help research positioning using the company website, competitor pages, reviews, forums, and web search.
询问用户已完成的关于公司、产品、受众和竞品的研究情况。请用户分享相关笔记、文档、客户访谈记录、定位文档、演示文稿、着陆页或策略备忘录。
深入了解：
  • 产品或网站的目标用户
  • 解决的用户痛点
  • 用户选择该产品而非竞品的原因
  • 竞争对手及替代方案
  • 明确的定位主张或强烈观点
  • 优质客户与非适配客户
  • 已具备转化效果的现有内容
  • 不愿涉足的主题
如果用户尚未开展此类研究，可提出协助通过公司官网、竞品页面、评论、论坛和网络搜索来调研定位。

5. Verify OpenSEO MCP

5. 验证OpenSEO MCP配置

After the user has described the company, website, goals, and positioning, check that OpenSEO MCP is configured and mapped to the right project:
  1. Use 
    whoami
    if available.
  2. Use 
    list_projects
    to confirm the user can access projects.
  3. Match the project to the website/domain they want to rank for.
  4. If the project list is ambiguous, ask the user which project should be used.
  5. If the MCP is unavailable, tell the user to connect OpenSEO MCP before continuing with live OpenSEO data.
Do not run research tools just to test connectivity; 
whoami
and 
list_projects
are enough.
在用户描述完公司、网站、目标和定位后，检查OpenSEO MCP是否已配置并映射到正确项目：
  1. 若可用，执行
    whoami
    命令。
  2. 使用
    list_projects
    命令确认用户可访问的项目。
  3. 将项目与用户希望提升排名的网站/域名进行匹配。
  4. 如果项目列表存在歧义，请用户指定应使用的项目。
  5. 如果MCP不可用，告知用户需先连接OpenSEO MCP，才能继续使用OpenSEO的实时数据。
不要仅为测试连接性而运行研究工具；
whoami
和
list_projects
命令已足够。

6. Connect Google Search Console

6. 连接Google Search Console

GSC is the richest first-party signal: existing impressions, near-ranking terms, cannibalization, and pages that already have search demand.
Preferred (hosted): connect it natively. On the project's Integrations page, connect Google Search Console and pull live data with 
get_search_console_performance
. Once connected, the agent reads it directly in 
keyword-research
and 
keyword-clustering
— no manual files to maintain.
Fallback (self-hosted, or if the user prefers files): ask the user to export CSVs from Search Console into the SEO working folder.
Recommended exports:
  • Queries: last 3 months and last 16 months if available
  • Pages: last 3 months and last 16 months if available
  • Query + page combinations when possible
  • Countries/devices if relevant
Ask them to drop files into 
gsc/
and use names like:
text
gsc/queries-last-3-months.csv
gsc/pages-last-3-months.csv
gsc/queries-last-16-months.csv
gsc/pages-last-16-months.csv
GSC是最丰富的第一方数据来源：包含现有曝光量、接近排名的关键词、关键词 cannibalization（关键词内耗）以及已具备搜索需求的页面。
优先方案（托管版）：原生连接。在项目的集成页面中连接Google Search Console，并使用
get_search_console_performance
命令拉取实时数据。连接完成后，Agent可在
keyword-research
和
keyword-clustering
流程中直接读取数据——无需手动维护文件。
**备选方案（自托管版或用户偏好文件方式）：**请用户从Search Console导出CSV文件到SEO工作文件夹中。
推荐导出内容：
  • 查询数据：最近3个月及最近16个月的数据（如有）
  • 页面数据：最近3个月及最近16个月的数据（如有）
  • 尽可能导出查询+页面的组合数据
  • 相关的国家/设备数据（如有）
请用户将文件放入
gsc/
文件夹，并使用如下命名格式：
text
gsc/queries-last-3-months.csv
gsc/pages-last-3-months.csv
gsc/queries-last-16-months.csv
gsc/pages-last-16-months.csv

7. Inventory existing assets

7. 盘点现有资产

Ask for or discover:
  • Sitemap or important URL list
  • Current blog/resources/content library
  • Product/category/feature pages
  • Existing keyword lists
  • Current rank trackers
  • Backlink or PR assets
  • Linkable assets such as studies, templates, tools, datasets, calculators, or original opinions
请用户提供或协助发现：
  • 站点地图或重要URL列表
  • 当前博客/资源/内容库
  • 产品/分类/功能页面
  • 现有关键词列表
  • 当前排名追踪工具
  • 外链或PR资产
  • 可用于外链建设的资产，如研究报告、模板、工具、数据集、计算器或原创观点

8. Recommend first workflow

8. 推荐首个工作流程

After intake, recommend one next OpenSEO workflow:
  • keyword-research
    : when the user needs ideas from seed topics
  • keyword-clustering
    : when they have keywords or GSC data to map to pages
  • competitive-landscape
    : when the market is unclear
  • competitor-analysis
    : when they know a competitor to study
  • link-prospecting
    : when they have a linkable asset or target page
完成信息收集后，推荐以下OpenSEO工作流程之一：
  • keyword-research
    ：当用户需要从种子主题获取关键词思路时
  • keyword-clustering
    ：当用户已有关键词或GSC数据需要映射到页面时
  • competitive-landscape
    ：当市场情况不明确时
  • competitor-analysis
    ：当用户明确要研究某个竞品时
  • link-prospecting
    ：当用户拥有可用于外链建设的资产或目标页面时

Output format

输出格式

Use a checklist with statuses:
StepStatusNotesNext action
Then summarize:
  • Working folder
  • OpenSEO MCP/project status
  • Sites in scope
  • Goals
  • Known positioning
  • Uploaded data/files
  • Recommended next workflow
使用带状态的检查清单：
步骤状态备注下一步操作
然后进行总结：
  • 工作文件夹
  • OpenSEO MCP/项目状态
  • 纳入范围的站点
  • 目标
  • 已知定位信息
  • 已上传的数据/文件
  • 推荐的下一个工作流程

Guardrails

约束规则

  • Keep setup lightweight. The user should feel oriented, not assigned homework.
  • Do not pretend a GSC CSV has been uploaded unless you can see it, and do not claim Search Console is connected unless 
    get_search_console_performance
    confirms it (it returns a "not connected" message otherwise).
  • Keep project setup focused on setup and context unless the user asks for live research.
  • If web search or scraping is used for positioning research, distinguish source evidence from inference.
  • 保持设置流程轻量化。用户应感到清晰明了，而非被布置大量任务。
  • 除非能确认文件已上传，否则不要谎称GSC CSV文件已上传；除非
    get_search_console_performance
    命令确认连接成功（否则会返回“未连接”提示），否则不要声称Search Console已连接。
  • 项目设置需聚焦于设置和背景收集，除非用户要求开展实时研究。
  • 如果使用网络搜索或抓取工具进行定位研究，需区分来源证据与推断内容。