TheCraigHewitt/seomachine

# SEO Machine 一个专为任何企业创建长篇、SEO 优化博客内容的专用 Claude Code 工作区。该系统帮助您研究、撰写、分析和优化能够获得良好排名并服务于目标受众的内容。 ## 概述 SEO Machine 基于 Claude Code 构建，提供： - **自定义命令**：`/research`、`/write`、`/rewrite`、`/analyze-existing`、`/optimize`、`/performance-review`、`/publish-draft`、`/article`、`/priorities`，以及专门的研究和落地页命令 - **专用 Agent**：内容分析器、SEO 优化、Meta 元素创建、内部链接、关键词映射、编辑、性能分析、标题生成器、CRO 分析师、落地页优化器 - **营销技能**：26 项营销技能，涵盖文案写作、CRO、A/B 测试、邮件序列、定价策略等 - **高级 SEO 分析**：搜索意图检测、关键词密度与聚类、内容长度对比、可读性评分、SEO 质量评级 (0-100) - **数据集成**：Google Analytics 4、Google Search Console、DataForSEO，用于获取实时性能洞察 - **上下文驱动**：品牌语调、风格指南、SEO 指南和示例指导所有内容 - **工作流组织**：针对主题、研究、草稿和已发布内容的结构化目录 ## 快速开始 ### 前置条件 - 已安装 [Claude Code](https://claude.com/claude-code) - Anthropic API 账户 ### 安装 1. 克隆此仓库： ``` git clone https://github.com/[your-username]/seomachine.git cd seomachine ``` 2. 安装分析模块的 Python 依赖项： ``` pip install -r data_sources/requirements.txt ``` 这将安装： - Google Analytics/Search Console 集成 - DataForSEO API 客户端 - NLP 库 (nltk, textstat) - 机器学习 (scikit-learn) - Web 抓取工具 (beautifulsoup4) 3. 在 Claude Code 中打开： ``` claude-code . ``` 4. **自定义上下文文件**（重要！）： 所有上下文文件均以模板形式提供。请使用您公司的信息填写： - `context/brand-voice.md` - 定义您的品牌语调和信息 *（参考 examples/castos/）* - `context/writing-examples.md` - 添加 3-5 篇您网站上的 exemplary 博客文章 - `context/features.md` - 列出您的产品/服务功能和优势 - `context/internal-links-map.md` - 映射您的关键页面以进行内部链接 - `context/style-guide.md` - 填写您的风格偏好 - `context/target-keywords.md` - 添加您的关键词研究和主题集群 - `context/competitor-analysis.md` - 添加竞争对手分析和洞察 - `context/seo-guidelines.md` - 检查并调整 SEO 要求 **快速开始**：查看 `examples/castos/`，了解一家播客托管 SaaS 公司如何填写所有上下文文件的完整真实示例。 ## 工作流 ### 创建新内容 #### 1. 从研究开始 ``` /research [topic] ``` **它的作用**： - 执行关键词研究 - 分析前 10 名竞争对手 - 识别内容差距 - 创建综合研究简报 - 保存到 `/research/` 目录 **示例**： ``` /research content marketing strategies for B2B SaaS ``` #### 2. 撰写文章 ``` /write [topic or research brief] ``` **它的作用**： - 创建 2000-3000+ 字的 SEO 优化文章 - 保持 `context/brand-voice.md` 中的品牌语调 - 自然地整合关键词 - 包含内部和外部链接 - 提供 Meta 元素（标题、描述、关键词） - 自动触发优化 Agent - 保存到 `/drafts/` 目录 **示例**： ``` /write content marketing strategies for B2B SaaS ``` **Agent 自动执行**： 撰写后，这些 Agent 会自动分析内容： - **SEO Optimizer**：页面内 SEO 建议 - **Meta Creator**：多种 Meta 标题/描述选项 - **Internal Linker**：具体的内部链接建议 - **Keyword Mapper**：关键词布局和密度分析 #### 3. 最终优化 ``` /optimize [article file] ``` **它的作用**： - 全面的 SEO 审计 - 验证所有元素是否符合要求 - 提供最终润色建议 - 生成发布准备评分 - 创建优化报告 **示例**： ``` /optimize drafts/content-marketing-strategies-2025-10-29.md ``` ### 更新现有内容 #### 1. 分析现有文章 ``` /analyze-existing [URL or file path] ``` **它的作用**： - 获取并分析当前内容 - 评估 SEO 性能 - 识别过时信息 - 评估竞争定位 - 提供内容健康评分 (0-100) - 推荐更新优先级和范围 - 将分析保存到 `/research/` 目录 **示例**： ``` /analyze-existing https://yoursite.com/blog/marketing-guide /analyze-existing published/marketing-guide-2024-01-15.md ``` #### 2. 重写/更新内容 ``` /rewrite [topic or analysis file] ``` **它的作用**： - 根据分析发现更新内容 - 刷新统计数据和示例 - 改进 SEO 优化 - 添加新章节以填补空白 - 保留原文中有效的部分 - 跟踪所做的更改 - 保存到 `/rewrites/` 目录 **示例**： ``` /rewrite marketing guide ``` ## 命令参考 ### `/research [topic]` 针对新内容的综合关键词和竞争研究。 **输出**：`/research/brief-[topic]-[date].md` 中的研究简报 **包含**： - 主要和次要关键词 - 竞争对手分析（前 10 名） - 内容差距和机会 - 推荐大纲 - 内部链接策略 - Meta 元素预览 ### `/write [topic]` 创建长篇 SEO 优化文章（2000-3000+ 字）。 **输出**：`/drafts/[topic]-[date].md` 中的文章 **包含**： - 具有 H1/H2/H3 结构的完整文章 - SEO 优化内容 - 内部和外部链接 - Meta 元素（标题、描述、关键词） - SEO 检查清单 **自动触发**： - SEO Optimizer agent - Meta Creator agent - Internal Linker agent - Keyword Mapper agent ### `/rewrite [topic]` 更新和改进现有内容。 **输出**：`/rewrites/[topic]-rewrite-[date].md` 中的更新文章 **包含**： - 重写/更新的内容 - 更改摘要 - 前后对比 - 更新的 SEO 元素 ### `/analyze-existing [URL or file]` 分析现有博客文章的改进机会。 **输出**：`/research/analysis-[topic]-[date].md` 中的分析报告 **包含**： - 内容健康评分 (0-100) - 速赢点（即时改进） - 战略性改进 - 重写优先级和范围 - 用于重写的研究简报 ### `/optimize [file]` 发布前的最终 SEO 优化通过。 **输出**：`/drafts/optimization-report-[topic]-[date].md` 中的优化报告 **包含**： - SEO 评分 (0-100) - 优先修复项 - 速赢点 - Meta 元素选项 - 链接增强建议 - 发布准备评估 ### `/publish-draft [file]` 通过 REST API 将文章发布到 WordPress，包含 Yoast SEO 元数据。 ### `/article [topic]` 简化的文章创建工作流。 ### `/priorities` 使用分析数据的内容优先级矩阵，用于识别影响力最高的内容任务。 ### `/scrub [file]` 从内容中移除 AI 水印和模式（em-dashes、填充短语、机械模式）。 ### 研究命令 | 命令 | 描述 | |---------|-------------| | `/research-serp [keyword]` | 目标关键词的 SERP 分析 | | `/research-gaps` | 竞争对手内容差距分析 | | `/research-trending` | 热门话题机会 | | `/research-performance` | 基于性能的内容优先级 | | `/research-topics` | 主题集群研究 | ### 落地页命令 | 命令 | 描述 | |---------|-------------| | `/landing-write [topic]` | 创建转化优化的落地页 | | `/landing-audit [file]` | 审计落地页的 CRO 问题 | | `/landing-research [topic]` | 研究竞争对手和定位 | | `/landing-competitor [URL]` | 深度竞争对手落地页分析 | | `/landing-publish [file]` | 将落地页发布到 WordPress | ## Agent 自动分析内容并提供专家建议的专用 Agent。 ### Content Analyzer (新功能！) **用途**：使用 5 个专用模块进行全面的、数据驱动的内容分析 **分析**： - 搜索意图分类 - 关键词密度和聚类以及主题检测 - 内容长度与顶级 SERP 竞争对手的对比 - 可读性评分 - SEO 质量评级（0-100 分及类别细分） - 关词堆砌风险检测 - 被动语态比例和句子复杂性 - 显示各部分关键词布局的分布热图 **输出**： - 包含发布准备评估的执行摘要 - 优先行动计划（关键/高优先级/优化） - 竞争定位分析 - 针对每个分析领域的详细建议 - 用于改进的精确指标和基准 **技术支持**： - `search_intent_analyzer.py` - 搜索意图检测 - `keyword_analyzer.py` - 关键词密度、聚类、LSI 关键词 - `content_length_comparator.py` - SERP 竞争对手分析 - `readability_scorer.py` - 多种可读性指标 - `seo_quality_rater.py` - 全面的 SEO 评分 ### SEO 优化器 **用途**：页面内 SEO 分析和优化建议 **分析**： - 关键词优化和密度 - 内容结构和标题 - 内部和外部链接 - Meta 元素 - 可读性和用户体验 - 精选摘要机会 **输出**：SEO 评分 (0-100) 及具体的改进建议 ### Meta 创建者 **用途**：生成高转化率的 Meta 标题和描述 **创建**： - 5 个 Meta 标题变体（50-60 个字符） - 5 个 Meta 描述变体（150-160 个字符） - 测试建议 - SERP 预览 - 转化优化文案 **输出**：包含推荐和理由的多种选项 ### 内部链接专家 **用途**：战略性内部链接建议 **提供**： - 3-5 个具体的内部链接建议 - 确切的放置位置 - 锚文本建议 - 用户旅程映射 - SEO 影响预测 **参考**：`context/internal-links-map.md` ### Keyword 映射器 **用途**：关键词布局和整合分析 **分析**： - 关键词密度和分布 - 关键位置检查清单 - 自然语言整合质量 - LSI 关键词覆盖范围 - 关键词蚕食风险 **输出**：分布图、差距分析、具体的修改建议 ### 编辑 **用途**：将技术准确的内容转化为听起来像人类、引人入胜的文章 **分析**： - 语调和个性 - 示例的具体性 - 可读性和流畅度 - 机械与人类模式 - 互动性和故事性 **提供**： - 人性化评分 (0-100) - 包含前后对比的关键编辑 - 模式分析 - 注入个性的具体重写 - 可读性改进 **输出**：包含具体改进建议的编辑报告，使内容听起来像人类 ### 性能 **用途**：使用真实分析数据进行数据驱动的内容优先级排序 **分析**： - Google Analytics 流量和趋势 - Google Search Console 排名和 CTR - DataForSEO 竞争数据 - 速赢点（排名 11-20 位） - 衰退内容 - 低 CTR 机会 - 热门话题 **提供**： - 内容任务优先队列 - 机会评分 (0-100) - 影响力和工作量估算 - 逐周路线图 - 成功指标 **输出**：包含可操作优先级的综合性能报告 ### 标题生成器 **用途**：生成高转化率的标题变体和 A/B 测试建议 **提供**： - 使用经过验证的公式的 10+ 个标题变体 - 转化潜力评分 - A/B 测试策略 - 针对特定受众的标题选项 ### CRO 分析师 **用途**：落地页的转化率优化分析 **分析**： - 首屏内容有效性 - CTA 质量和分布 - 信任信号存在感 - 摩擦点 - 页面结构 ### Landing Page 优化器 **用途**：全面的落地页优化建议 **提供**： - CRO 评分 (0-100) 及类别细分 - 首屏、CTA、信任信号、结构和 SEO 分析 - A/B 测试建议 - 优先行动清单 ## 营销技能 SEO Machine 包含 26 项可作为斜杠命令访问的营销技能： | 类别 | 技能 | |----------|--------| | **文案写作** | `/writing`, `/copy-editing` | | **CRO** | `/page-cro`, `/form-cro`, `/signup-flow-cro`, `/onboarding-cro`, `/popup-cro`, `/paywall-upgrade-cro` | | **策略** | `/content-strategy`, `/pricing-strategy`, `/launch-strategy`, `/marketing-ideas` | | **渠道** | `/email-sequence`, `/social-content`, `/paid-ads` | | **SEO** | `/seo-audit`, `/schema-markup`, `/programmatic-seo`, `/competitor-alternatives` | | **分析** | `/analytics-tracking`, `/ab-test-setup` | | **其他** | `/referral-program`, `/free-tool-strategy`, `/marketing-psychology` | ## 数据源 ### 与分析工具集成 SEO Machine 与实时数据源集成以指导内容策略： **Google Analytics 4**： - 流量和参与度指标 - 转化跟踪 - 趋势分析 - 流量来源 **Google Search Console**： - 关键词排名和位置 - 展示次数和点击次数 - CTR 分析 - 查询性能 **DataForSEO**： - 竞争排名 - SERP 特性 - 关键词指标 - 竞争对手差距分析 ### 高级 SEO 分析模块（新功能！） SEO Machine 包含 5 个专用 Python 模块，用于全面的内容分析： **Search Intent Analyzer** (`search_intent_analyzer.py`)： - 将查询分类为信息类、导航类、交易类或商业调查类意图 - 分析 SERP 特性和内容模式 - 提供置信度评分和内容一致性建议 **Keyword Analyzer** (`keyword_analyzer.py`)： - 计算确切的关键词密度和分布 - 检测关键词堆砌风险并发出警告 - 使用 TF-IDF 和 K-means 执行主题聚类 - 按部分生成分布热图 - 识别 LSI（语义相关）关键词 **SEO Quality Rater** (`seo_quality_rater.py`)： - 根据 SEO 最佳实践对内容进行评级（0-100 分） - 类别细分：内容、关键词、Meta、结构、链接、可读性 - 识别关键问题、警告和建议 - 确定发布准备情况 **Content Length Comparator** (`content_length_comparator.py`)： - 获取并分析前 10-20 个 SERP 竞争对手的字数 - 计算中位数、第 75 百分位数和最佳长度 - 显示竞争定位和与目标的差距 - 提供数据驱动的扩展建议 **Readability Scorer** (`readability_scorer.py`)： - Flesch Reading Ease 和 Flesch-Kincaid Grade Level - 句子和段落结构分析 - 被动语态检测和比例计算 - 复杂词识别 - 过渡词使用分析 - 整体可读性评分 (0-100) 所有模块均可直接在 Python 中使用或通过 Content Analyzer agent 使用。 ### CRO 分析模块 六个用于落地页转化优化的 Python 模块： - `above_fold_analyzer.py` - 首屏内容分析（标题、价值主张、CTA、信任） - `cta_analyzer.py` - CTA 有效性评分（质量、分布、目标一致性） - `trust_signal_analyzer.py` - 信任信号检测（推荐、社会证明、风险逆转） - `landing_page_scorer.py` - 整体落地页评分（0-100 及类别细分） - `landing_performance.py` - 通过 GA4/GSC 进行落地页性能跟踪 - `cro_checker.py` - CRO 最佳实践检查表验证 ### 附加分析模块 - `opportunity_scorer.py` - 8 因素机会评分，用于内容优先级排序 - `content_scorer.py` - 5 维度内容质量评分（人性化、具体性、结构、SEO、可读性） - `engagement_analyzer.py` - 内容互动模式分析 - `competitor_gap_analyzer.py` - 竞争内容差距识别 - `article_planner.py` - 数据驱动的文章规划 - `section_writer.py` - 章节级内容指导 - `social_research_aggregator.py` - 社交媒体研究聚合 ### Python 研究脚本 从仓库根目录运行： ``` # 内容研究 python3 research_quick_wins.py python3 research_competitor_gaps.py python3 research_performance_matrix.py python3 research_priorities_comprehensive.py python3 research_serp_analysis.py python3 research_topic_clusters.py python3 research_trending.py # SEO 分析 (配置驱动 - 请先设置 config/competitors.json) python3 seo_baseline_analysis.py python3 seo_bofu_rankings.py python3 seo_competitor_analysis.py # 测试 API 连接 python3 test_dataforseo.py ``` **注意**：SEO 分析脚本从 `config/competitors.json` 加载竞争对手列表和关键词。复制 `config/competitors.example.json` 并根据您的业务进行自定义。 ### WordPress 集成 发布使用 WordPress REST API 以及一个暴露 Yoast SEO 字段的自定义 MU-plugin。 **设置**： 1. 在您的 WordPress 站点上安装 `wordpress/seo-machine-yoast-rest.php` 作为 MU-plugin 2. 将 `wordpress/functions-snippet.php` 添加到您主题的 functions.php 中 3. 在 `.env` 中配置 WordPress 凭据： WP_URL=https://yoursite.com WP_USERNAME=your_username WP_APP_PASSWORD=your_application_password 有关详细的设置说明，请参阅 `wordpress/README.md`。 有关分析设置说明，请参阅 `data_sources/README.md`。 ## 目录结构 ``` seomachine/ ├── .claude/ │ ├── commands/ # Custom workflow commands │ │ ├── analyze-existing.md │ │ ├── research.md │ │ ├── write.md │ │ ├── rewrite.md │ │ ├── optimize.md │ │ ├── scrub.md │ │ ├── performance-review.md │ │ ├── publish-draft.md │ │ ├── article.md │ │ ├── priorities.md │ │ ├── research-serp.md │ │ ├── research-gaps.md │ │ ├── research-trending.md │ │ ├── research-performance.md │ │ ├── research-topics.md │ │ ├── landing-write.md │ │ ├── landing-audit.md │ │ ├── landing-research.md │ │ ├── landing-competitor.md │ │ └── landing-publish.md │ ├── agents/ # Specialized analysis agents │ │ ├── content-analyzer.md │ │ ├── seo-optimizer.md │ │ ├── meta-creator.md │ │ ├── internal-linker.md │ │ ├── keyword-mapper.md │ │ ├── editor.md │ │ ├── performance.md │ │ ├── headline-generator.md │ │ ├── cro-analyst.md │ │ └── landing-page-optimizer.md │ └── skills/ # 26 marketing skills ├── data_sources/ # Analytics integrations │ ├── modules/ # Python analysis modules │ │ ├── google_analytics.py │ │ ├── google_search_console.py │ │ ├── dataforseo.py │ │ ├── data_aggregator.py │ │ ├── search_intent_analyzer.py │ │ ├── keyword_analyzer.py │ │ ├── seo_quality_rater.py │ │ ├── content_length_comparator.py │ │ ├── readability_scorer.py │ │ ├── opportunity_scorer.py │ │ ├── content_scorer.py │ │ ├── engagement_analyzer.py │ │ ├── social_research_aggregator.py │ │ ├── competitor_gap_analyzer.py │ │ ├── article_planner.py │ │ ├── section_writer.py │ │ ├── wordpress_publisher.py │ │ ├── above_fold_analyzer.py │ │ ├── cro_checker.py │ │ ├── cta_analyzer.py │ │ ├── landing_page_scorer.py │ │ ├── landing_performance.py │ │ └── trust_signal_analyzer.py │ ├── config/ # API credentials (not in git) │ ├── utils/ # Helper functions │ ├── cache/ # Cached API responses │ └── README.md # Setup instructions ├── config/ # Configuration files │ └── competitors.example.json # Competitor config template ├── context/ # Configuration and guidelines │ ├── brand-voice.md │ ├── writing-examples.md │ ├── style-guide.md │ ├── seo-guidelines.md │ ├── target-keywords.md │ ├── internal-links-map.md │ ├── competitor-analysis.md │ └── cro-best-practices.md ├── wordpress/ # WordPress integration │ ├── seo-machine-yoast-rest.php │ ├── functions-snippet.php │ └── README.md ├── topics/ # Raw topic ideas ├── research/ # Research briefs and analysis reports ├── drafts/ # Work in progress articles ├── review-required/ # Articles pending review ├── published/ # Final versions ready to publish ├── rewrites/ # Updated existing content ├── landing-pages/ # Landing page content ├── audits/ # Audit reports └── README.md # This file ``` ## 上下文文件（重要！） 内容的质量取决于配置良好的上下文文件： ### `context/brand-voice.md` 定义您的品牌语调、语气和信息框架。 **必须包含**： - 语调支柱 - 按内容类型划分的语气指南 - 核心品牌信息 - 写作风格指南 - 术语偏好 **目的**：确保所有内容听起来都符合您的品牌调性 ### `context/writing-examples.md` 包含 3-5 篇您网站上的 exemplary 博客文章。 **必须包含**： - 完整的文章内容 - 每个示例的出众之处 - 关于语调和结构的关键要点 **目的**：通过示例教会 AI 您特定的写作风格 ### `context/style-guide.md` 编辑和格式标准。 **必须包含**： - 语法和机制规则 - 大小写约定 - 格式标准 - 首选术语 **目的**：保持所有内容的一致性 ### `context/seo-guidelines.md` SEO 最佳实践和要求。 **包含**： - 内容长度要求 - 关键词优化规则 - Meta 元素标准 - 链接策略指南 - 可读性要求 **目的**：确保所有内容符合 SEO 标准 ### `context/target-keywords.md` 按主题集群组织的关键词研究。 **必须包含**： - 按集群划分的核心关键词 - 集群关键词（子主题） - 长尾变体 - 搜索意图分类 - 当前排名 **目的**：指导新内容的关键词定位 ### `context/internal-links-map.md` 您网站上用于内部链接的关键页面目录。 **必须包含**： - 产品页面和功能 - 核心内容 URL - 表现最佳的博客文章 - 主题集群映射 - 推荐的锚文本 **目的**：在每篇文章中实现战略性内部链接 ### `context/competitor-analysis.md` 竞争情报和内容差距。 **必须包含**： - 主要竞争对手 - 他们的内容策略 - 关键词差距 - 差异化机会 **目的**：为内容策略和竞争定位提供信息 ## 内容质量标准 每篇文章必须满足以下要求： ### 内容 - [ ] 至少 2,000 字（首选 2,500-3,000+ 字） - [ ] 提供优于竞争对手的独特价值 - [ ] 事实准确且时新 - [ ] 为目标受众提供可操作的建议 - [ ] 保持品牌语调 ### SEO - [ ] 主要关键词密度 1-2% - [ ] 关键词出现在 H1、前 100 个字、2-3 个 H2 中 - [ ] 3-5 个带有描述性锚文本的内部链接 - [ ] 2-3 个外部权威链接 - [ ] Meta 标题 50-60 个字符 - [ ] Meta 描述 150-160 个字符 - [ ] 正确的 H1>H2>H3 层级结构 ### 可读性 - [ ] 8-10 年级阅读水平 - [ ] 平均句长 15-20 个词 - [ ] 段落 2-4 句 - [ ] 每 300-400 字一个小标题 - [ ] 列表和格式便于扫描 ### 结构 - [ ] 引人入胜的引言（诱饵、问题、承诺） - [ ] 逻辑流畅的章节 - [ ] 带有 CTA 的清晰结论 - [ ] 包含示例和数据 ## 最佳实践 ### 撰写前 1. **先研究**：始终在 `/write` 之前运行 `/research` 2. **查看上下文**：阅读 `brand-voice.md` 和相关的 `writing-examples.md` 3. **检查关键词**：在 `target-keywords.md` 中验证目标关键词 4. **规划内部链接**：查看 `internal-links-map.md` 以寻找链接机会 ### 撰写期间 1. **遵循简报**：使用研究简报作为大纲 2. **自然融入关键词**：自然地整合关键词，绝不强行插入 3. **增加价值**：每个章节都应提供可操作的见解 4. **使用示例**：包含您行业的真实场景和用例 5. **引用来源**：链接到统计数据和数据来源 ### 撰写后 1. **查看 Agent 输出**：仔细阅读所有 Agent 建议 2. **进行改进**：在优化之前解决高优先级问题 3. **运行优化**：使用 `/optimize` 进行最终润色 4. **自我编辑**：以目标读者的身份阅读文章 5. **检查质量**：验证是否满足所有检查清单项目 ### 对于重写 1. **先分析**：运行 `/analyze-existing` 以了解范围 2. **确定策略**：轻微更新还是大幅重写？ 3. **保留有效部分**：保留有效的章节 4. **关注差距**：添加竞争内容中缺失的部分 5. **更新所有内容**：统计数据、示例、截图、链接 ## 工作流示例 ### 示例 1：从头创建新内容 ``` # 步骤 1：添加主题想法 # 在 topics/ 目录中创建文件并记录初步想法 # 步骤 2：研究主题 /research content marketing strategies # 步骤 3：审查研究简报 # 阅读 research/brief-content-marketing-strategies-[date].md # 步骤 4：撰写文章 /write content marketing strategies # 步骤 5：审查 Agent 反馈 # 阅读 drafts/ 中的所有 Agent 报告 # 步骤 6：进行改进 # 根据 Agent 建议编辑文章 # 步骤 7：最终优化 /optimize drafts/content-marketing-strategies-[date].md # 步骤 8：发布到 WordPress (可选) /publish-draft drafts/content-marketing-strategies-[date].md ``` ### 示例 2：更新现有内容 ``` # 步骤 1：分析现有文章 /analyze-existing https://yoursite.com/blog/product-comparison # 步骤 2：审查分析 # 阅读 research/analysis-product-comparison-2025-10-29.md # 检查内容健康度得分和优先级 # 步骤 3：重写内容 /rewrite product comparison # 步骤 4：审查更改 # 阅读 rewrites/product-comparison-rewrite-2025-10-29.md # 审查更改摘要 # 步骤 5：优化 /optimize rewrites/product-comparison-rewrite-2025-10-29.md # 步骤 6：发布 # 准备就绪后移动到 published/ ``` ### 示例 3：快速内容审计 ``` # 分析多个现有文章以确定更新优先级 /analyze-existing https://yoursite.com/blog/post-1 /analyze-existing https://yoursite.com/blog/post-2 /analyze-existing https://yoursite.com/blog/post-3 # 审查内容健康度得分 # 根据以下因素确定重写优先级： # - 最低分数 # - 最高流量潜力 # - 战略重要性 ``` ## 技巧与窍门 ### 最大化内容质量 - **研读示例**：在每次写作前阅读您的 `writing-examples.md` - **使用数据**：始终包含最新的统计数据并引用来源 - **具体化**：“增长 40%”胜过“显著改善” - **展示，而非讲述**：使用您行业的真实示例和场景 - **回答问题**：解决研究中来自“People Also Ask”的问题 ### SEO 优化 - **关键词前置**：将主要关键词放在前 100 个字中 - **自然整合**：大声朗读内容——如果关键词听起来很牵强，请重写 - **多样化锚文本**：不要对所有内部链接使用相同的锚文本 - **战略性链接**：链接到核心内容和相关的集群文章 - **定期更新**：每 6-12 个月刷新表现最佳的内容 ### 工作流效率 - **批量研究**：在一次会话中研究多个主题 - **遵循结构**：使用 `/write` 命令中的一致文章结构 - **优先解决高优先级**：在优化细节之前修复关键问题 - **明智使用 Agent**：让 Agent 处理分析，您专注于写作 - **构建模板**：保存常用章节以供重复使用 ### 避免常见错误 - ❌ 跳过研究阶段 - ❌ 忽视品牌语调指南 - ❌ 不自然地强行插入关键词 - ❌ 忘记内部链接 - ❌ 不引用数据来源 - ❌ 未经优化即发布 - ❌ 复制竞争对手内容而非寻求差异化 ## 维护 ### 每周 - 向 `/topics/` 添加新的主题创意 - 使用新的关键词机会更新 `target-keywords.md` - 检查 `internal-links-map.md` 中的失效链接 ### 每月 - 查看已发布内容的性能 - 如果出现更好的示例，更新 `writing-examples.md` - 将新发布的内容添加到 `internal-links-map.md` - 在 `competitor-analysis.md` 中跟踪竞争对手活动 ### 每季度 - 对上下文文件进行全面审计 - 根据算法变化更新 SEO 指南 - 全面的竞争对手分析刷新 - 查看并更新 `target-keywords.md` 中的主题集群 ## 故障排除 ### “内容听起来不像我的品牌” - **解决方案**：使用更具体的指导更新 `context/brand-voice.md` - **解决方案**：向 `context/writing-examples.md` 添加更多样化的示例 - **解决方案**：在使用 `/write` 命令时参考具体示例 ### “关键词密度过高/过低” - **解决方案**：查看 `seo-guidelines.md` 的目标密度 (1-2%) - **解决方案**：使用 `/optimize` 获取具体的关键词布局建议 - **解决方案**：使用 Keyword agent 进行分布分析 ### “内部链接不相关” - **解决方案**：使用当前页面更新 `context/internal-links-map.md` - **解决方案**：按主题集群组织，以便 Agent 更容易匹配 - **解决方案**：提供关于每个页面涵盖内容的更多上下文 ### “文章与竞争对手太相似” - **解决方案**：使用差异化机会更新 `competitor-analysis.md` - **解决方案**：将您的独特优势添加到 `brand-voice.md` 和 `features.md` - **解决方案**：在 `/research` 命令中参考具体的差异化角度 ## 支持与贡献 ### 获取帮助 - 仔细阅读本 README - 检查上下文文件是否配置正确 - 查阅 [Claude Code 文档](https://docs.claude.com/claude-code) ### 贡献 - 通过 GitHub Issues 报告问题 - 对命令或 Agent 提出改进建议 - 分享成功的工作流或技巧 ## 许可证 [添加您的许可证信息] ## 致谢 由 Anthropic 使用 [Claude Code](https://claude.com/claude-code) 构建。 最初为 Castos 开发，现在作为开源工具提供给任何企业，以简化长篇 SEO 内容的创建。 ## 示例与社区 **查看实际应用**：查看 `examples/castos/`，了解一家播客托管 SaaS 公司如何使用 SEO Machine 的完整真实示例。 **欢迎贡献**：发现 Bug？有功能请求？想分享您自己的行业示例？欢迎贡献和 PR！ **准备好开始创建了吗？** 1. 配置您的上下文文件（以模板为指南） 2. 运行 `/research [your topic]` 3. 查看简报 4. 运行 `/write [your topic]` 5. 发布精彩内容！ 祝写作愉快！📝

标签：A/B测试, Anthropic API, Apex, BeautifulSoup, Claude Code, CRO, Google Analytics, Google Search Console, Landing Page优化, NLP, Python, Scikit-learn, SEO优化, SEO分析, Web爬虫, 关键词研究, 内容策略, 内容管理系统, 博客内容创作, 工作流自动化, 开源, 搜索排名, 数字营销, 数据集成, 文案写作, 无后门, 机器学习, 编辑工具, 营销自动化, 转化率优化, 逆向工具, 长篇内容