mcpField
S
serp-source-configurator

serp-source-configurator

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

关于 serp-source-configurator

用于在搜索需求采集前配置和管理数据源的技能。它生成经过脱敏且考虑审批要求的设置，并检查预算和就绪状态，再将配置交给关键词采集器，而不自行采集关键词。

主要功能

  1. 01设计数据源设置界面
  2. 02创建并审查脱敏的数据源配置
  3. 03检查数据源审批和代理就绪状态
  4. 04设置查询、引擎、缓存及超时限制
  5. 05将获批设置交给关键词采集器

适用场景

  1. 01在 SERP 研究前准备数据源设置
  2. 02审查配置中的密钥和审批缺失问题
  3. 03设定查询预算和代理失败处理方式

安装

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

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

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

包含的文件

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

agents/
openai.yaml
assets/
source-config.template.json
references/
decision-framework.md
safety-boundaries.md
ui-controls.md
scripts/
validate_serp_source_config.py

详细介绍

SERP 来源配置器

此技能负责搜索需求采集前的设置关卡。它本身不会采集关键词；它会创建经过脱敏、考虑审批的来源配置，并将其交给 serp-keyword-harvester。

运行模式

  • design-ui：为来源设置面板定义面向用户的字段、复选框、状态和安全默认值。
  • configure：创建或更新经过脱敏的 reports/serp-source-config.json。
  • preflight：检查 OpenSERP/基础 URL/代理是否就绪，并记录 Ran、Skipped 或 Planned。
  • budget-gate：设置查询限制、引擎限制、缓存 TTL、超时和付费代理规则。
  • audit：检查现有来源配置是否包含密钥、缺少审批、不安全的付费设置或不清晰的交接信息。

必需工作流

  1. 阅读 references/decision-framework.md。
  2. 如果涉及代理提供商、API 密钥、OpenSERP、AKE、付费流量或外部网络调用，请阅读 references/safety-boundaries.md。
  3. 对于 UI/仪表板相关请求，请使用 references/ui-controls.md 和 assets/source-config.template.json。
  4. 对来源进行分类：
    • 本地/手动输入：默认允许；
    • 直接 OpenSERP 引擎：外部查询前需要审批；
    • 代理支持的引擎：需要审批、预算和代理预检；
    • 付费或会修改账户的提供商操作：操作前必须立即获得明确确认。
  5. 绝不在 Markdown、HTML、任务计划、Wiki 笔记、报告、屏幕截图或导出的 JSON 中存储 API 密钥、代理凭据、Cookie、恢复码或 .env 值。
  6. 仅写入经过脱敏的配置和运行时引用，例如 env:AKE_API_KEY。
  7. 使用 scripts/validate_serp_source_config.py 验证来源配置。
  8. 只有在审批、已选引擎、限制和失败处理方式都明确后，才交接给 serp-keyword-harvester。

系统角色

在 SEO/网站架构层与关键词采集器之间使用此技能：

seo-llm-site-architect
-> serp-source-configurator
-> serp-keyword-harvester
-> semantic-core-builder

serp-source-configurator 负责来源设置、代理关卡、凭据处理、预算限制和预检状态。serp-keyword-harvester 负责实际采集关键词/SERP 证据。

输出标准

Mode:
Selected sources:
Disabled sources:
Proxy mode:
Credential handling:
Approval status:
Budget limits:
Preflight:
Output config:
Skipped/planned checks:
Next skill: serp-keyword-harvester

安全规则

  • 将 OpenSERP 和提供商 API 视为 external-network。
  • 用户输入的 API 密钥仅作为运行时输入；写入任何产物前都必须将其脱敏。
  • 除非用户明确要求执行特定操作，否则不得创建、刷新、轮换、购买或修改提供商代理端口。
  • 优先使用直接/免费引擎。仅对确有需要的引擎使用付费代理，通常是 Google/Yandex。
  • 如果代理预检失败，将代理来源保留为 Skipped，并继续使用直接/手动来源。
  • 不要对付费代理故障进行激进重试。

验证

编辑此技能时，请运行：

python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/serp-source-configurator
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/serp-source-configurator
python3 $CODEX_HOME/skills/serp-source-configurator/scripts/validate_serp_source_config.py $CODEX_HOME/skills/serp-source-configurator/assets/source-config.template.json

评论

支持 Markdown