mcpField
S
serp-keyword-harvester

serp-keyword-harvester

github.com/sergekostenchuk营销与增长3249 次安装18 周前更新
代码仓库

关于 serp-keyword-harvester

serp-keyword-harvester 是用于设计前收集和规范化搜索需求证据的技能，支持本地输入及经批准的外部来源，并将结构化数据交给 semantic-core-builder。

主要功能

  1. 01规划关键词、地区与来源
  2. 02规范化本地关键词数据
  3. 03使用获批的外部 SERP 来源
  4. 04审核现有采集报告
  5. 05标注来源状态与出处

适用场景

  1. 01在网站设计前准备关键词证据
  2. 02规范化导出的 CSV 和站点文本
  3. 03审核现有关键词采集报告

安装

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

$npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill serp-keyword-harvester

安装后在 Claude Code 中输入/serp-keyword-harvester确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
assets/
keyword-harvest.schema.json
openserp-settings.example.json
references/
keyword-harvest-contract.md
openserp-setup.md

详细介绍

SERP 关键词采集器

此技能为设计前工作流准备原始搜索需求证据。它不负责决定最终的网站架构或来源／代理策略；serp-source-configurator 负责设置门槛，此技能则将结构化输入交给 semantic-core-builder。

运行模式

  • plan：定义种子关键词、地区语言、来源、审批和回退方案。
  • harvest-local：规范化用户提供的关键词、导出的 CSV、现有网站文本或本地报告。
  • harvest-external：使用经批准的 SERP／自动补全 API 或工具；发起网络调用前必须获得批准。
  • audit：审查现有的 reports/keyword-harvest.json。

必需工作流

  1. 阅读 references/keyword-harvest-contract.md。
  2. 如果提及 OpenSERP、AKE、代理、API 密钥、引擎复选框、来源设置或付费代理限制，先将设置交由 serp-source-configurator 处理，并使用其脱敏的 reports/serp-source-config.json 交接内容。
  3. 如果 OpenSERP 已获批准／配置，请阅读 references/openserp-setup.md，并仅将 assets/openserp-settings.example.json 用作脱敏契约，而非凭据存储。
  4. 确认隐私和审批模式：
    • 本地输入和用户提供的公开事实：允许；
    • 外部 SERP／API／爬取：必须明确批准；
    • 私有／需身份验证的来源：必须明确批准，并附上数据处理说明。
  5. 收集或规范化种子关键词、市场／地区语言、项目类型和来源出处。
  6. 使用 assets/keyword-harvest.schema.json 作为字段契约，创建或更新 reports/keyword-harvest.json。
  7. 将每个数据组标记为 Ran、Skipped、Planned 或 Manual。
  8. 将结果交接给 semantic-core-builder；不得编造缺失的 SERP 证据。

安全规则

  • 未经批准，不得抓取数据或调用外部服务。
  • 不得在报告中存储 API 密钥、Cookie、私有 URL、恢复码或 .env 值。
  • 将 OpenSERP 视为 optional-cloud／external-network：必须先获得明确批准、配置凭据、查询范围、来源配置，并提供数据传输说明，方可调用。
  • 如果代理提供商、付费预算或引擎选择尚未明确，不得在此技能中自行决定；请使用 serp-source-configurator。
  • 如果搜索 API 返回 429／503 或不可用，将来源标记为 Skipped，并继续使用本地／用户提供的输入。

交接格式

Mode:
Locale/market:
Seed keywords:
Sources used:
Sources skipped:
Source config:
Output path:
Privacy/approval note:
Next skill: semantic-core-builder

验证

编辑此技能时，请运行：

python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/serp-keyword-harvester
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/serp-keyword-harvester

评论

支持 Markdown