Reference
The machinery underneath the skills. You will rarely call any of this directly — it is here so you can see what a skill is doing on your behalf.
Sub-agents (18)
Specialists a skill spawns in parallel. A full audit runs up to 15 at once, which is why it is much faster than running the equivalent checks one at a time.
| Agent | Role |
|---|---|
pro-seo-backlinks | Backlink profile analyst using free and paid sources. Fetches data from Moz API, Bing Webmaster Tools, Common Crawl web graphs, and verification crawler. Merges multi-source data with confidence-weighted scoring. |
pro-seo-cluster | Semantic topic clustering analysis using SERP overlap methodology. Expands seed keywords, performs pairwise SERP comparison, classifies intent, designs hub-and-spoke content architecture, and generates internal link matrices. |
pro-seo-content | Content quality reviewer. Evaluates E-E-A-T signals, readability, content depth, AI citation readiness, and thin content detection. |
pro-seo-dataforseo | DataForSEO data analyst. Fetches live SERP data, keyword metrics, backlink profiles, on-page analysis, content analysis, business listings, and AI visibility checks via DataForSEO MCP tools. |
pro-seo-drift | SEO drift analysis agent. Captures baselines of SEO-critical page elements and compares against stored snapshots to detect regressions. Reports changes with severity classification. Only spawned when a drift baseline exists for th |
pro-seo-ecommerce | E-commerce SEO analyst. Validates product schema, analyzes Google Shopping and Amazon marketplace visibility, identifies pricing gaps, and recommends product page optimizations. Spawned when e-commerce site detected during audits. |
pro-seo-flow | FLOW framework prompt analyst. Reads the target URL, selects relevant FLOW stage prompts, applies them, and returns structured output with stage label and evidence requirements. |
pro-seo-geo | GEO and AI search specialist. Analyzes AI crawler accessibility, llms.txt presence (optional; ignored by Google Search), passage-level citability, brand mention signals, and platform-specific optimization for Google AI Overviews, |
pro-seo-google | Google SEO API analyst. Fetches CWV field data via CrUX, indexation status via GSC, and organic traffic via GA4 for enriched audit data. |
pro-seo-image-gen | SEO image analyst. Audits existing OG/social preview images, identifies missing or low-quality images, and creates an image generation plan with prompts for key pages. Does NOT auto-generate images. |
pro-seo-local | Local SEO specialist. Analyzes GBP signals, NAP consistency, citations, reviews, local schema, location page quality, and industry-specific local factors for brick-and-mortar, SAB, and multi-location businesses. |
pro-seo-maps | Maps intelligence specialist. Geo-grid rank tracking, GBP profile auditing, review intelligence, cross-platform NAP verification, and competitor radius mapping via DataForSEO and free APIs. |
pro-seo-performance | Performance analyzer. Measures and evaluates Core Web Vitals and page load performance. |
pro-seo-schema | Schema markup expert. Detects, validates, and generates Schema.org structured data in JSON-LD format. |
pro-seo-sitemap | Sitemap architect. Validates XML sitemaps, generates new ones with industry templates, and enforces quality gates for location pages. |
pro-seo-sxo | Search Experience Optimization analyst. Performs SERP backwards analysis to detect page-type mismatches, derives user stories from intent signals, and scores pages from multiple persona perspectives. Identifies why well-optimized |
pro-seo-technical | Technical SEO specialist. Analyzes crawlability, indexability, security, URL structure, mobile optimization, Core Web Vitals, and JavaScript rendering. |
pro-seo-visual | Visual analyzer. Captures screenshots, tests mobile rendering, and analyzes above-the-fold content using Playwright. |
Python tools (53)
These do the fetching, parsing and API work, and run in an isolated virtualenv so they never
touch your system Python. Invoke via pro-seo run <script>.py.
| Script | Purpose |
|---|---|
agent_ux_check.py | Agent-friendly page auditor |
analyze_visual.py | Analyze visual aspects of a web page using Playwright |
backlinks_auth.py | Backlink API credential management for ProSEO |
bing_webmaster.py | Bing Webmaster Tools API client for ProSEO |
capture_screenshot.py | Capture screenshots of web pages using Playwright |
commoncrawl_graph.py | Common Crawl Web Graph parser for ProSEO |
consistency_check.py | Repository consistency checker: dead references, orphans, routing, lock integrity |
content_humanize.py | AI-pattern remover |
content_quality.py | QRG-aligned content quality detector |
content_verify.py | Claim extractor + citation-gap detector |
crux_history.py | CrUX History API for Core Web Vitals trends over time |
dataforseo_costs.py | DataForSEO API cost estimation, approval, and budget tracking |
dataforseo_merchant.py | Fetch Google Shopping and Amazon marketplace data via DataForSEO API |
dataforseo_normalize.py | Normalize DataForSEO API responses for consistent consumption by pro-seo skills |
domain_history.py | Expired-domain heritage check |
drift_baseline.py | Capture an SEO baseline snapshot of a page's critical elements |
drift_compare.py | Compare current page state to stored baseline and detect SEO drift |
drift_history.py | Query drift history for a URL from the SQLite database |
drift_report.py | Generate an HTML report for SEO drift comparison results |
fetch_page.py | Fetch a web page with proper headers and error handling |
ga4_report.py | GA4 Data API v1beta - organic traffic reporting |
gbp_deprecation_lint.py | GBP feature-deprecation linter |
google_auth.py | Google API credential management for ProSEO |
google_report.py | Google SEO Report Generator - Professional PDF/HTML reports from API data |
gsc_inspect.py | Google Search Console URL Inspection API helper |
gsc_query.py | Google Search Console Search Analytics query helper |
indexing_notify.py | Google Indexing API v3 - notify Google of URL updates and removals |
indexnow_submit.py | IndexNow submitter |
iptc_ai_label.py | IPTC ``DigitalSourceType`` audit + injection for AI-generated images |
keyword_planner.py | Google Ads API - Keyword Planner for SEO keyword research |
lcp_subparts.py | LCP subparts breakdown via CrUX API |
moz_api.py | Moz Link Explorer API client for ProSEO |
nlp_analyze.py | Google Cloud Natural Language API - Entity, sentiment, and content analysis |
pagespeed_check.py | PageSpeed Insights v5 + CrUX API combined checker |
parasite_risk.py | Parasite-SEO risk scanner |
parse_html.py | Parse HTML and extract SEO-relevant elements |
portability_check.py | Cross-platform portability lint for SKILL.md files |
preload_check.py | Speculation Rules / bfcache / prerender2 / preload detector |
release_sign.py | Generate a SHA-256 manifest of every git-tracked file in the repository |
render_page.py | Shared headless renderer for pro-seo |
runtime.py | Cross-platform runtime for ProSEO's bundled Python scripts |
schema_ecommerce_validate.py | Product schema validator focused on Google merchant-listing fields |
schema_generate.py | JSON-LD generators for the four high-leverage v2 Schema.org types: - Reservation (FoodEstablishmentReservation, etc.) - OrderAction (an "Order this" p |
seo_updates.py | Primary-source Google updates query tool |
sitemap_discovery.py | Discover sitemaps through robots.txt and common locations safely |
sync_flow.py | Sync Flow operational references from GitHub into the pro-seo-flow skill. |
ucp_check.py | UCP (Universal Commerce Protocol) profile auditor |
unlighthouse_run.py | Thin wrapper around the Unlighthouse CLI (https://unlighthouse.dev) |
url_safety.py | Canonical URL safety module for pro-seo |
validate_backlink_report.py | Backlink report validation for ProSEO |
verify_backlinks.py | Backlink verification crawler for ProSEO |
verify_release.py | Verify the integrity of a pro-seo checkout against a release manifest |
youtube_search.py | YouTube Data API v3 - Search, video details, and channel data for SEO |