🛡️ SEO SERP Analyzer (Content Gap Agent)

Beat your competitors by understanding exactly why they rank. Generates AI-powered Content Briefs based on real-time SERP data.

---

📉 The Problem: Guesswork Doesn't Rank

Writing SEO content blindly is a waste of time. To rank #1, you need to know:

• How long are the top results?
• What sub-topics (H2s) are they covering?
• What are they missing? (The Content Gap)

Doing this manually for every keyword takes hours of opening tabs, copy-pasting headers, and reading huge articles.

🚀 The Solution: Automated SEO Intelligence

The SEO SERP Analyzer automates the entire "Skyscraper Technique."

1. Scans the Top 10 Google/Brave results for your keyword.
2. Extracts the HTML structure (H1, H2s) and Word Counts.
3. Analyzes the data using GPT 5.1 / Gemini 3.1 to find patterns.
4. Generates a "Winning Content Brief" that tells you exactly what to write to beat them.

---

✨ Features

Feature	Description
🦁 Live SERP Data	Uses Brave Search API to fetch real-time organic rankings for any country (US, UK, ZA, etc.).
🏗️ Structure Scraping	Extracts H1 tags, H2 subheaders, and Word Counts to reveal competitor article structure.
🧠 AI Gap Analysis	Uses OpenAI (GPT-5.1) or Google (Gemini 3.1) to compare top results and identify missing topics competitors ignored.
📋 Strategic Brief	Outputs a ready-to-use Content Outline with recommended word counts and headers.
💰 Pay-Per-Event	Choose between Standard (Basic Audit) or Premium (Topic Clusters + JSON-LD Schema). Pay only for the depth you need.

---

💎 Analysis Modes

Mode	Features	Goal	Price
Standard	Gap Analysis, Outline, Word Counts	Quick Keyword Research	$0.99
Premium	Topic Clusters, JSON-LD Schema, Visual Strategy	Full Pillar Page Strategy	$2.49

---

🎯 Use Cases

✍️ For Content Writers

• Beat Writer's Block: Get a structured outline (H1, H2, H3) instantly.
• Hit Word Count Targets: Know exactly how long your article needs to be (e.g., "Competitors average 1,800 words").

🏢 For Marketing Agencies

• Scalable SEO: Generate briefs for 100 keywords in minutes, not days.
• Client Reporting: Export the "Competitor Data" table to show clients exactly who they are up against.

🕵️‍♂️ For Niche Site Builders

• Snipe Competitors: Find weak spots in top-ranking articles (e.g., "None of the top 10 results mention pricing—include a pricing section to win").

---

🛠️ Configuration

This Actor handles the APIs for you! No need to provide your own API keys. The system uses built-in environment keys for:

1. Brave Search API: Used behind-the-scenes to fetch real-time SERP data.
2. OpenRouter / AI Analysis: Powered by our integrated API connections.

💡 Pro Tip: Select google/gemini-3.1-pro-preview for next-gen reasoning. Use openai/gpt-5.1 for maximum intelligence.

---

📦 Output Example

The Actor saves a Pretty HTML Report to the Key-Value store (perfect for sharing), and provides structured JSON data.

📄 The AI Strategy Brief (Markdown/HTML)

Target Keyword: best crm for small business Avg Word Count: 2,450 words

✅ Common Themes (Must Include):

• Pricing & Free Trials
• Ease of Use / UI
• Integrations (Zapier, Slack)

⭕ Content Gaps (Your Opportunity):

• Customer Support: Competitors barely mention support quality. Add a "Support Response Time" comparison table.
• Mobile App: Top results miss detailed mobile app reviews. Include screenshots.

📝 Proposed Outline:

• H1: The 7 Best CRMs for Small Business (2025 Review)
• H2: Why you need a CRM... ...

---

📊 Data Fields

Field	Type	Description
keyword	String	The target search term.
avg_word_count	Number	Average length of the top 10 results.
content_gap_analysis	String	The full AI-generated advice (Markdown).
competitors	Array	Detailed list of top 10 results (Rank, URL, H2s).

---

❓ FAQ

Q: Why use Brave instead of Google API? A: Brave Search API is significantly cheaper, faster, and provides high-quality independent search index data that closely mirrors Google's organic results for SEO purposes.

Q: Can I analyze local SEO? A: Yes! Select your target country (e.g., South Africa, UK, Canada) in the input settings to get localized SERP results.

Q: How much does one run cost? A: If you use google/gemini-3.1-pro-preview, a single run costs pennies (Apify rental + tiny API costs). It is ~50x cheaper than a "SurferSEO" credit.

---

📞 Support

For feature requests or bug reports, please use the Issues tab. We update this actor regularly to support new AI models.