Seo Keyword Research

基于AIsa API的SEO关键词策略生成工具,支持网站爬取与多维度数据分析。

已扫描
适合谁
数字营销人员、SEO优化专员
不适合谁
无API密钥的用户、需要自动写文案的用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好(★☆☆)。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @bibaofeng/seo-keyword-research-aisa-api

Skill 说明

命令、参数、文件名以原文为准

SEO 关键词研究

此技能可基于域名、网址、种子主题、产品、市场或竞争对手集合,构建实用的 SEO 关键词策略。当用户提供网站时,首先对目标网站进行爬取和分析。通过爬取结果理解产品定位、目标受众、核心功能、使用场景及业务方向,再结合 AIsa 的 DataForSEO 数据,利用 AIsa LLM 推理能力完成关键词聚类、搜索意图解析、机会评分、基于 SERP 的页面推荐以及内容规划。

要求

该技能需要一个 AIsa API 密钥。

export AISA_API_KEY="your-aisa-api-key"

请使用以下 AIsa 接口:

  • 数据接口:https://api.aisa.one/apis/v1/...
  • LLM 网关:https://api.aisa.one/v1/chat/completions

切勿打印或提交 API 密钥。若密钥缺失,请提示用户设置 AISA_API_KEY

兼容性

适用于所有 agentSkills.io 兼容的运行环境,包括 Claude Code、Claude、OpenAI Codex、Cursor、Gemini CLI、OpenCode、Goose、OpenClaw、Hermes 以及其他支持技能文件夹的代理运行时。

需安装 Python 3、curl 和 AISA_API_KEY。可在 https://aisa.one 获取 API 密钥。

快速开始

export AISA_API_KEY="your-aisa-api-key"

python3 scripts/site_crawler.py \
  https://example.com \
  --max-pages 12 \
  --out site-profile.json

python3 scripts/aisa_client.py data \
  /apis/v1/dataforseo/dataforseo_labs/google/keyword_suggestions/live \
  payload.json \
  --out keyword-suggestions.json

使用爬取输出生成初始种子主题。然后通过 AIsa DataForSEO 接口验证搜索需求、难度、意图与 SERP 实际情况。最后使用 AIsa LLM 网关对已验证的关键词数据进行聚类、评分与总结。

使用场景

适用于以下请求:

  • “为这个网站寻找 SEO 关键词。”
  • “为我的 SaaS 产品制定关键词策略。”
  • “研究这个产品类别的关键词。”
  • “找出我们与竞争对手之间的关键词差距。”
  • “按搜索意图对这些关键词进行聚类。”
  • “选择下个月最佳的 SEO 内容主题。”
  • “为这些落地页创建关键词地图。”

不适用于完整的技术审计、反向链接审计、结构化数据实现或内容撰写,除非用户明确要求将关键词研究作为该流程的一部分。

核心工作流

1. 定义研究范围

收集或推断以下信息:

  • 目标域名或网址
  • 种子主题、产品、服务或类别
  • 目标国家、语言和搜索引擎
  • 提供的竞争对手
  • 业务目标:流量、线索、销售、品牌认知、本地可见性或内容规划
  • 限制条件:仅品牌词、仅非品牌词、博客主题、落地页、商业页面、程序化页面等

若未指定国家和语言,默认根据用户所在市场判断。若无法判断,则默认使用美国和英语,并注明该假设。

2. 在关键词研究前先爬取网站

当用户提供域名或网址时,应在查询关键词工具前先进行网站爬取。

python3 scripts/site_crawler.py \
  https://example.com \
  --max-pages 12 \
  --out site-profile.json

优先关注:

  • 首页
  • 产品、功能、定价、文档、集成、使用场景、对比页、博客、关于我们等页面
  • 可用的网站地图 URL
  • 导航标签和内部链接
  • 页面标题、元描述、标题标签、结构化数据提示和可见文本内容

通过爬取生成简要的业务概况:

  • 产品类别
  • 主要功能与能力
  • 目标受众与买家角色
  • 使用场景与待办任务
  • 集成平台、API 或支持的工具
  • 定价模式或转化目标(如可见)
  • 网站中提及的竞争对手、替代品及品类术语
  • 已有内容主题与空白点

除非用户明确要求品牌 SEO,否则不要从品牌或域名关键词开始。应将品牌关键词保留在“品牌验证”部分,且仅在完成产品与品类机会映射后才处理。

若本地爬取受阻、深度不足或高度依赖 JavaScript 渲染,可使用 AIsa/DataForSEO OnPage 辅助工具作为替代证据:

  • /apis/v1/dataforseo/on_page/content_parsing/live
  • /apis/v1/dataforseo/on_page/task_post
  • /apis/v1/dataforseo/on_page/pages
  • /apis/v1/dataforseo/on_page/raw_html
  • /apis/v1/dataforseo/on_page/summary/{id}

3. 将站点概况转化为种子主题

使用 AIsa LLM 推理能力,将爬取结果转化为种子主题。这些是初步假设,而非最终关键词。

从以下方面生成种子主题:

  • 产品类别术语
  • 功能与能力术语
  • 使用场景术语
  • 集成与平台术语
  • 痛点与问题术语
  • 竞争对手与替代品术语
  • 买家角色术语
  • 交易型修饰词:价格、替代、最佳、工具、API、软件、平台、对比
  • 信息型修饰词:什么是、如何、指南、示例、教程、检查清单

要求 LLM 解释每个种子主题为何与爬取内容匹配。移除无法从爬取内容中合理解释的种子。

4. 构建初始关键词库

当输入可用时,按以下顺序使用 AIsa DataForSEO 接口:

markdown


name: Seo Keyword Research

version: 1.0.0

description: 通过数据驱动的方法进行搜索引擎优化关键词研究,涵盖种子词扩展、验证、趋势分析、难度与意图评估、聚类、机会识别与页面建议。

summary: 本技能提供一套完整的 SEO 关键词研究流程,基于 DataForSEO API 接口实现自动化关键词挖掘与分析,支持从网站和竞争对手数据出发,生成高潜力关键词清单,并输出结构化报告。

SEO 关键词研究

1. 爬取衍生的种子词扩展

使用以下 API 接口从目标关键词出发,扩展相关关键词:

  • /apis/v1/dataforseo/dataforseo_labs/google/keyword_suggestions/live
  • /apis/v1/dataforseo/dataforseo_labs/google/keyword_ideas/live
  • /apis/v1/dataforseo/dataforseo_labs/google/related_keywords/live
  • /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/live

2. 站点衍生的关键词验证(在种子词扩展后)

使用以下接口验证关键词与目标站点的相关性:

  • /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_site/live
  • /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/live

3. 需求量与趋势检查

分析关键词的搜索热度与趋势变化:

  • /apis/v1/dataforseo/keywords_data/google_ads/search_volume/live
  • /apis/v1/dataforseo/keywords_data/clickstream_data/global_search_volume/live
  • /apis/v1/dataforseo/keywords_data/dataforseo_trends/explore/live

4. 难度与用户意图分析

评估关键词的竞争程度与用户搜索意图:

  • /apis/v1/dataforseo/dataforseo_labs/google/bulk_keyword_difficulty/live
  • /apis/v1/dataforseo/dataforseo_labs/google/search_intent/live
  • /apis/v1/dataforseo/dataforseo_labs/google/keyword_overview/live

来源标签说明:为每个关键词标注来源类型,包括 site(站点)、seed(种子)、suggestion(建议)、related(相关)、competitor(竞品)、trend(趋势)、serp(SERP)、llm-generated(LLM 生成)。其中 llm-generated 类型的关键词视为假设,需通过搜索量或 SERP 数据验证后方可采纳。

5. 通过竞品与 SERP 扩展关键词

当提供竞品信息,或 DataForSEO 返回 SERP 竞品时,使用以下接口进一步挖掘:

  • /apis/v1/dataforseo/dataforseo_labs/google/competitors_domain/live
  • /apis/v1/dataforseo/dataforseo_labs/google/domain_intersection/live
  • /apis/v1/dataforseo/dataforseo_labs/google/ranked_keywords/live
  • /apis/v1/dataforseo/dataforseo_labs/google/serp_competitors/live
  • /apis/v1/dataforseo/dataforseo_labs/google/relevant_pages/live

对最具潜力的关键词,查看实时搜索结果以获取深层洞察:

  • /apis/v1/dataforseo/serp/google/organic/live/advanced
  • /apis/v1/dataforseo/serp/ai_summary
  • /apis/v1/dataforseo/serp/screenshot

利用 SERP 数据识别:

  • 排名页面类型
  • 主流内容形式
  • 用户意图
  • SERP 特性(如广告、问答框、购物模块等)
  • 内容新鲜度规律
  • 弱项结果
  • 内容空白点

6. 数据标准化与清洗

在评分前执行以下处理:

  • 仅对关键词进行小写化用于去重;输出时保留原始大小写。
  • 合并语义相近的重复词,包括单复数变体及明显拼写错误。
  • 移除无关品牌词、成人内容、导航类或非目标市场术语,除非明确要求保留。
  • 对缺失搜索量、难度或意图数据的关键词标记为“不完整”,不得推测数值。
  • 当地理意图存在差异时,保持本地化变体独立。

7. 按意图与主题聚类

使用 LLM 进行关键词聚类分析,优先输出紧凑的结构化结果。

推荐聚类维度:

  • 父主题
  • 子主题
  • 搜索意图:信息型、商业型、交易型、导航型、本地型、对比型、故障排除型
  • 营销漏斗阶段:认知、考虑、转化、留存
  • 最佳页面类型:博客文章、对比页、落地页、产品页、分类页、工具页、术语表页、本地页、程序化模板

注意:禁止 LLM 自行创建指标。可进行分类、摘要与优先级排序,但所有量化指标必须来自 AIsa 或 DataForSEO 数据,或明确标注为定性描述。

每个最终关键词聚类应包含至少五个代表性关键词及其对应指标。若聚类中有效关键词少于五个,则列出全部已验证关键词,并标注“需进一步扩展”。

8. 识别高潜力关键词

高潜力关键词需同时满足以下两个条件:

  • 关键词难度低于 40
  • 搜索量大于 1000

不得隐性放宽标准。若无关键词满足双条件,应如实说明,并另设“潜在机会”部分,列出最接近标准的候选词。

针对每个高潜力关键词,需解释:

  • 为何与爬取站点相关
  • 爬取数据中哪些功能、使用场景、产品类别或受众洞察支持该关键词
  • 为何其指标表现具有吸引力
  • 在审查 SERP 后仍存在的风险点

9. 机会评分

对每个关键词或聚类进行 0 到 25 分的评分:

维度说明
需求量搜索量、趋势增长、市场规模
相关性与域名、产品、目标客户画像或页面内容的契合度
意图价值带来高质量流量的可能性
排名可行性反向难度 + SERP 弱点分析
战略价值支持产品定位、主题权威性或转化提升

评分标签定义如下:

  • 高优先级:需求强、匹配度高、SERP 可行、意图价值高
  • 中优先级:有一定价值但受限于难度、模糊性或需求较低
  • 低优先级:匹配差、需求弱或可行性差
  • 需先验证:概念有趣但数据不完整

10. 生成基于 SERP 的页面建议

针对高潜力关键词及各聚类中的最强代表词,分析其 SERP 结果,提出合适的页面类型建议:

  • 落地页:SERP 中以产品、软件、API、平台或工具页面为主
  • 功能页:出现特定功能的厂商页面、文档或能力说明页
  • 对比页:查询包含 vsalternativecompetitorbest,或 SERP 中有对比列表与评测页
  • 博客文章或指南:SERP 以解释性内容、教程、操作指南或“人们也问”板块为主
  • 价格页:查询含“价格”、“成本”、“便宜”、“免费”、“计划”等,或 SERP 包含定价页面
  • 文档页:包含 API 文档、SDK 说明、GitHub 仓库或开发者指南
  • 程序化页面:可重复应用于不同地区、集成、类别、竞品、模板或使用场景

每条建议需说明 SERP 证据及推荐的内容角度。

11. 输出最终交付成果

返回一份简洁的关键词研究报告,包含:

  • 经验证的关键词列表
  • 聚类结果与代表性关键词
  • 高潜力关键词及其分析
  • 机会评分与优先级标签
  • 基于 SERP 的页面建议
  • 未满足条件的说明与潜在机会补充
  • 执行摘要
  • 研究假设
  • 爬取网站的业务概况
  • 核心关键词聚类
  • 每个聚类中五个代表性关键词
  • 高潜力关键词(难度低于40且搜索量大于1000)
  • 为何这些关键词是机会点
  • 优先关键词清单
  • 最佳内容创作机会
  • 基于SERP的页面建议
  • 推荐的下一步页面、更新或程序化模板
  • 数据缺口与验证备注

当请求完整报告时,请使用 references/report-template.md

AIsa LLM 使用说明

通过 AIsa LLM 网关执行以下任务:

  • 将爬取的网站内容总结为产品与业务概况
  • 从爬取数据生成有依据的种子主题
  • 分类搜索意图
  • 将关键词聚类分组
  • 总结SERP模式特征
  • 将原始指标转化为SEO决策建议
  • 起草关键词策略报告
  • 将关键词转化为页面建议

推荐的请求模式如下:

curl -sS "https://api.aisa.one/v1/chat/completions" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-mini",
    "messages": [
      {
        "role": "system",
        "content": "You are an SEO strategist. Use only provided metrics as facts. Mark unverified ideas clearly."
      },
      {
        "role": "user",
        "content": "Cluster these keyword rows by topic, search intent, and best page type."
      }
    ]
  }'

辅助脚本

使用 scripts/aisa_client.py 快速调用API:

python3 scripts/site_crawler.py \
  https://example.com \
  --max-pages 12 \
  --out site-profile.json
python3 scripts/aisa_client.py data \
  /apis/v1/dataforseo/dataforseo_labs/google/keyword_suggestions/live \
  payload.json \
  --out keyword-suggestions.json
python3 scripts/aisa_client.py chat \
  --model gpt-5-mini \
  --system system-prompt.txt \
  --prompt cluster-prompt.txt \
  --out clusters.md

质量规范

  • 提供网站后,必须先进行网站爬取再开展关键词研究。
  • 除非用户明确要求品牌SEO,否则不以品牌关键词作为起点。
  • 优先使用本地爬虫和实时的 AIsa/DataForSEO 数据,而非手动浏览器抓取。
  • 明确标注所使用的接口分组。
  • 区分事实与建议内容。
  • 不得虚构搜索量、CPC、关键词难度、排名或趋势数值。
  • 使用LLM输出进行解释分析,而非替代关键词数据本身。
  • 每个关键词聚类需展示五个具备可用指标的代表性关键词。
  • 高潜力关键词必须满足难度 < 40 且搜索量 > 1000。
  • 基于SERP的页面建议需明确指出应创建落地页、功能页、对比页、价格页、文档页、程序化页面或博客文章,并说明原因。
  • 若原始导出文件包含客户域名、竞争对手或内部策略信息,应保持私密。
  • 最终输出需具备可操作性:用户应清楚知道应优先优化哪些关键词、创建何种页面类型,以及背后的原因。

参考资料

  • references/aisa-api-map.md:接口分组及使用说明
  • references/report-template.md:最终关键词研究报告结构模板
B
@bibaofeng

已收录 1 个 Skill

相关推荐