[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72025":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},72025,"seomachine","TheCraigHewitt\u002Fseomachine","TheCraigHewitt","A 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:\u002F\u002Fseomachine.io",null,"Python",7110,966,62,13,0,20,47,182,60,39.96,"MIT License",false,"main",true,[],"2026-06-12 02:02:57","# SEO Machine\n\nA 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.\n\n## Overview\n\nSEO Machine is built on Claude Code and provides:\n- **Custom Commands**: `\u002Fresearch`, `\u002Fwrite`, `\u002Frewrite`, `\u002Fanalyze-existing`, `\u002Foptimize`, `\u002Fperformance-review`, `\u002Fpublish-draft`, `\u002Farticle`, `\u002Fpriorities`, plus specialized research and landing page commands\n- **Specialized Agents**: Content analyzer, SEO optimization, meta element creation, internal linking, keyword mapping, editor, performance analysis, headline generator, CRO analyst, landing page optimizer\n- **Marketing Skills**: 26 marketing skills for copywriting, CRO, A\u002FB testing, email sequences, pricing strategy, and more\n- **Advanced SEO Analysis**: Search intent detection, keyword density & clustering, content length comparison, readability scoring, SEO quality rating (0-100)\n- **Data Integrations**: Google Analytics 4, Google Search Console, DataForSEO for real-time performance insights\n- **Context-Driven**: Brand voice, style guide, SEO guidelines, and examples guide all content\n- **Workflow Organization**: Structured directories for topics, research, drafts, and published content\n\n## Getting Started\n\n### Prerequisites\n- [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code) installed\n- Anthropic API account\n\n### Installation\n\n1. Clone this repository:\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FTheCraigHewitt\u002Fseomachine.git\ncd seomachine\n```\n\n2. Install Python dependencies for analysis modules:\n```bash\npip install -r data_sources\u002Frequirements.txt\n```\n\nThis installs:\n- Google Analytics\u002FSearch Console integrations\n- DataForSEO API client\n- NLP libraries (nltk, textstat)\n- Machine learning (scikit-learn)\n- Web scraping tools (beautifulsoup4)\n\n3. Open in Claude Code:\n```bash\nclaude-code .\n```\n\n4. **Customize Context Files** (Important!):\n\n   All context files are provided as templates. Fill them out with your company's information:\n\n   - `context\u002Fbrand-voice.md` - Define your brand voice and messaging *(see examples\u002Fcastos\u002F for reference)*\n   - `context\u002Fwriting-examples.md` - Add 3-5 exemplary blog posts from your site\n   - `context\u002Ffeatures.md` - List your product\u002Fservice features and benefits\n   - `context\u002Finternal-links-map.md` - Map your key pages for internal linking\n   - `context\u002Fstyle-guide.md` - Fill in your style preferences\n   - `context\u002Ftarget-keywords.md` - Add your keyword research and topic clusters\n   - `context\u002Fcompetitor-analysis.md` - Add competitor analysis and insights\n   - `context\u002Fseo-guidelines.md` - Review and adjust SEO requirements\n\n   **Quick Start**: Check out `examples\u002Fcastos\u002F` to see a complete real-world example of all context files filled out for a podcast hosting SaaS company.\n\n## Workflows\n\n### Creating New Content\n\n#### 1. Start with Research\n```\n\u002Fresearch [topic]\n```\n\n**What it does**:\n- Performs keyword research\n- Analyzes top 10 competitors\n- Identifies content gaps\n- Creates comprehensive research brief\n- Saves to `\u002Fresearch\u002F` directory\n\n**Example**:\n```\n\u002Fresearch content marketing strategies for B2B SaaS\n```\n\n#### 2. Write the Article\n```\n\u002Fwrite [topic or research brief]\n```\n\n**What it does**:\n- Creates 2000-3000+ word SEO-optimized article\n- Maintains your brand voice from `context\u002Fbrand-voice.md`\n- Integrates keywords naturally\n- Includes internal and external links\n- Provides meta elements (title, description, keywords)\n- Automatically triggers optimization agents\n- Saves to `\u002Fdrafts\u002F` directory\n\n**Example**:\n```\n\u002Fwrite content marketing strategies for B2B SaaS\n```\n\n**Agent Auto-Execution**:\nAfter writing, these agents automatically analyze the content:\n- **SEO Optimizer**: On-page SEO recommendations\n- **Meta Creator**: Multiple meta title\u002Fdescription options\n- **Internal Linker**: Specific internal linking suggestions\n- **Keyword Mapper**: Keyword placement and density analysis\n\n#### 3. Final Optimization\n```\n\u002Foptimize [article file]\n```\n\n**What it does**:\n- Comprehensive SEO audit\n- Validates all elements meet requirements\n- Provides final polish recommendations\n- Generates publishing readiness score\n- Creates optimization report\n\n**Example**:\n```\n\u002Foptimize drafts\u002Fcontent-marketing-strategies-2025-10-29.md\n```\n\n### Updating Existing Content\n\n#### 1. Analyze Existing Post\n```\n\u002Fanalyze-existing [URL or file path]\n```\n\n**What it does**:\n- Fetches and analyzes current content\n- Evaluates SEO performance\n- Identifies outdated information\n- Assesses competitive positioning\n- Provides content health score (0-100)\n- Recommends update priority and scope\n- Saves analysis to `\u002Fresearch\u002F` directory\n\n**Examples**:\n```\n\u002Fanalyze-existing https:\u002F\u002Fyoursite.com\u002Fblog\u002Fmarketing-guide\n\u002Fanalyze-existing published\u002Fmarketing-guide-2024-01-15.md\n```\n\n#### 2. Rewrite\u002FUpdate Content\n```\n\u002Frewrite [topic or analysis file]\n```\n\n**What it does**:\n- Updates content based on analysis findings\n- Refreshes statistics and examples\n- Improves SEO optimization\n- Adds new sections to fill gaps\n- Maintains what works from original\n- Tracks changes made\n- Saves to `\u002Frewrites\u002F` directory\n\n**Example**:\n```\n\u002Frewrite marketing guide\n```\n\n## Commands Reference\n\n### `\u002Fresearch [topic]`\nComprehensive keyword and competitive research for new content.\n\n**Output**: Research brief in `\u002Fresearch\u002Fbrief-[topic]-[date].md`\n\n**Includes**:\n- Primary and secondary keywords\n- Competitor analysis (top 10)\n- Content gaps and opportunities\n- Recommended outline\n- Internal linking strategy\n- Meta elements preview\n\n---\n\n### `\u002Fwrite [topic]`\nCreate long-form SEO-optimized article (2000-3000+ words).\n\n**Output**: Article in `\u002Fdrafts\u002F[topic]-[date].md`\n\n**Includes**:\n- Complete article with H1\u002FH2\u002FH3 structure\n- SEO-optimized content\n- Internal and external links\n- Meta elements (title, description, keywords)\n- SEO checklist\n\n**Auto-Triggers**:\n- SEO Optimizer agent\n- Meta Creator agent\n- Internal Linker agent\n- Keyword Mapper agent\n\n---\n\n### `\u002Frewrite [topic]`\nUpdate and improve existing content.\n\n**Output**: Updated article in `\u002Frewrites\u002F[topic]-rewrite-[date].md`\n\n**Includes**:\n- Rewritten\u002Fupdated content\n- Change summary\n- Before\u002Fafter comparison\n- Updated SEO elements\n\n---\n\n### `\u002Fanalyze-existing [URL or file]`\nAnalyze existing blog posts for improvement opportunities.\n\n**Output**: Analysis report in `\u002Fresearch\u002Fanalysis-[topic]-[date].md`\n\n**Includes**:\n- Content health score (0-100)\n- Quick wins (immediate improvements)\n- Strategic improvements\n- Rewrite priority and scope\n- Research brief for rewrite\n\n---\n\n### `\u002Foptimize [file]`\nFinal SEO optimization pass before publishing.\n\n**Output**: Optimization report in `\u002Fdrafts\u002Foptimization-report-[topic]-[date].md`\n\n**Includes**:\n- SEO score (0-100)\n- Priority fixes\n- Quick wins\n- Meta element options\n- Link enhancement suggestions\n- Publishing readiness assessment\n\n---\n\n### `\u002Fpublish-draft [file]`\nPublish article to WordPress via REST API with Yoast SEO metadata.\n\n---\n\n### `\u002Farticle [topic]`\nSimplified article creation workflow.\n\n---\n\n### `\u002Fpriorities`\nContent prioritization matrix using analytics data to identify highest-impact content tasks.\n\n---\n\n### `\u002Fscrub [file]`\nRemove AI watermarks and patterns from content (em-dashes, filler phrases, robotic patterns).\n\n---\n\n### Research Commands\n\n| Command | Description |\n|---------|-------------|\n| `\u002Fresearch-serp [keyword]` | SERP analysis for a target keyword |\n| `\u002Fresearch-gaps` | Competitor content gap analysis |\n| `\u002Fresearch-trending` | Trending topic opportunities |\n| `\u002Fresearch-performance` | Performance-based content priorities |\n| `\u002Fresearch-topics` | Topic cluster research |\n\n---\n\n### Landing Page Commands\n\n| Command | Description |\n|---------|-------------|\n| `\u002Flanding-write [topic]` | Create conversion-optimized landing page |\n| `\u002Flanding-audit [file]` | Audit landing page for CRO issues |\n| `\u002Flanding-research [topic]` | Research competitors and positioning |\n| `\u002Flanding-competitor [URL]` | Deep competitor landing page analysis |\n| `\u002Flanding-publish [file]` | Publish landing page to WordPress |\n\n## Agents\n\nSpecialized agents that automatically analyze content and provide expert recommendations.\n\n### Content Analyzer (NEW!)\n**Purpose**: Comprehensive, data-driven content analysis using 5 specialized modules\n\n**Analyzes**:\n- Search intent classification (informational\u002Fnavigational\u002Ftransactional\u002Fcommercial)\n- Keyword density and clustering with topic detection\n- Content length comparison vs top SERP competitors\n- Readability scoring (Flesch Reading Ease, Flesch-Kincaid Grade Level)\n- SEO quality rating (0-100 score with category breakdowns)\n- Keyword stuffing risk detection\n- Passive voice ratio and sentence complexity\n- Distribution heatmap showing keyword placement by section\n\n**Output**:\n- Executive summary with publishing readiness assessment\n- Priority action plan (critical\u002Fhigh priority\u002Foptimization)\n- Competitive positioning analysis\n- Detailed recommendations for each analysis area\n- Exact metrics and benchmarks for improvements\n\n**Powered by**:\n- `search_intent_analyzer.py` - Search intent detection\n- `keyword_analyzer.py` - Keyword density, clustering, LSI keywords\n- `content_length_comparator.py` - SERP competitor analysis\n- `readability_scorer.py` - Multiple readability metrics\n- `seo_quality_rater.py` - Comprehensive SEO scoring\n\n---\n\n### SEO Optimizer\n**Purpose**: On-page SEO analysis and optimization recommendations\n\n**Analyzes**:\n- Keyword optimization and density\n- Content structure and headings\n- Internal and external links\n- Meta elements\n- Readability and user experience\n- Featured snippet opportunities\n\n**Output**: SEO score (0-100) with specific improvement recommendations\n\n---\n\n### Meta Creator\n**Purpose**: Generate high-converting meta titles and descriptions\n\n**Creates**:\n- 5 meta title variations (50-60 chars)\n- 5 meta description variations (150-160 chars)\n- Testing recommendations\n- SERP preview\n- Conversion-optimized copy\n\n**Output**: Multiple options with recommendation and reasoning\n\n---\n\n### Internal Linker\n**Purpose**: Strategic internal linking recommendations\n\n**Provides**:\n- 3-5 specific internal link suggestions\n- Exact placement locations\n- Anchor text recommendations\n- User journey mapping\n- SEO impact prediction\n\n**References**: `context\u002Finternal-links-map.md`\n\n---\n\n### Keyword Mapper\n**Purpose**: Keyword placement and integration analysis\n\n**Analyzes**:\n- Keyword density and distribution\n- Critical placement checklist\n- Natural language integration quality\n- LSI keyword coverage\n- Cannibalization risk\n\n**Output**: Distribution map, gap analysis, specific revision suggestions\n\n---\n\n### Editor\n**Purpose**: Transform technically accurate content into human-sounding, engaging articles\n\n**Analyzes**:\n- Voice and personality\n- Specificity of examples\n- Readability and flow\n- Robotic vs. human patterns\n- Engagement and storytelling\n\n**Provides**:\n- Humanity score (0-100)\n- Critical edits with before\u002Fafter\n- Pattern analysis\n- Specific rewrites to inject personality\n- Readability improvements\n\n**Output**: Editorial report with specific improvements to make content sound human\n\n---\n\n### Performance\n**Purpose**: Data-driven content prioritization using real analytics\n\n**Analyzes**:\n- Google Analytics traffic and trends\n- Google Search Console rankings and CTR\n- DataForSEO competitive data\n- Quick wins (position 11-20)\n- Declining content\n- Low CTR opportunities\n- Trending topics\n\n**Provides**:\n- Priority queue of content tasks\n- Opportunity scores (0-100)\n- Impact and effort estimates\n- Week-by-week roadmap\n- Success metrics\n\n**Output**: Comprehensive performance report with actionable priorities\n\n---\n\n### Headline Generator\n**Purpose**: Generate high-converting headline variations and A\u002FB testing recommendations\n\n**Provides**:\n- 10+ headline variations using proven formulas\n- Conversion potential scoring\n- A\u002FB testing strategies\n- Audience-specific headline options\n\n---\n\n### CRO Analyst\n**Purpose**: Conversion rate optimization analysis for landing pages\n\n**Analyzes**:\n- Above-the-fold effectiveness\n- CTA quality and distribution\n- Trust signal presence\n- Friction points\n- Page structure\n\n---\n\n### Landing Page Optimizer\n**Purpose**: Comprehensive landing page optimization recommendations\n\n**Provides**:\n- CRO scoring (0-100) with category breakdowns\n- Above-fold, CTA, trust signal, structure, and SEO analysis\n- A\u002FB testing recommendations\n- Priority action list\n\n## Marketing Skills\n\nSEO Machine includes 26 marketing skills accessible as slash commands:\n\n| Category | Skills |\n|----------|--------|\n| **Copywriting** | `\u002Fcopywriting`, `\u002Fcopy-editing` |\n| **CRO** | `\u002Fpage-cro`, `\u002Fform-cro`, `\u002Fsignup-flow-cro`, `\u002Fonboarding-cro`, `\u002Fpopup-cro`, `\u002Fpaywall-upgrade-cro` |\n| **Strategy** | `\u002Fcontent-strategy`, `\u002Fpricing-strategy`, `\u002Flaunch-strategy`, `\u002Fmarketing-ideas` |\n| **Channels** | `\u002Femail-sequence`, `\u002Fsocial-content`, `\u002Fpaid-ads` |\n| **SEO** | `\u002Fseo-audit`, `\u002Fschema-markup`, `\u002Fprogrammatic-seo`, `\u002Fcompetitor-alternatives` |\n| **Analytics** | `\u002Fanalytics-tracking`, `\u002Fab-test-setup` |\n| **Other** | `\u002Freferral-program`, `\u002Ffree-tool-strategy`, `\u002Fmarketing-psychology` |\n\n## Data Sources\n\n### Integration with Analytics\n\nSEO Machine integrates with real-time data sources to inform content strategy:\n\n**Google Analytics 4**:\n- Traffic and engagement metrics\n- Conversion tracking\n- Trend analysis\n- Traffic sources\n\n**Google Search Console**:\n- Keyword rankings and positions\n- Impressions and clicks\n- CTR analysis\n- Query performance\n\n**DataForSEO**:\n- Competitive rankings\n- SERP features\n- Keyword metrics\n- Competitor gap analysis\n\n### Advanced SEO Analysis Modules (NEW!)\n\nSEO Machine includes 5 specialized Python modules for comprehensive content analysis:\n\n**Search Intent Analyzer** (`search_intent_analyzer.py`):\n- Classifies queries into informational, navigational, transactional, or commercial intent\n- Analyzes SERP features and content patterns\n- Provides confidence scores and content alignment recommendations\n\n**Keyword Analyzer** (`keyword_analyzer.py`):\n- Calculates exact keyword density and distribution\n- Detects keyword stuffing risk with warnings\n- Performs topic clustering using TF-IDF and K-means\n- Generates distribution heatmap by section\n- Identifies LSI (semantically related) keywords\n\n**SEO Quality Rater** (`seo_quality_rater.py`):\n- Rates content against SEO best practices (0-100 score)\n- Category breakdowns: content, keywords, meta, structure, links, readability\n- Identifies critical issues, warnings, and suggestions\n- Determines publishing readiness\n\n**Content Length Comparator** (`content_length_comparator.py`):\n- Fetches and analyzes top 10-20 SERP competitor word counts\n- Calculates median, 75th percentile, and optimal length\n- Shows competitive positioning and gap to target\n- Provides data-driven expansion recommendations\n\n**Readability Scorer** (`readability_scorer.py`):\n- Flesch Reading Ease and Flesch-Kincaid Grade Level\n- Sentence and paragraph structure analysis\n- Passive voice detection and ratio calculation\n- Complex word identification\n- Transition word usage analysis\n- Overall readability score (0-100)\n\nAll modules can be used directly in Python or through the Content Analyzer agent.\n\n### CRO Analysis Modules\n\nSix Python modules for landing page conversion optimization:\n\n- `above_fold_analyzer.py` - Above-the-fold content analysis (headline, value prop, CTA, trust)\n- `cta_analyzer.py` - CTA effectiveness scoring (quality, distribution, goal alignment)\n- `trust_signal_analyzer.py` - Trust signal detection (testimonials, social proof, risk reversals)\n- `landing_page_scorer.py` - Overall landing page scoring (0-100 with category breakdowns)\n- `landing_performance.py` - Landing page performance tracking via GA4\u002FGSC\n- `cro_checker.py` - CRO best practices checklist validation\n\n### Additional Analysis Modules\n\n- `opportunity_scorer.py` - 8-factor opportunity scoring for content prioritization\n- `content_scorer.py` - 5-dimension content quality scoring (humanity, specificity, structure, SEO, readability)\n- `engagement_analyzer.py` - Content engagement pattern analysis\n- `competitor_gap_analyzer.py` - Competitive content gap identification\n- `article_planner.py` - Data-driven article planning\n- `section_writer.py` - Section-level content guidance\n- `social_research_aggregator.py` - Social media research aggregation\n\n### Python Research Scripts\n\nRun from repo root:\n\n```bash\n# Content research\npython3 research_quick_wins.py\npython3 research_competitor_gaps.py\npython3 research_performance_matrix.py\npython3 research_priorities_comprehensive.py\npython3 research_serp_analysis.py\npython3 research_topic_clusters.py\npython3 research_trending.py\n\n# SEO analysis (config-driven - set up config\u002Fcompetitors.json first)\npython3 seo_baseline_analysis.py\npython3 seo_bofu_rankings.py\npython3 seo_competitor_analysis.py\n\n# Test API connectivity\npython3 test_dataforseo.py\n```\n\n**Note**: SEO analysis scripts load competitor lists and keywords from `config\u002Fcompetitors.json`. Copy `config\u002Fcompetitors.example.json` and customize for your business.\n\n### WordPress Integration\n\nPublishing uses the WordPress REST API with a custom MU-plugin that exposes Yoast SEO fields.\n\n**Setup**:\n1. Install `wordpress\u002Fseo-machine-yoast-rest.php` as an MU-plugin on your WordPress site\n2. Add `wordpress\u002Ffunctions-snippet.php` to your theme's functions.php\n3. Configure WordPress credentials in `.env`:\n   ```\n   WP_URL=https:\u002F\u002Fyoursite.com\n   WP_USERNAME=your_username\n   WP_APP_PASSWORD=your_application_password\n   ```\n\nSee `wordpress\u002FREADME.md` for detailed setup instructions.\n\nSee `data_sources\u002FREADME.md` for analytics setup instructions.\n\n## Directory Structure\n\n```\nseomachine\u002F\n├── .claude\u002F\n│   ├── commands\u002F          # Custom workflow commands\n│   │   ├── analyze-existing.md\n│   │   ├── research.md\n│   │   ├── write.md\n│   │   ├── rewrite.md\n│   │   ├── optimize.md\n│   │   ├── scrub.md\n│   │   ├── performance-review.md\n│   │   ├── publish-draft.md\n│   │   ├── article.md\n│   │   ├── priorities.md\n│   │   ├── research-serp.md\n│   │   ├── research-gaps.md\n│   │   ├── research-trending.md\n│   │   ├── research-performance.md\n│   │   ├── research-topics.md\n│   │   ├── landing-write.md\n│   │   ├── landing-audit.md\n│   │   ├── landing-research.md\n│   │   ├── landing-competitor.md\n│   │   └── landing-publish.md\n│   ├── agents\u002F            # Specialized analysis agents\n│   │   ├── content-analyzer.md\n│   │   ├── seo-optimizer.md\n│   │   ├── meta-creator.md\n│   │   ├── internal-linker.md\n│   │   ├── keyword-mapper.md\n│   │   ├── editor.md\n│   │   ├── performance.md\n│   │   ├── headline-generator.md\n│   │   ├── cro-analyst.md\n│   │   └── landing-page-optimizer.md\n│   └── skills\u002F            # 26 marketing skills\n├── data_sources\u002F          # Analytics integrations\n│   ├── modules\u002F          # Python analysis modules\n│   │   ├── google_analytics.py\n│   │   ├── google_search_console.py\n│   │   ├── dataforseo.py\n│   │   ├── data_aggregator.py\n│   │   ├── search_intent_analyzer.py\n│   │   ├── keyword_analyzer.py\n│   │   ├── seo_quality_rater.py\n│   │   ├── content_length_comparator.py\n│   │   ├── readability_scorer.py\n│   │   ├── opportunity_scorer.py\n│   │   ├── content_scorer.py\n│   │   ├── engagement_analyzer.py\n│   │   ├── social_research_aggregator.py\n│   │   ├── competitor_gap_analyzer.py\n│   │   ├── article_planner.py\n│   │   ├── section_writer.py\n│   │   ├── wordpress_publisher.py\n│   │   ├── above_fold_analyzer.py\n│   │   ├── cro_checker.py\n│   │   ├── cta_analyzer.py\n│   │   ├── landing_page_scorer.py\n│   │   ├── landing_performance.py\n│   │   └── trust_signal_analyzer.py\n│   ├── config\u002F           # API credentials (not in git)\n│   ├── utils\u002F            # Helper functions\n│   ├── cache\u002F            # Cached API responses\n│   └── README.md         # Setup instructions\n├── config\u002F                # Configuration files\n│   └── competitors.example.json  # Competitor config template\n├── context\u002F               # Configuration and guidelines\n│   ├── brand-voice.md\n│   ├── writing-examples.md\n│   ├── style-guide.md\n│   ├── seo-guidelines.md\n│   ├── target-keywords.md\n│   ├── internal-links-map.md\n│   ├── competitor-analysis.md\n│   └── cro-best-practices.md\n├── wordpress\u002F             # WordPress integration\n│   ├── seo-machine-yoast-rest.php\n│   ├── functions-snippet.php\n│   └── README.md\n├── topics\u002F                # Raw topic ideas\n├── research\u002F              # Research briefs and analysis reports\n├── drafts\u002F                # Work in progress articles\n├── review-required\u002F       # Articles pending review\n├── published\u002F             # Final versions ready to publish\n├── rewrites\u002F              # Updated existing content\n├── landing-pages\u002F         # Landing page content\n├── audits\u002F                # Audit reports\n└── README.md              # This file\n```\n\n## Context Files (Important!)\n\nThe quality of your content depends on well-configured context files:\n\n### `context\u002Fbrand-voice.md`\nDefines your brand voice, tone, and messaging framework.\n\n**Must include**:\n- Voice pillars\n- Tone guidelines by content type\n- Core brand messages\n- Writing style guidelines\n- Terminology preferences\n\n**Purpose**: Ensures all content sounds like your brand\n\n---\n\n### `context\u002Fwriting-examples.md`\nContains 3-5 exemplary blog posts from your site.\n\n**Must include**:\n- Full article content\n- What makes each example great\n- Key takeaways for voice and structure\n\n**Purpose**: Teaches AI your specific writing style through examples\n\n---\n\n### `context\u002Fstyle-guide.md`\nEditorial and formatting standards.\n\n**Must include**:\n- Grammar and mechanics rules\n- Capitalization conventions\n- Formatting standards\n- Preferred terminology\n\n**Purpose**: Maintains consistency across all content\n\n---\n\n### `context\u002Fseo-guidelines.md`\nSEO best practices and requirements.\n\n**Includes**:\n- Content length requirements\n- Keyword optimization rules\n- Meta element standards\n- Link strategy guidelines\n- Readability requirements\n\n**Purpose**: Ensures all content meets SEO standards\n\n---\n\n### `context\u002Ftarget-keywords.md`\nKeyword research organized by topic cluster.\n\n**Must include**:\n- Pillar keywords by cluster\n- Cluster keywords (subtopics)\n- Long-tail variations\n- Search intent classification\n- Current rankings\n\n**Purpose**: Guides keyword targeting for new content\n\n---\n\n### `context\u002Finternal-links-map.md`\nCatalog of key pages from your site for internal linking.\n\n**Must include**:\n- Product pages and features\n- Pillar content URLs\n- Top performing blog articles\n- Topic cluster mapping\n- Recommended anchor text\n\n**Purpose**: Enables strategic internal linking in every article\n\n---\n\n### `context\u002Fcompetitor-analysis.md`\nCompetitive intelligence and content gaps.\n\n**Must include**:\n- Primary competitors\n- Their content strategies\n- Keyword gaps\n- Differentiation opportunities\n\n**Purpose**: Informs content strategy and competitive positioning\n\n## Content Quality Standards\n\nEvery article must meet these requirements:\n\n### Content\n- [ ] Minimum 2,000 words (2,500-3,000+ preferred)\n- [ ] Provides unique value vs. competitors\n- [ ] Factually accurate and current\n- [ ] Actionable advice for your target audience\n- [ ] Brand voice maintained\n\n### SEO\n- [ ] Primary keyword density 1-2%\n- [ ] Keyword in H1, first 100 words, 2-3 H2s\n- [ ] 3-5 internal links with descriptive anchor text\n- [ ] 2-3 external authority links\n- [ ] Meta title 50-60 characters\n- [ ] Meta description 150-160 characters\n- [ ] Proper H1>H2>H3 hierarchy\n\n### Readability\n- [ ] 8th-10th grade reading level\n- [ ] Average sentence length 15-20 words\n- [ ] Paragraphs 2-4 sentences\n- [ ] Subheadings every 300-400 words\n- [ ] Lists and formatting for scannability\n\n### Structure\n- [ ] Compelling introduction (hook, problem, promise)\n- [ ] Logical section flow\n- [ ] Clear conclusion with CTA\n- [ ] Examples and data included\n\n## Best Practices\n\n### Before Writing\n1. **Research first**: Always run `\u002Fresearch` before `\u002Fwrite`\n2. **Review context**: Read `brand-voice.md` and relevant `writing-examples.md`\n3. **Check keywords**: Verify target keyword in `target-keywords.md`\n4. **Plan internal links**: Review `internal-links-map.md` for linking opportunities\n\n### During Writing\n1. **Follow the brief**: Use research brief as your outline\n2. **Natural keywords**: Integrate keywords naturally, never force them\n3. **Add value**: Every section should provide actionable insights\n4. **Use examples**: Include real scenarios and use cases from your industry\n5. **Cite sources**: Link to statistics and data sources\n\n### After Writing\n1. **Review agent output**: Read all agent recommendations carefully\n2. **Make improvements**: Address high-priority issues before optimizing\n3. **Run optimize**: Use `\u002Foptimize` for final polish\n4. **Self-edit**: Read article as if you're the target reader\n5. **Check quality**: Verify all checklist items met\n\n### For Rewrites\n1. **Analyze first**: Run `\u002Fanalyze-existing` to understand scope\n2. **Determine strategy**: Light update vs. major rewrite?\n3. **Preserve what works**: Keep effective sections\n4. **Focus on gaps**: Add what's missing from competitive content\n5. **Update everything**: Stats, examples, screenshots, links\n\n## Workflow Examples\n\n### Example 1: Creating New Content from Scratch\n\n```\n# Step 1: Add topic idea\n# Create file in topics\u002F directory with initial thoughts\n\n# Step 2: Research the topic\n\u002Fresearch content marketing strategies\n\n# Step 3: Review research brief\n# Read research\u002Fbrief-content-marketing-strategies-[date].md\n\n# Step 4: Write article\n\u002Fwrite content marketing strategies\n\n# Step 5: Review agent feedback\n# Read all agent reports in drafts\u002F\n\n# Step 6: Make improvements\n# Edit article based on agent recommendations\n\n# Step 7: Final optimization\n\u002Foptimize drafts\u002Fcontent-marketing-strategies-[date].md\n\n# Step 8: Publish to WordPress (optional)\n\u002Fpublish-draft drafts\u002Fcontent-marketing-strategies-[date].md\n```\n\n### Example 2: Updating Existing Content\n\n```\n# Step 1: Analyze existing post\n\u002Fanalyze-existing https:\u002F\u002Fyoursite.com\u002Fblog\u002Fproduct-comparison\n\n# Step 2: Review analysis\n# Read research\u002Fanalysis-product-comparison-2025-10-29.md\n# Check content health score and priority level\n\n# Step 3: Rewrite content\n\u002Frewrite product comparison\n\n# Step 4: Review changes\n# Read rewrites\u002Fproduct-comparison-rewrite-2025-10-29.md\n# Review change summary\n\n# Step 5: Optimize\n\u002Foptimize rewrites\u002Fproduct-comparison-rewrite-2025-10-29.md\n\n# Step 6: Publish\n# Move to published\u002F when ready\n```\n\n### Example 3: Quick Content Audit\n\n```\n# Analyze multiple existing posts to prioritize updates\n\u002Fanalyze-existing https:\u002F\u002Fyoursite.com\u002Fblog\u002Fpost-1\n\u002Fanalyze-existing https:\u002F\u002Fyoursite.com\u002Fblog\u002Fpost-2\n\u002Fanalyze-existing https:\u002F\u002Fyoursite.com\u002Fblog\u002Fpost-3\n\n# Review content health scores\n# Prioritize rewrites based on:\n# - Lowest scores\n# - Highest traffic potential\n# - Strategic importance\n```\n\n## Tips & Tricks\n\n### Maximizing Content Quality\n- **Study examples**: Read your `writing-examples.md` before each writing session\n- **Use data**: Always include current statistics and cite sources\n- **Be specific**: \"40% increase\" beats \"significant improvement\"\n- **Show, don't tell**: Use real examples and scenarios from your industry\n- **Answer questions**: Address \"People Also Ask\" questions from research\n\n### SEO Optimization\n- **Keywords early**: Get primary keyword in first 100 words\n- **Natural integration**: Read content aloud - if keywords sound forced, rewrite\n- **Vary anchor text**: Don't use same anchor text for all internal links\n- **Link strategically**: Link to pillar content and related cluster articles\n- **Update regularly**: Refresh top-performing content every 6-12 months\n\n### Workflow Efficiency\n- **Batch research**: Research multiple topics in one session\n- **Follow structure**: Use consistent article structure from `\u002Fwrite` command\n- **Address high-priority first**: Fix critical issues before optimizing details\n- **Use agents wisely**: Let agents handle analysis, you focus on writing\n- **Build templates**: Save commonly used sections for reuse\n\n### Avoiding Common Mistakes\n- ❌ Skipping research phase\n- ❌ Ignoring brand voice guidelines\n- ❌ Forcing keywords unnaturally\n- ❌ Forgetting internal links\n- ❌ Not citing data sources\n- ❌ Publishing without optimization\n- ❌ Copying competitor content instead of differentiating\n\n## Maintenance\n\n### Weekly\n- Add new topic ideas to `\u002Ftopics\u002F`\n- Update `target-keywords.md` with new keyword opportunities\n- Check for broken links in `internal-links-map.md`\n\n### Monthly\n- Review published content performance\n- Update `writing-examples.md` if better examples emerge\n- Add newly published content to `internal-links-map.md`\n- Track competitor activity in `competitor-analysis.md`\n\n### Quarterly\n- Full audit of context files\n- Update SEO guidelines based on algorithm changes\n- Comprehensive competitor analysis refresh\n- Review and update topic clusters in `target-keywords.md`\n\n## Troubleshooting\n\n### \"Content doesn't sound like my brand\"\n- **Solution**: Update `context\u002Fbrand-voice.md` with more specific guidance\n- **Solution**: Add more diverse examples to `context\u002Fwriting-examples.md`\n- **Solution**: Reference specific examples when using `\u002Fwrite` command\n\n### \"Keyword density too high\u002Flow\"\n- **Solution**: Review `seo-guidelines.md` target density (1-2%)\n- **Solution**: Use `\u002Foptimize` to get specific keyword placement suggestions\n- **Solution**: Use Keyword Mapper agent for distribution analysis\n\n### \"Internal links aren't relevant\"\n- **Solution**: Update `context\u002Finternal-links-map.md` with current pages\n- **Solution**: Organize by topic cluster for easier agent matching\n- **Solution**: Provide more context about what each page covers\n\n### \"Articles too similar to competitors\"\n- **Solution**: Update `competitor-analysis.md` with differentiation opportunities\n- **Solution**: Add your unique advantages to `brand-voice.md` and `features.md`\n- **Solution**: Reference specific differentiation angles in `\u002Fresearch` command\n\n## Support & Contributions\n\n### Getting Help\n- Review this README thoroughly\n- Check context files are properly configured\n- Consult [Claude Code documentation](https:\u002F\u002Fdocs.claude.com\u002Fclaude-code)\n\n### Contributing\n- Report issues via GitHub Issues\n- Suggest improvements to commands or agents\n- Share successful workflows or tips\n\n## License\n\n[Add your license information]\n\n## Credits\n\nBuilt with [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code) by Anthropic.\n\nOriginally developed for Castos, now available as an open-source tool for any business to streamline long-form SEO content creation.\n\n## Examples & Community\n\n**See It In Action**: Check out `examples\u002Fcastos\u002F` for a complete real-world example of how a podcast hosting SaaS company uses SEO Machine.\n\n**Contributions Welcome**: Found a bug? Have a feature request? Want to share your own industry example? Contributions and PRs are welcome!\n\n---\n\n**Ready to start creating?**\n\n1. Configure your context files (use the templates as your guide)\n2. Run `\u002Fresearch [your topic]`\n3. Review the brief\n4. Run `\u002Fwrite [your topic]`\n5. Publish amazing content!\n\nHappy writing! 📝\n","SEO Machine 是一个专为创建长篇、SEO 优化的博客内容而设计的 Claude Code 工作空间，适用于任何业务。它提供了一系列自定义命令和专业代理，如内容分析器、SEO 优化器、元元素创建器等，帮助用户进行研究、撰写、分析和优化内容，以提高搜索引擎排名并更好地服务目标受众。项目集成了26种营销技能，包括文案写作、CRO、A\u002FB测试等，并支持高级SEO分析功能，如搜索意图检测、关键词密度及聚类分析等。此外，SEO Machine 还能够与 Google Analytics 4、Google Search Console 和 DataForSEO 等数据源集成，提供实时性能洞察。适合需要提升在线可见度并通过高质量内容吸引潜在客户的公司或个人使用。",2,"2026-06-11 03:40:01","high_star"]