Back to Details

sales-yoast

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Yoast SEO Platform Help

Yoast SEO平台帮助

Step 1 — Gather context

步骤1 — 收集上下文

If 
references/learnings.md
exists, read it first for accumulated platform knowledge.
Ask the user:
  1. Which platform are you using Yoast on?
    • A) WordPress (free plugin)
    • B) WordPress (Premium / AI+)
    • C) Shopify
    • D) WooCommerce
    • E) Not sure / evaluating
  2. What do you need help with?
    • A) Content optimization — SEO score or readability won't improve
    • B) Schema / structured data — not appearing in search results
    • C) Technical setup — redirects, sitemaps, canonical URLs, robots
    • D) API / headless — setting Yoast fields via REST API
    • E) Performance — site slowed down after installing Yoast
    • F) Update issue — Yoast update broke something
    • G) Shopify-specific — setup, uninstall, schema, llms.txt
    • H) Pricing / plan comparison — which tier do I need
    • I) Something else — describe it
Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
如果
references/learnings.md
文件存在，请先阅读该文件以获取积累的平台知识。
询问用户：
  1. 你在哪个平台上使用Yoast？
    • A) WordPress（免费插件）
    • B) WordPress（高级版/AI+版）
    • C) Shopify
    • D) WooCommerce
    • E) 不确定/正在评估
  2. 你需要哪方面的帮助？
    • A) 内容优化——SEO评分或可读性无法提升
    • B) Schema/结构化数据——未在搜索结果中显示
    • C) 技术设置——重定向、站点地图、规范URL、robots协议
    • D) API/无头架构——通过REST API设置Yoast字段
    • E) 性能问题——安装Yoast后网站变慢
    • F) 更新问题——Yoast更新导致功能故障
    • G) Shopify专属问题——设置、卸载、schema、llms.txt
    • H) 定价/方案对比——我需要哪个层级的方案
    • I) 其他问题——请描述具体内容
跳过规则：如果用户的提示已包含足够上下文，直接进入步骤2。

Step 2 — Route or answer directly

步骤2 — 转至对应技能或直接解答

Problem domainRoute to
General SEO strategy (not Yoast-specific)
/sales-semrush [your SEO question]
or 
/seo-audit [your question]
AI search visibility / LLM citations
/sales-ai-visibility [your question]
Schema markup strategy (cross-platform)
/schema-markup [your question]
Email deliverability for marketing
/sales-deliverability [your question]
WordPress site performanceAnswer directly using platform guide
When routing to another skill, provide the exact command: "This is a general SEO question — run: 
/sales-semrush [user's original question]
"
If the question is Yoast-specific, continue to Step 3.
问题领域转至
通用SEO策略（非Yoast专属）
/sales-semrush [你的SEO问题]
或 
/seo-audit [你的问题]
AI搜索可见性/LLM引用
/sales-ai-visibility [你的问题]
Schema标记策略（跨平台）
/schema-markup [你的问题]
营销邮件送达率
/sales-deliverability [你的问题]
WordPress站点性能使用平台指南直接解答
转至其他技能时，请提供准确命令："这是通用SEO问题——请执行：
/sales-semrush [用户原始问题]
"
如果问题是Yoast专属，请继续步骤3。

Step 3 — Yoast platform reference

步骤3 — Yoast平台参考资料

Read 
references/platform-guide.md
 for the full platform reference — modules, pricing, integrations, data model, APIs.
Answer the user's question using only the relevant section. Don't dump the full reference.
**阅读
references/platform-guide.md
**获取完整平台参考——模块、定价、集成、数据模型、API。
仅使用相关部分解答用户问题，不要输出完整参考内容。

Step 4 — Actionable guidance

步骤4 — 可落地指导

Focus on the user's specific situation:
  • Content scores: Check focus keyphrase placement (title, first paragraph, subheadings, meta description, slug, alt text). Green requires hitting most checks — not all.
  • Schema issues: Validate with Google Rich Results Test. Check if theme outputs duplicate schema. Yoast auto-generates Article, Organization, BreadcrumbList, Product (WooCommerce/Shopify).
  • Performance: Disable unused features (internal linking for free, admin bar, text link counter). Test with Query Monitor plugin.
  • API/headless: Use 
    yoast_head_json
    on WP REST endpoints or 
    /wp-json/yoast/v1/get_head?url=
    . Read-only — no write endpoints.
  • Shopify uninstall: Follow official uninstall process to remove metafields. Test with Google Rich Results Test after removal.
If you discover a gotcha, workaround, or tip not covered in 
references/learnings.md
, append it there.
聚焦用户具体场景：
  • 内容评分：检查核心关键词的放置位置（标题、首段、副标题、元描述、slug、替代文本）。绿色评分需要满足大部分检查项，而非全部。
  • Schema问题：使用Google富媒体结果测试工具验证。检查主题是否输出重复的schema。Yoast会自动生成Article、Organization、BreadcrumbList、Product（WooCommerce/Shopify）类型的schema。
  • 性能优化：禁用未使用的功能（免费版的内部链接、管理栏、文本链接计数器）。使用Query Monitor插件测试性能。
  • API/无头架构：在WP REST端点使用
    yoast_head_json
    ，或调用
    /wp-json/yoast/v1/get_head?url=
    。该接口为只读——无写入端点。
  • Shopify卸载：遵循官方卸载流程以移除元字段。卸载后使用Google富媒体结果测试工具验证。
如果发现
references/learnings.md
未涵盖的陷阱、变通方案或技巧，请将其追加到该文件中。

Gotchas

注意事项

Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
  • Premium features per-site licensed — each €118.80/yr subscription covers ONE domain. Multi-site gets expensive fast vs Rank Math (unlimited sites on Pro).
  • Free version limits focus keyphrase to 1 — Premium allows up to 5 related keyphrases per post.
  • Redirect manager is Premium-only — free users need a separate plugin (Redirection, Safe Redirect Manager).
  • Internal linking suggestions are Premium-only — and require a background indexing process that can slow large sites.
  • Shopify version is stripped down — no full snippet variables, no internal linking tools, fewer customization options than WordPress.
  • Content-Security-Policy can block analysis — if you have a custom CSP header, add Yoast's analysis worker to 
    worker-src
    directive.
  • Schema conflicts with themes — many WordPress themes output their own schema. Yoast's schema can duplicate, causing Google Search Console warnings.
  • Yoast SEO AI+ is €358.80/yr — includes AI-generated titles/descriptions. The base Premium (€118.80) has limited AI features.
基于研究的最佳实践——请重点关注这些内容，尤其是关于方案专属功能和集成陷阱的条目，这些内容可能会过时。
  • 高级功能按站点授权——每个每年118.80欧元的订阅仅覆盖一个域名。多站点场景下，相比Rank Math（专业版支持无限站点），成本会快速上升。
  • 免费版限制核心关键词数量为1个——高级版允许每篇文章最多添加5个相关关键词。
  • 重定向管理器为高级版专属——免费用户需要单独安装插件（如Redirection、Safe Redirect Manager）。
  • 内部链接建议为高级版专属——且需要后台索引流程，可能会拖慢大型站点。
  • Shopify版本功能精简——无完整代码片段变量、无内部链接工具，自定义选项少于WordPress版本。
  • 内容安全策略（CSP）可能会阻止分析——如果您使用自定义CSP头，请将Yoast的分析工作线程添加到
    worker-src
    指令中。
  • Schema与主题冲突——许多WordPress主题会自行输出schema。Yoast的schema可能会与其重复，导致Google Search Console发出警告。
  • Yoast SEO AI+版每年358.80欧元——包含AI生成标题/描述功能。基础高级版（每年118.80欧元）仅具备有限的AI功能。

Related skills

相关技能

  • /sales-semrush
    — Semrush SEO platform (keyword research, site audits, rank tracking, backlink analysis). Install: 
    npx skills add sales-skills/sales --skill sales-semrush
  • /sales-ai-visibility
    — AI visibility monitoring (track what ChatGPT, Perplexity, Gemini say about your brand). Install: 
    npx skills add sales-skills/sales --skill sales-ai-visibility
  • /sales-do
    — Not sure which skill to use? The router matches any sales objective to the right skill. Install: 
    npx skills add sales-skills/sales --skill sales-do
  • /sales-semrush
    — Semrush SEO平台（关键词研究、站点审计、排名追踪、反向链接分析）。安装命令：
    npx skills add sales-skills/sales --skill sales-semrush
  • /sales-ai-visibility
    — AI可见性监控（追踪ChatGPT、Perplexity、Gemini对您品牌的评价）。安装命令：
    npx skills add sales-skills/sales --skill sales-ai-visibility
  • /sales-do
    — 不确定使用哪个技能？该路由工具可将任何销售目标匹配到合适的技能。安装命令：
    npx skills add sales-skills/sales --skill sales-do

Examples

示例

Example 1: "My Yoast readability score is orange and I can't figure out what to fix" → Walks through Flesch Reading Ease target (60-70), sentence length (<20 words), passive voice (<10%), transition words (>30%), paragraph length, and subheading distribution.
Example 2: "I'm building a headless Next.js site and need Yoast meta data from the REST API" → Covers the 
/wp-json/yoast/v1/get_head?url=
endpoint, 
yoast_head_json
field on WP REST responses, and how to parse the JSON response for title, description, OG tags, and schema.
Example 3: "My Google Search Console shows duplicate schema errors after installing Yoast" → Diagnoses theme vs Yoast schema conflict, shows how to use 
wpseo_json_ld_output
filter to disable Yoast schema or remove theme schema, and how to validate with Rich Results Test.
示例1："我的Yoast可读性评分是橙色，不知道该怎么修复" → 讲解Flesch可读性评分目标（60-70）、句子长度（<20词）、被动语态占比（<10%）、过渡词占比（>30%）、段落长度以及副标题分布。
示例2："我正在构建一个无头Next.js站点，需要从REST API获取Yoast元数据" → 介绍
/wp-json/yoast/v1/get_head?url=
端点、WP REST响应中的
yoast_head_json
字段，以及如何解析JSON响应以获取标题、描述、OG标签和schema。
示例3："安装Yoast后，我的Google Search Console显示重复schema错误" → 诊断主题与Yoast的schema冲突，展示如何使用
wpseo_json_ld_output
过滤器禁用Yoast的schema或移除主题的schema，并说明如何使用富媒体结果测试工具验证。

Troubleshooting

故障排查

Yoast update caused a critical error / white screen

Yoast更新导致严重错误/白屏

WordPress shows "critical error" after updating Yoast to a new version. Disable Yoast via FTP (rename 
wordpress-seo
folder in 
/wp-content/plugins/
), check PHP version compatibility (Yoast requires PHP 7.4+), then re-enable. Check for plugin conflicts by disabling all other plugins first.
更新Yoast到新版本后，WordPress显示“严重错误”。通过FTP禁用Yoast（重命名
/wp-content/plugins/
目录下的
wordpress-seo
文件夹），检查PHP版本兼容性（Yoast要求PHP 7.4+），然后重新启用。先禁用所有其他插件以排查插件冲突。

SEO analysis shows gray bullets / meta box won't load

SEO分析显示灰色项目符号/元框无法加载

The Yoast meta box loads via JavaScript. A CSP header blocking 
worker-src
, a JavaScript conflict with another plugin, or a caching plugin serving stale assets can prevent it from loading. Check browser console for errors. Add 
blob:
and 
data:
to your CSP 
worker-src
if applicable.
Yoast元框通过JavaScript加载。阻止
worker-src
的CSP头、与其他插件的JavaScript冲突，或缓存插件提供的过期资源都可能导致其无法加载。检查浏览器控制台的错误信息。如果适用，请将
blob:
和
data:
添加到CSP的
worker-src
中。

Yoast left behind code on Shopify after uninstalling

卸载Yoast后，Shopify仍残留相关代码

Yoast injects schema and metafields that persist after app removal. Run the official Yoast uninstall process (not just Shopify app delete). Check your theme's 
<head>
for leftover 
ld+json
blocks and use Google Rich Results Test to verify clean removal.
Yoast注入的schema和元字段在应用删除后仍会保留。请执行官方Yoast卸载流程（而非仅删除Shopify应用）。检查主题的
<head>
部分是否残留
ld+json
代码块，并使用Google富媒体结果测试工具验证是否已彻底移除。