Generate comprehensive performance report Args: days: Days to analyze Returns: Complete performance

Generate action recommendation based on keyword data

Generate unified roadmap from all research results

Convert authority score to level

Get all categories as name->ID mapping

Get editing checklist for a section type. Args: section_type: The type of section being edited Returns:

Get landing page performance data Args: url: Landing page URL days: Lookback period conversion_goal: 'trial', 'demo'

Get category ID, creating if it doesn't exist

Get tag ID, creating if it doesn't exist

Get search performance for a specific page Args: url: Page URL or path days: Number of days to analyze

Get all tags as name->ID mapping

Get writing guidelines for a specific section type. Args: section_type: The type of section being written Retur

Check if title contains year or freshness signals

Check if keyword is branded/specific to the competitor

Determine if path is a content page (blog post/article)

Filter for relevant industry keywords. Override relevant_terms for your niche.

Load competitor lists from config file.

Load configuration from config file.

Load keyword configuration from config file.

Load keyword configuration from config file.

Main entry point for SERP analysis

Analyze all articles from today

CLI entry point for testing

CLI entry point for testing

Convert markdown to HTML for WordPress Args: markdown_content: Markdown formatted content Returns:

Parse a markdown draft file and extract metadata and content Args: file_path: Path to the markdown file Returns

Publish a draft file to WordPress as a post, page, or custom post type Args: file_path: Path to the markdown draft file

Rate content against SEO best practices Args: content: Article content meta_title: Meta title tag

Rate SEO quality of content Args: content: Article content meta_title: Meta title meta_description: Meta description

Score landing page against CRO best practices Args: content: Landing page content (markdown) meta_title: Met

Score content across all dimensions Args: content: Full article content (markdown) metadata: Optional dict w

Score a landing page against CRO best practices Args: content: Landing page content (markdown) page_type: 'seo' or 'ppc'

Score content readability Args: content: Article text to analyze Returns: Comprehensive readability analysis

Scrub content of all AI watermarks and telltale signs. Args: content: The text content to scrub Returns:

Set Yoast SEO meta fields on a post, page, or custom post type Requires the SEO Machine Yoast REST plugin to be installed: w

Test basic connection to DataForSEO API

Write detailed markdown report

Write detailed markdown report

Write detailed markdown report

Write detailed markdown report

Write detailed markdown report

Write detailed markdown report

Write unified roadmap report

Initialize GA4 client Args: property_id: GA4 property ID (defaults to env var GA4_PROPERTY_ID) credentials_p

Initialize GSC client Args: site_url: Site URL (e.g., "https://castos.com") credentials_path: Path to creden

Initialize SEO Quality Rater Args: guidelines: Custom SEO guidelines (defaults to standard best practices)

Initialize Landing Page Scorer Args: page_type: 'seo' or 'ppc' conversion_goal: 'trial', 'demo', or 'lead'

Initialize CRO Checker Args: page_type: 'seo' or 'ppc' conversion_goal: 'trial', 'demo', or 'lead'

Initialize CTA Analyzer Args: conversion_goal: 'trial', 'demo', or 'lead'

Initialize performance tracker

Initialize DataForSEO client Args: login: API login (defaults to env var) password: API password (defaults t

Initialize WordPress publisher Args: url: WordPress site URL (defaults to env var WORDPRESS_URL) username: W

Initialize all data source clients

Analyze presence of mini-stories with specific names

Analyze a single competitor's content for gaps. Args: content: The full text content of the competitor article

Categorize text into an insight type based on content. Args: text: The insight text to categorize Returns:

Get ranking history for a keyword (requires historical data) Args: domain: Your domain keyword: Keyword to t

Compare content length against SERP competitors Args: keyword: Target keyword your_word_count: Your content's word count

Compare multiple landing pages Args: urls: List of landing page URLs days: Lookback period conversion_goal: Conversi

Create a 'beat them' blueprint from multiple competitor analyses. Args: analyses: List of CompetitorAnalysis from analyz

Create a default article structure for common topics. This provides a starting point that should be modified based on competitor researc

Create an empty RedditResearch structure for initialization.

Create an empty YouTubeResearch structure for initialization.

Create a detailed plan for a single section. Args: section_number: Position in article (1-indexed) heading:

Format article plan as markdown. This generates the article-plan-[topic]-[date].md file.

Format an editing prompt for a section draft. This generates the prompt for the editing pass.

Format the analysis results as a markdown report. This is used to generate the serp-analysis-[topic]-[date].md file.

Format social research as a markdown report. This generates the social-research-[topic]-[date].md file.

Format a complete writing prompt for a section. This generates the prompt that guides section writing.

Get all available data for a specific page Args: url: Page path or full URL days: Days to analyze R

Get conversion data by page Args: days: Number of days to look back path_filter: Filter pages by path

Get domain overview metrics Args: domain: Domain to analyze Returns: Dict with domain metrics

Track keyword position changes Args: days_recent: Recent period days_comparison: Previous period to compare

Get PPC-specific landing page performance Args: url: Landing page URL days: Lookback period camp

Get prioritized list of content tasks Args: limit: Number of tasks to return Returns: Prioritized t

Get traffic source breakdown for a page or entire site Args: url: Specific page path (optional, None = all pages)

Plan where engagement elements should go. Args: num_sections: Total number of sections Returns: Eng

Scrub a file and optionally save to a new location. Args: file_path: Path to file to scrub output_path: Path to save cleaned

Combine Reddit and YouTube research into actionable synthesis. Args: reddit_research: Aggregated Reddit findings