Get keyword rankings and performance Args: days: Number of days to analyze limit: Max number of keywords to

Get complete SERP data for a keyword Args: keyword: Search keyword location_code: DataForSEO location code

Make POST request to DataForSEO API

Get ranking positions for specific keywords Args: domain: Your domain (e.g., "castos.com") keywords: List of

Get top performing pages by pageviews Args: days: Number of days to look back limit: Number of results to re

Analyze search intent of a keyword Args: keyword: The search query to analyze serp_features: List of SERP fe

Get related keyword ideas Args: seed_keyword: Starting keyword location_code: Location code limi

Get performance metrics for a single page path. Returns the exact path match when available, falling back to the first filtered resul

Find "quick win" opportunities - keywords ranking 11-20 These are closest to page 1 and easiest to improve. Args:

Analyze search intent for a keyword Args: keyword: Search query serp_features: SERP features from DataForSEO top_res

Calculate comprehensive opportunity score. Args: keyword_data: GSC data with position, impressions, clicks, ctr

Estimate expected monthly traffic based on position and impressions

Find queries gaining traction (rising impressions) Args: days_recent: Recent period to analyze days_comparis

Convert keyword to safe filename

Analyze a single keyword

Remove markdown formatting for text analysis

Guidelines for explanation/educational sections.

Generate actionable recommendations from opportunities Args: opportunities: Opportunities dict from identify_content_opp

Analyze CTAs in landing page content Args: content: Landing page content (markdown) Returns: Dict w

Calculate potential traffic increase from ranking improvement. Args: current_position: Current average position

Simple keyword clustering based on common terms

Extract domain from URL

Identify pages with declining traffic Args: comparison_days: Compare this many recent days vs previous period

Get comprehensive performance data for a landing page Args: url: Landing page URL (full URL or path) days: L

Find pages with high impressions but low CTR These need better titles/descriptions. Args: days: Number of days

Get traffic trends for a specific page Args: url: Page path (e.g., "/blog/podcast-monetization") days: Numbe

Get question-based queries related to keyword Args: keyword: Seed keyword location_code: Location code

Identify content opportunities across all data sources Returns: Dict with categorized opportunities

Convenience function to scrub content. Args: content: The text to scrub verbose: If True, print statistics Returns:

Analyze authority signals

Provide competitive analysis

Analyze text complexity indicators

Score based on top ranking content patterns

Analyze CTA presence above the fold

Analyze CTA distribution

Analyze CTA distribution throughout the page

Analyze the headline (H1)

Analyze opening hook quality

Score keyword based on pattern matching

Analyze paragraph lengths

Analyze sentence rhythm variety in prose sections only

Analyze risk reversal signals

Analyze how keyword is distributed across sections

Analyze security signals

Score based on SERP features present

Analyze social proof signals

Analyze content structure

Analyze landing page structure

Analyze content structure

Analyze testimonials

Analyze trust signal presence above the fold

Analyze value proposition presence and clarity

Calculate commercial intent score for a keyword Returns: Float between 0.1 (informational) and 3.0 (transactional)

Score based on ranking difficulty (0-100)

Score based on CTR improvement potential (0-100)

Score based on SERP freshness requirements (0-100)

Calculate letter grades for each metric category

Score based on commercial value (0-100)

Calculate readability metrics using textstat library

Calculate overall readability score (0-100)

Score based on proximity to target position (0-100)

Calculate overall trust signal score

Calculate statistical measures

Score based on search trend (0-100)

Score based on search demand (0-100)

Categorize competitor content by length ranges

Check if keyword appears in critical locations

Check CTA effectiveness

Check if CTAs align with conversion goal

Check headline best practices

Check objection handling

Check for paragraphs that exceed 4 sentences

Check risk reversal elements

Check for sentence length variety (rhythm)

Check social proof elements

Check page structure

Check urgency/scarcity elements (use sparingly)

Check value proposition clarity

Clean content for readability analysis

Clean up multiple spaces and normalize whitespace.

Guidelines for comparison sections.

Guidelines for conclusion sections.

Create a visual representation of keyword distribution

Default SEO guidelines based on industry standards

Detect potential keyword stuffing

Determine the best punctuation to replace an em-dash. Args: before: Text before the em-dash after: Text afte

Determine priority level based on score and type

Generate human-readable explanation of the score

Extract sections with headers from content

Extract H2/H3 sections with their content.

Guidelines for FAQ sections.

Fetch and count words from a URL

Find all CTAs in content