keyword-research

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

OpenSEO Keyword Research

OpenSEO 关键词研究

Goal

目标

Turn seed topics into a prioritized keyword opportunity set using OpenSEO MCP data. The output should help the user decide what to target, what to save, and what to research next.
利用OpenSEO MCP数据,将初始主题转化为经过优先级排序的关键词机会集合。输出内容应帮助用户决定要瞄准哪些关键词、保存哪些关键词以及下一步研究方向。

Required inputs

必要输入

  • projectId
  • One or more seed topics, products, pages, competitors, or audience problems
  • Optional market/location/language
If
projectId
is missing, use
list_projects
first. If the target market/location/language is unclear and would materially affect keyword metrics, ask the user; otherwise use the MCP tool defaults.
  • projectId
  • 一个或多个初始主题、产品、页面、竞品或受众痛点
  • 可选的市场/地区/语言
如果缺少
projectId
,请先调用
list_projects
。如果目标市场/地区/语言不明确且会对关键词指标产生实质性影响,请询问用户;否则使用MCP工具的默认设置。

OpenSEO MCP tools

OpenSEO MCP工具

  • research_keywords
    : primary discovery tool. Use 1-5 seeds per call and prefer 150 results unless the user asks for exhaustive research.
  • get_keyword_metrics
    : hydrate up to 700 known keywords with volume, keyword difficulty (KD), search intent, CPC, and monthly trends in one call. Use it to score candidate or known terms — including the Search Console striking-distance queries from step 1.
  • get_ranked_keywords
    : pull exact ranking keyword rows when a target domain or page is part of the research brief.
  • get_search_console_performance
    : when Search Console is connected, start from the project's real first-party demand — queries already earning impressions and near-ranking ("striking distance") terms. Request a high
    rowLimit
    and filter average position 5-20 client-side, since the API sorts by clicks and can't filter by position. Then hydrate those striking-distance queries with
    get_keyword_metrics
    to attach difficulty and intent.
  • get_serp_results
    : inspect SERPs for the top candidate terms, especially when intent is ambiguous.
  • search_local_businesses
    ,
    get_local_serp_results
    , and
    get_google_business_questions
    : use for local SEO topics when a business/location radius matters.
  • list_saved_keywords
    : avoid duplicating already-saved work or use existing tags as context.
  • save_keywords
    : save selected keywords only after explicit user confirmation.
  • research_keywords
    :主要的关键词发掘工具。每次调用使用1-5个初始关键词,除非用户要求全面研究,否则默认返回150条结果。
  • get_keyword_metrics
    :单次调用可为多达700个已知关键词补充搜索量、关键词难度(KD)、搜索意图、CPC和月度趋势数据。用于为候选或已知关键词打分——包括步骤1中来自Search Console的“接近排名”查询。
  • get_ranked_keywords
    :当研究需求包含目标域名或页面时,提取精确的排名关键词数据行。
  • get_search_console_performance
    :当已连接Search Console时,从项目的真实第一方需求入手——即已经获得曝光量且接近排名(“接近排名”)的关键词。请求较高的
    rowLimit
    ,并在客户端过滤平均排名5-20的关键词,因为API按点击量排序,无法按排名过滤。然后使用
    get_keyword_metrics
    为这些“接近排名”的查询补充难度和意图数据。
  • get_serp_results
    :检查顶级候选关键词的SERPs,尤其是当意图不明确时。
  • search_local_businesses
    get_local_serp_results
    get_google_business_questions
    :当业务/地区范围很重要时,用于本地SEO主题研究。
  • list_saved_keywords
    :避免重复已完成的保存工作,或使用现有标签作为上下文。
  • save_keywords
    :仅在获得用户明确确认后,保存选定的关键词。

Workflow

工作流程

  1. Normalize seeds into a small set of distinct research angles. If Search Console is connected for the project, first pull
    get_search_console_performance
    (high
    rowLimit
    , default lookback), filter to striking-distance positions (~5–20) client-side, and hydrate those queries with
    get_keyword_metrics
    to attach KD and intent. That ranked, hydrated list is your fastest opportunity set — work it before broad discovery.
  2. If the request is local SEO, identify the business, location/coordinates or service area, and local categories. Use
    search_local_businesses
    and
    get_local_serp_results
    for the most important location/keyword set instead of relying only on national keyword/SERP data.
  3. Call
    research_keywords
    for exploratory seeds. Use bulk calls when possible.
  4. Use
    get_keyword_metrics
    to hydrate a fixed keyword list — or the striking-distance queries from step 1 — with volume, KD, and intent before prioritizing.
  5. Use
    get_ranked_keywords
    when the user provides a domain/page and wants opportunities based on current rankings, near-misses, or competitor-owned terms.
  6. Remove irrelevant, duplicate, branded-only, and off-intent terms.
  7. Prioritize by practical opportunity, not volume alone:
    • Strong match to the user's product/page/topic
    • Clear search intent
    • Reasonable difficulty
    • Useful volume/CPC signal
    • SERP where the user can plausibly compete
    • For local SEO, local-pack/Maps visibility and proximity fit
  8. Use
    get_serp_results
    for high-potential or ambiguous keywords when SERP intent would change the recommendation; keep the default check small.
  9. Present a shortlist and a longer opportunity table.
  10. Ask before saving keywords. When saving, suggest concise tags such as
    topic:<topic>
    ,
    intent:<intent>
    , or
    page:<slug>
    .
  1. 将初始关键词标准化为少量不同的研究方向。如果项目已连接Search Console,首先调用
    get_search_console_performance
    (设置较高的
    rowLimit
    ,默认回溯周期),在客户端过滤出“接近排名”的位置(约5–20名),并使用
    get_keyword_metrics
    为这些查询补充KD和意图数据。这份经过排名和补充数据的列表是最快捷的机会集合——先处理它,再进行广泛发掘。
  2. 如果需求是本地SEO,确定业务、地区/坐标或服务范围,以及本地类别。使用
    search_local_businesses
    get_local_serp_results
    获取最重要的地区/关键词集合,而非仅依赖全国性关键词/SERP数据。
  3. 为探索性初始关键词调用
    research_keywords
    。尽可能批量调用。
  4. 在进行优先级排序前,使用
    get_keyword_metrics
    为固定关键词列表——或步骤1中的“接近排名”查询——补充搜索量、KD和意图数据。
  5. 当用户提供域名/页面,并希望基于当前排名、接近排名的关键词或竞品拥有的关键词寻找机会时,调用
    get_ranked_keywords
  6. 移除无关、重复、仅品牌相关以及不符合意图的关键词。
  7. 根据实际机会而非仅搜索量进行优先级排序:
    • 与用户的产品/页面/主题高度匹配
    • 明确的搜索意图
    • 合理的难度
    • 有用的搜索量/CPC信号
    • 用户有竞争力的SERP环境
    • 对于本地SEO,本地包/地图可见性和地理位置匹配度
  8. 当SERP意图会改变推荐结果时,为高潜力或意图模糊的关键词调用
    get_serp_results
    ;默认检查数量保持较少。
  9. 展示一个候选短名单和一份更详细的机会表格。
  10. 保存关键词前需询问用户。保存时,建议使用简洁的标签,例如
    topic:<topic>
    intent:<intent>
    page:<slug>

Output format

输出格式

Start with the highest-signal recommendation:
  • Best opportunity theme
  • Top keywords to target now
  • Keywords to save
  • Risks or SERP caveats
Then include a compact table:
KeywordIntentVolumeKDCPCPriorityNotes
End with next actions, including whether to run keyword clustering, create a content brief, or save the chosen keywords.
从信号最强的建议开始:
  • 最佳机会主题
  • 现在应瞄准的顶级关键词
  • 需保存的关键词
  • 风险或SERP注意事项
然后包含一个简洁的表格:
关键词意图搜索量KDCPC优先级备注
最后列出下一步行动,包括是否进行关键词聚类、创建内容简报或保存选定的关键词。

Guardrails

约束规则

  • Do not invent metrics. If OpenSEO does not return a value, write
    unknown
    .
  • Do not call
    save_keywords
    without explicit confirmation.
  • Prefer business-fit and intent-fit over chasing the largest volume term.
  • 不得编造指标。如果OpenSEO未返回值,请填写
    unknown
  • 未经明确确认,不得调用
    save_keywords
  • 优先考虑业务匹配度和意图匹配度,而非盲目追求搜索量最高的关键词。