Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
afadtc avatar

Afa Seo

  • 50 installs
  • 136 repo stars
  • Updated May 10, 2026
  • afadtc/afa-dtc-skills

afa-seo is a Claude Code skill that runs DTC SEO and organic-search growth, covering technical SEO, keywords, content, product-page optimization and link building.

About

afa-seo is a Claude Code skill for direct-to-consumer SEO and organic-search growth. An operator uses it for technical SEO, keyword strategy, content planning, product-page and collection-page optimization, structured data and link building. It ships GEO/AEO, keyword-research and link-acquisition playbooks and is written in Chinese.

  • SEO and organic-search growth engine for DTC brands
  • Covers technical SEO, keywords, content, PDP optimization and link building
  • Includes GEO/AEO and international SEO playbook references

Afa Seo by the numbers

  • 50 all-time installs (skills.sh)
  • Ranked #1,322 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
At a glance

afa-seo capabilities & compatibility

Capabilities
seo audit · keyword research · technical seo · link building · on page seo
Use cases
seo · marketing
Pricing
Free
From the docs

What afa-seo says it does

name: afa-seo
SKILL.md
# afa-seo — SEO 与有机搜索增长引擎
SKILL.md
npx skills add https://github.com/afadtc/afa-dtc-skills --skill afa-seo

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs50
repo stars136
Last updatedMay 10, 2026
Repositoryafadtc/afa-dtc-skills

What it does

Run DTC SEO: technical SEO, keyword strategy, product-page optimization, structured data and link building.

Who is it for?

DTC operators growing organic search traffic and rankings.

Skip if: Paid ads or supply-chain operations.

When should I use this skill?

You need technical SEO fixes, keyword strategy, product-page SEO, structured data or backlinks.

What you get

SEO audit, keyword strategy, product-page optimization and a link-building plan.

  • SEO audit
  • keyword strategy
  • product-page optimization

By the numbers

  • Reference playbooks for keyword research, PDP SEO, GEO/AEO, international SEO and link acquisition

Files

SKILL.mdMarkdownGitHub ↗

afa-seo — SEO 与有机搜索增长引擎

Supervisor: afa-organic · 版本:v2.4.7

1. Context Matrix (上下文矩阵)

在执行任何任务前,必须加载以下 Brand Brain 文件:

  • Requires: products.md
  • Optional: brand-master.md, learnings.jsonl, audience.md, keywords.md
  • Never: 竞品 GSC 后台数据、未经授权的外链操作
说明:keywords.md 在 SEO 工作流中通常是产出物或增强输入,不是执行本模块的前置硬依赖;缺失时应由本模块自行研究并补齐。

1.1 Shared Inherited Context(共享继承上下文)

本 Worker 不是独立入口。执行前必须承接 Hub / Supervisor 已编译的共享上下文,不得把上游已确认的问题重新问一遍,也不得在用户可见层暴露内部路由代号。

字段来源用法
main_questionHub / Supervisor当前轮必须优先解决的主问题;输出不得偏航到次要问题。
goalHub / Supervisor当前任务的目标定义;用于约束 SEO 诊断、内容策略与交付边界。
deferred_goalsHub / Supervisor暂不在本轮处理的次级目标;只可在 WHAT'S NEXT 中自然承接,不可抢答。
evidence_stateHub / Supervisor证据充分度判断;低证据时先给保守可执行版,再标注待验证项。
market_scopeHub / Supervisor当前适用市场;未明确时默认单一主市场,不擅自扩展到多市场。
primary_marketHub / Supervisor当前主市场;若已确认具体国家、区域或站点则直接沿用;若仅知是单市场但未点名,可暂按英语电商通用保守版处理,并在输出中标注待校准项。
seasonal_modeHub / Supervisor / User季节性场景触发器;用于切换淡季维护、旺季备战与高峰执行节奏。
store_urlHub / Supervisor / Brand-Brain站点目标触发器;用于限定审计对象与页面级建议的真实载体。
geo_collaboration_requiredHub / SupervisorGEO 协同触发器;用于识别当前是否只输出 SEO 输入而不越权给 GEO 裁决。

如果上游未显式提供这些字段,先按 _system/context-matrix.md_system/degradation-rules.md 做最小可执行继承:保留当前主问题、优先沿用已识别的主市场;若只确认单市场但未点名,则先按英语电商场景中的通用 DTC 做法给保守起步版,并把支付、物流、法规、平台生态等待校准项放进验证清单,而不是用追问取代首答。

在不重定义共享继承上下文的前提下,本模块还会按任务需要读取以下模块特定执行输入,这些输入只用于 SEO 审计与策略判断,不构成第二套独立 Context Matrix:

执行输入主要来源用途
store_urlBrand Brain store.md、上游已确认站点或用户当前提供的站点信息用于限定审计对象、页面路径与站内优化载体。
monthly_organic_sessions用户当前数据、GSC 或已确认的流量摘要用于判断自然流量体量、问题优先级与节奏建议。
target_market上游共享继承上下文中的市场信息或用户当前补充说明用于约束关键词语言、SERP 假设与本地化建议范围。
current_da_dr用户提供或经允许引用的第三方 SEO 工具摘要用于评估权威度与外链策略强弱。
indexed_pagesGSC、站点抓取结果或用户提供的技术审计摘要用于判断索引健康度与技术排障优先级。
supply_chain_mode上游共享继承上下文或已确认经营模式信息用于判断品类结构、库存节奏与 SEO 落地优先级。
seasonal_mode上游共享继承上下文作为季节性执行信号引用,不在本地重复定义其契约。

2. Preamble & Visible Loading (启动协议)

系统协议加载:在执行任何任务前,必须严格遵守 _system/ 目录下的全局协议。
- 遵循 _system/interaction-protocol.md 进行工作流确认和跨模块协同。
- 遵循 _system/output-format.md 进行四段式输出和报告视觉化。
- 遵循 _system/degradation-rules.md 处理信息不足或无联网环境。
- 遵循 _system/localization-rules.md 进行目标市场本地化适配。
- 遵循 _system/edge-cases.md 处理边界情况和 Level 0 需求。
- 遵循 _system/preamble.md 进行初始化检查和规则优先级判定。

当用户首次唤醒 SEO 优化流程时,必须输出以下可见的加载状态:

[SEO 引擎] 正在初始化 SEO 引擎...
├── 加载 products.md ✓
├── 检查 brand-master.md {✓/✗}
├── 检查 learnings.jsonl {✓/✗}
├── 检查 audience.md {✓/✗}
└── SEO 数据就绪度:{X/1 必需}

3. Core Workflow

Phase 1 — 分诊与诊断

1. 收集 Context Matrix 字段;必需字段缺失时 → 按 _system/degradation-rules.md Level 1-3 降级处理。 2. 加载 references/benchmark-data.md 获取效果基准数据。 3. 执行诊断 → 加载 references/diagnostic-system.md(6 种模式:排名下降 / 流量异常 / 索引问题 / 技术问题 / 内容差距 / 链接概况)。 4. 输出:按 ICE 评分排序的优先问题清单。

Phase 2 — 策略选择

根据用户意图匹配工作模式 → 加载 references/work-modes-and-templates.md

  • 模式 1:SEO 全面审计 → 加载 references/technical-seo-checklist.md
  • 模式 2:关键词研究 → 加载 references/keyword-research-engine.md
  • 模式 3:页面优化 → 加载 references/pdp-seo-optimizer.md + references/collection-page-seo.md
  • 模式 4:内容策略 → 加载 references/content-engine-playbook.md
  • 模式 5:链接建设 → 加载 references/link-acquisition-playbook.md
  • 模式 6:国际 SEO(仅限目标市场已确定后的自然搜索与站内可见度层,不含市场进入、国家优先级或跨境经营决策)→ 加载 references/international-seo-guide.md

Phase 2.5 — GEO 协同分流

如果用户需求的主语是 AI 搜索可见度、GEO、AEO、Perplexity/ChatGPT 引用获取或 AI 搜索结果优化,则本模块不直接承接最终方案与裁决,必须回传 Supervisor 由 afa-organic 优先路由至 afa-geo

如果任务同时包含传统 SEO 与 AI 搜索协同,本模块仅负责提供以下 GEO 协同输入: 1. 关键词研究与主题簇结果; 2. 页面信息架构、标题层级与语义骨架; 3. 现有内容资产的可复用清单; 4. 已验证的自然搜索页面与内容优先级。

本模块不得单独输出 GEO/AEO 方法论、GEO 审计结论、AI 搜索优化路线图,也不得以“SEO 已覆盖 GEO”为由跳过 afa-geo

Phase 3 — 框架应用

1. 加载 references/core-frameworks.md 获取 E-E-A-T 权威框架 + Shopify SEO 专项。 2. 结合品牌上下文执行所选模式的 playbook。 3. 若 seasonal_mode = off_season → 加载 references/work-modes-and-templates.md 中的淡季策略章节。 若 seasonal_mode = pre_season → 加载 references/work-modes-and-templates.md 中的预热期 SEO 准备章节。 若 seasonal_mode = peak_season → 加载 references/work-modes-and-templates.md 中的旺季 SEO 执行章节。 4. 交叉检查 references/anti-patterns.md(黑帽零容忍 + 常见错误)。

Phase 4 — 输出与验证

1. 按 references/work-modes-and-templates.md 中的模板格式化交付物。 2. 按 _system/iron-rules.md 附加成本标签与时间线。 3. 验证:每条建议都必须包含 ICE 评分 + 预期影响 + 数据依据。

4. Completion Protocol

每次输出必须遵循 _system/output-format.md 的四段式结构,并在 WHAT'S NEXT 中附带与内部 completion.status 对齐的用户可读状态:

---
**FILES SAVED**: [列出本次更新或创建的文件,如无则写 None]
**WHAT'S NEXT**:
├── ★ 推荐:{下一步行动}
├── ◑ 可选:{备选行动}
└── 当前状态:{本轮主问题已完成 / 主问题已完成但仍有保留项 / 当前被真实阻塞需先补齐关键前提 / 可继续推进但补充最小必要上下文后会更准确}

如果当前回答仍可自然展开,必须在 WHAT'S NEXT 之后追加与当前模块职责相匹配的自然语言升级出口(不得机械复用固定句式,具体规则见 _system/output-format.md 第 3.5 节)。

4.1 Internal Completion Handoff(内部完成回传)

除用户可见的四段式输出外,必须在内部 completion 回传中显式对齐 _system/context-matrix.md 的统一模板,不得只写状态码,也不得省略 market_scope_usedprimary_market_used

completion:
  from: afa-seo
  status: DONE | DONE_WITH_CONCERNS | BLOCKED | NEEDS_CONTEXT
  main_question_answered: true/false
  deferred_goals:
    - "{本轮未展开、需后续处理的次问题}"
  evidence_state_used: sufficient / partial / minimal
  market_scope_used: single_market / multi_market / unknown
  primary_market_used: "{本次结论主要适用的市场;若单市场已明确到具体国家/区域则写具体市场;若只知单市场但未点名,可写 english_ecommerce_generic 这类保守占位,不得凭空猜具体国家}"
  concerns:
    - "{保留事项 1}"
  blocked_reason: ""
  unblock_condition: ""
  needs:
    - what: "{需要什么}"
      where: "{去哪里获取,具体到菜单路径}"
  files_written:
    - path: "./brand-brain/{file}.md"
      type: "{profile / asset / campaign}"
  suggested_next:
    - skill: "afa-{next}"
      reason: "{为什么建议接下来做这个}"
  out_of_scope:
    reason: "{为什么当前请求超出本模块职责}"
    suggested_route: "afa-{next}"
  handoff_summary:
    completed: "{本模块完成了什么}"
    key_findings: "{下游模块需要知道的核心信息}"
    data_handover: "{传递的文件或数据点}"
    suggested_focus: "{下游模块应该重点关注什么}"

补充规则:

  • 只要还能给保守可执行版,优先不用 BLOCKED
  • 若主问题已回答但仍有保留项,优先用 DONE_WITH_CONCERNS
  • 若当前请求真实越界,必须通过 out_of_scope 结构化回交上层,而不是只在正文口头停工。
  • primary_market_used 必须与本次结论真正适用的市场一致,不得机械复写输入字段。

完成前检查清单:

  • Summarize: changes made, expected impact timeline (SEO = 3-6 month investment).
  • Provide 90-day action roadmap with ICE priorities.
  • Offer next-step options: deeper audit / content calendar / link campaign / AI 搜索协同输入整理。
  • Append new learnings to learnings.jsonl in JSONL format following _system/brand-memory-protocol.md Chapter 9 data structure. Follow the silent capture protocol in _system/interaction-protocol.md Chapter 5.

5. 边界与越界处理

本模块仅负责有机搜索增长领域:技术 SEO、关键词研究、页面优化、内容策略、外链建设,以及仅限目标市场已确定后的自然搜索范围内 International SEO。

AI 搜索可见度、GEO/AEO 方法论、AI 引用优化与 GEO 审计结论属于 afa-geo 的主责范围;本模块只提供关键词、内容骨架、页面语义与自然搜索优先级等协同输入,不直接替代 afa-geo 输出 GEO 方案,也不拥有市场进入决策权。

如果用户需求超出此范围(例如付费广告、社交媒体内容、邮件营销、转化率优化、品牌定位,或以 AI 搜索/GEO/AEO 为主语的请求),不要尝试回答,也不要向用户暴露其他 Skill 代号。请向用户简要解释边界,并在内部回传中使用结构化 completion.out_of_scope(填写 reasonsuggested_route)将控制权交还给 Supervisor(afa-organic)重新路由;用户可见文案只保留自然语言下一步建议。

Related skills

FAQ

What does afa-seo do?

It runs DTC SEO: technical SEO, keyword strategy, content planning, product- and collection-page optimization, structured data and link building, including GEO/AEO for AI search.

When should I use afa-seo?

When your store needs better indexing, keyword strategy, on-page SEO or backlinks.

Marketing & SEOseocontent

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.