seomachine_skill

Overview

This skill is an SEO data platform that centralizes keyword research, rankings, traffic analysis, competitor gap discovery, content briefs, and performance reporting. It adapts to ad-hoc SEO research or integrated workflows via ready-to-run scripts and importable Python modules. Use it to turn analytics and SERP data into prioritized content and optimization tasks.

How this skill works

The skill wraps DataForSEO, Google Search Console, and GA4 connectors plus aggregation logic to collect keyword ideas, SERP features, ranking positions, page trends, and competitor data. Scripts generate reports and content briefs while modules expose methods for custom queries, clustering, intent classification, and content scoring. Credentials are read from environment variables so you can run analyses without embedding secrets.

When to use it

• When you need a weekly or on-demand SEO performance report for a domain
• To generate competitor-informed content briefs and recommended word counts
• To find keywords competitors rank for that your site is missing
• To identify quick wins (positions 11–20) and low-CTR pages to optimize
• When prioritizing a content refresh list based on GA4 traffic trends and GSC declines

Best practices

• Store API credentials in environment variables and never hardcode them
• Cache or batch DataForSEO calls to control API costs and speed up workflows
• Combine GSC quick-wins with GA4 declining pages for highest-impact tasks
• Use the DataAggregator to produce a single prioritized task queue before execution
• Validate recommended word counts and headings against target SERP competitors

Example use cases

• Run weekly_seo_report.py for an executive-ready markdown report summarizing priority keywords and week-over-week changes
• Create a content brief with content_brief_generator.py to produce H2/H3 outlines and FAQ suggestions informed by top SERP competitors
• Use competitor_gap_finder.py in batch to discover high-volume keywords your competitors rank for but you do not
• Call GoogleSearchConsole.get_quick_wins() and GoogleAnalytics.get_declining_pages() to assemble a short list of pages to update this sprint
• Import KeywordAnalyzer and SearchIntentAnalyzer to cluster keyword sets and shape targeted landing pages