SuperAPI AI 工具集

serp-keyword-harvester

营销与增长

查看项目

更新于 10-16 02:28

技能介绍

用途:在预设计流程中收集和规范化搜索需求输入,为语义核心工作提供原始证据。它不决定最终站点架构或来源/代理策略,来源配置由 serp-source-configurator 负责。

主要能力与模式:plan 定义种子关键词、语言、来源、审批与回退;harvest-local 规范化用户提供的关键词、导出 CSV、现有站点文本或本地报告;harvest-external 使用已批准的 SERP/自动补全 API 或工具,联网前需审批;audit 审查已有的 reports/keyword-harvest.json。

使用方式:先阅读 references/keyword-harvest-contract.md。若涉及 OpenSERP、AKE、代理、API 密钥、引擎选项、来源设置或付费代理限制,先交由 serp-source-configurator 完成设置,并消费其脱敏后的 reports/serp-source-config.json。若 OpenSERP 已批准配置,阅读 references/openserp-setup.md,assets/openserp-settings.example.json 仅作脱敏契约,不存凭证。确认隐私与审批模式后,收集或规范化种子关键词、市场/语言、项目类型与来源出处,按 assets/keyword-harvest.schema.json 写入或更新 reports/keyword-harvest.json,并将每组数据标记为 Ran、Skipped、Planned 或 Manual,最后交接给 semantic-core-builder。

限制与安全:未经批准不得抓取或调用外部服务;报告中不得存储 API 密钥、Cookie、私有 URL、恢复码或 .env 值;OpenSERP 视为可选云/外部网络,需明确批准、配置凭证、查询范围、来源配置与数据传输说明;本技能不决定代理提供商、付费预算或引擎选择;搜索 API 返回 429/503 或不可用时,将来源标记为 Skipped 并继续使用本地/用户输入。

验证:编辑本技能时运行 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。