SEO Machine故障排查完全指南品牌声音跑偏、关键词密度异常怎么办【免费下载链接】seomachineA specialized Claude Code workspace for creating long-form, SEO-optimized blog content for any business. This system helps you research, write, analyze, and optimize content that ranks well and serves your target audience.项目地址: https://gitcode.com/GitHub_Trending/se/seomachineSEO Machine 是一个基于 Claude Code 的开源内容工作区专门用于为任意业务生产长篇幅、经过 SEO 优化的博客文章。当它生成的内容不像你家的品牌或关键词密度告警时不用慌——这两个问题几乎都出在context/上下文文件和几个分析模块上。这份指南带你按症状逐一定位快速修复。核心结论品牌声音跑偏 → 九成是context/brand-voice.md还是模板状态没写具体例子关键词密度异常 → 对照 1-2% 的目标值用 Keyword Mapper 和/optimize调整所有问题修复后跑一遍/optimize拿到 0-100 分的发布就绪评估先自检你的症状是哪一种症状最可能的原因去哪里修文章语气像机器人不像自己品牌品牌声音模板未填充context/brand-voice.md密度过高像堆砌关键词目标密度设置过高 / 生硬重复context/seo-guidelines.md密度过低关键词几乎没出现关键词未写入研究简报context/target-keywords.md内链指向的页面驴唇不对马嘴内链地图过期context/internal-links-map.md文章读起来和竞品一个模子缺少差异化信息context/competitor-analysis.md症状一品牌声音跑偏怎么修第 1 步确认 brand-voice 不是空模板打开 context/brand-voice.md。如果里面还能看到[YOUR COMPANY]、[VOICE PILLAR NAME]这类占位符AI 就只能靠猜来写语气自然跑偏。模板要求你定义3-5 个声音支柱Voice Pillars每个支柱都要写清四件事它意味着什么、听起来是什么样、给一句示例、以及要避免什么。 小技巧给 AI 的指令越具体越好。专业但亲切是模糊的像一位资深编辑给朋友讲解多用我们避免赋能抓手这类词才是可执行的。第 2 步用真实范文教AI 你的风格语气描述写得再好也不如直接给范文。在 context/writing-examples.md 中放入3-5 篇自家站点的优秀文章全文不是节选并逐篇注明好在哪里。项目内置了一个完整范例可以参考examples/castos/brand-voice.md来自一家播客托管 SaaS 公司的真实配置。第 3 步清理AI 腔让文章更像人写的即使声音对齐了文章仍可能残留机械痕迹值得注意的是在当今快节奏的世界里这类套话。SEO Machine 提供了 data_sources/modules/content_scrubber.py它会替换典型 AI 腔短语比如把 leverage 换成 use、移除零宽字符等隐形水印。对应工作流命令就是/scrub [文件]。症状二关键词密度异常怎么办先搞清楚正常是多少项目默认标准写在 context/seo-guidelines.md主关键词1-2% 密度2000 词的文章 ≈ 20-40 次次级关键词各 0.5-1%主关键词必须出现在H1、前 100 词、2-3 个 H2、结尾段、Meta 标题与描述用分析模块定位问题出在哪d data_sources/modules/keyword_analyzer.py 会计算精确密度、生成按章节分布的分布热图并自动触发堆砌stuffing检测密度系统行为 2.5%提示密度偏高 3.0%提示密度过高明确预警堆砌风险如果它报密度过高通常是两个原因一是/research阶段就把关键词定得过死二是写作时机械重复原词。修法是换成自然变体例如 podcast hosting → hosting your podcast而不是删除句子。跑 /optimize 拿精确修改建议/optimize [文件]会输出关键词的具体放置位置建议和密度分布报告由 Keyword Mapper 智能体生成告诉你在哪一段该加、哪一段该换说法。修完再看 data_sources/modules/seo_quality_rater.py 给出的 0-100 分内容、关键词、元数据、结构、链接、可读性六个维度逐项拆解分数低于及格线就继续修。症状三两个高频附带问题内链不相关说明 context/internal-links-map.md 里的页面清单过期或太笼统。把主力页面、支柱内容、高流量文章按主题集群分组并为每页补一句这页讲什么Internal Linker 智能体才能匹配出贴切的锚文本。文章和竞品一个味道依次补全 context/competitor-analysis.md竞品在做什么、你缺什么、差异点在哪和 context/features.md你的独特优势。然后在执行/research时明确指出差异化角度而不是让 AI 自由发挥。竞品脚本需要配置 config/competitors.example.json 的副本复制为config/competitors.json后修改。发布前 5 分钟排查清单brand-voice.md、writing-examples.md已填充真实内容主关键词密度落在 1-2%前 100 词内已出现已跑/optimize拿到发布就绪评估已跑/scrub清理 AI 腔内链 3-5 条、锚文本具体不重复数据源无报错GA4/GSC/DataForSEO 凭据配置见 contenteditable="false">【免费下载链接】seomachineA specialized Claude Code workspace for creating long-form, SEO-optimized blog content for any business. This system helps you research, write, analyze, and optimize content that ranks well and serves your target audience.项目地址: https://gitcode.com/GitHub_Trending/se/seomachine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考