SERP Intelligence

​

Overview

​

How FAII SERP Intelligence Works

​

Advanced Web Scraping Architecture

• Puppeteer 24 with stealth plugins for undetectable operation
• OctoBrowser and AdsPower integration for authentic browser profiles
• Residential proxy network for geographic accuracy
• Human-like behavior simulation (random delays, mouse movements)

1. Campaign Creation - Define keywords, locations, and competitors
2. Browser Session Launch - Real browser profile via OctoBrowser/AdsPower API
3. Geographic Routing - Residential proxy for location authenticity
4. Search Execution - Human-like search behavior and navigation
5. Complete SERP Capture - HTML snapshot + screenshot preservation
6. AI Overview Detection - Full text extraction of AI-generated content
7. Data Analysis - Ranking calculation, competitor detection, feature identification
8. Storage - Supabase PostgreSQL with time-series data

​

What Makes FAII Different

• Real browser sessions that Google cannot distinguish from human users
• Residential proxies for authentic geographic representation
• Human-like behavior patterns that avoid detection algorithms

​

Key Features

​

Real-Time Ranking Tracking

{
  "keyword": "best project management software",
  "search_engine": "google",
  "location": "United States",
  "device": "desktop",
  "frequency": "hourly"
}

​

AI Overview Content Capture

• Complete text capture - Every word of AI Overview content
• Brand mention detection - Identify when you’re mentioned in AI responses
• Competitor mentions - Track competitor positioning in AI content
• Source citation analysis - See what Google used to generate the overview
• Content depth tracking - Monitor how detailed AI responses are

​

SERP Feature Monitoring

• Featured Snippets - Position 0 results and content
• Knowledge Panels - Brand information displays
• Local Pack - Map and local business results
• People Also Ask - Related questions sections
• Image Pack - Image search results
• Video Carousel - Video results
• Site Links - Enhanced sitelinks

​

Advanced Competitor Tracking

​

Use Cases

​

SEO Performance Monitoring

{
  "name": "Core SEO Keywords",
  "type": "serp",
  "keywords": [
    "project management software",
    "task management tools",
    "team collaboration platforms"
  ],
  "location": "United States",
  "frequency": "daily",
  "competitors": ["competitor1.com", "competitor2.com"],
  "alerts": {
    "ranking_drop": 5,
    "ai_overview_mention": true
  }
}

​

Local SEO Tracking

• Track “dentist near me” in 10 major cities
• Monitor local pack appearances and positions
• Compare performance across geographic markets
• Track Google Business Profile visibility

​

Brand Protection & Monitoring

• Brand name rankings and AI Overview mentions
• Competitor ads on your brand keywords
• Negative content in search results
• Brand mention sentiment in AI responses

​

Configuration

​

Creating a SERP Campaign

curl -X POST https://app.faii.ai/api/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "serp",
    "name": "Brand Monitoring",
    "keywords": ["your brand name", "your industry"],
    "location": "United States",
    "frequency": "daily",
    "competitors": ["competitor1.com", "competitor2.com"]
  }'

​

Campaign Settings

​

Metrics & Analytics

​

Key Metrics

​

Data Export Formats

• CSV - For Excel and spreadsheet analysis
• JSON - For programmatic access and integration
• PDF - For client reports and presentations
• API - Real-time data access via REST endpoints

​

Best Practices

​

Keyword Selection Strategy

• Commercial Intent Keywords - Terms customers use when ready to buy
• Brand Protection Terms - Your company and product names
• Competitor Brand Terms - Track competitor brand mentions
• Long-tail Variations - Specific, detailed search queries

​

Monitoring Frequency Guidelines

​

Alert Configuration

{
  "alerts": {
    "ranking_drop": {
      "threshold": 5,
      "notify": ["email", "slack"]
    },
    "ai_overview_mention": {
      "notify": ["email"]
    },
    "competitor_movement": {
      "threshold": 3,
      "notify": ["slack"]
    },
    "new_serp_feature": {
      "notify": ["email"]
    }
  }
}

​

API Integration

// Fetch current rankings
const rankings = await faii.serp.getCurrentRankings({
  campaign_id: 'camp_123',
  keywords: ['project management software']
});

// Get AI Overview data
const aiOverview = await faii.serp.getAIOverview({
  campaign_id: 'camp_123',
  keyword: 'best project management tools'
});

// Compare with competitors
const comparison = await faii.serp.compareWithCompetitors({
  campaign_id: 'camp_123',
  competitors: ['competitor1.com', 'competitor2.com']
});

​

Pricing

• Starter: 25 keywords, daily checks
• Professional: 100 keywords, hourly checks
• Enterprise: 500 keywords, real-time checks
• Agency: Unlimited keywords, custom schedules

​

Support

• 📧 [email protected]
• 📚 API Documentation
• 💬 Community support (coming soon)