Rankloop

About This Project

Rankloop is an enterprise-grade SEO automation platform that handles the full content lifecycle — from keyword research and AI-powered article writing to one-click publishing across six CMS platforms and a first-of-its-kind peer-to-peer backlink exchange network.

We designed and built the entire platform from the ground up as a multi-tenant SaaS application. The system connects to three major LLM providers (Claude, GPT, Gemini), six publishing targets (WordPress, Webflow, Notion, Shopify, Hygraph, custom APIs), and external SEO intelligence sources including Ahrefs and Google Search Console.

With 46 database models, 48 service objects, 57 background jobs, and an autonomous AI agent framework, Rankloop is one of the most technically ambitious Rails applications we have delivered. It covers everything from real-time AI visibility tracking across ChatGPT, Perplexity, and Google AI Overview to an intelligent backlink matching engine that pairs websites based on relevance scoring and domain authority.

Platform Overview

Multi-Tenant SaaS Architecture

Rankloop uses a workspace-based multi-tenant design where each workspace maps to a single domain or brand. The architecture supports:

• Team collaboration through workspace memberships with invite flows


• Agency accounts that manage multiple client workspaces from one dashboard


• Role-based access control enforced by Pundit authorization policies across every controller action

AI Content Generation Pipeline

The content engine is the heart of the platform — an 18-service pipeline that takes a target keyword and produces a fully optimized, publish-ready article. The pipeline steps include:

• Keyword analysis with semantic clustering, search volume, difficulty scoring, and intent classification


• Hierarchical outline generation with configurable depth, heading structure, and section ordering


• Full long-form article writing with proper heading hierarchy, internal linking, and call-to-action placement


• AI-generated featured images and in-article visuals using targeted prompt engineering


• Automatic discovery and embedding of relevant YouTube videos to enrich content


• Intelligent placement of internal links and backlink exchange links within the article body


• Auto-generated meta titles, descriptions, and schema markup tailored for each piece

Each article flows through a clear status lifecycle: pending, outline approved, completed, and published.

Multi-CMS Publishing Engine

One-click publishing to six platforms, each powered by a dedicated posting service:

• WordPress — full REST API integration with featured image upload, category and tag mapping, custom field support, and automatic retry logic (the largest single service at 142 KB)


• Webflow — CMS collection item creation with rich text formatting and asset handling


• Notion — database page publishing with structured content blocks


• Shopify — blog post creation with metafield support and image processing


• Hygraph — GraphQL mutation-based publishing for headless CMS setups


• Custom API Endpoints — webhook-based posting to any REST API, fully configurable per workspace

Every integration handles platform-specific image resizing, metadata mapping, error recovery with automatic retry, and post-publish status verification.

Peer-to-Peer Backlink Exchange Network

The most innovative part of Rankloop — a credit-based backlink trading system that connects websites across the network:

• An AI matching engine (89 KB service) that pairs source articles with target pages based on semantic relevance scoring, domain authority from Ahrefs, and configurable safety rules


• A credit system where higher domain-rated sites earn and cost more credits, creating a fair and balanced marketplace


• Automated contextual injection of backlinks during the content generation process


• Post-publication verification using headless Chrome (Ferrum) to confirm that links are live and properly placed


• A rotation engine that detects stale or removed links and automatically swaps in fresh replacements

AI Visibility Tracking (Brand Radar)

Rankloop monitors brand mentions across AI-powered platforms in near real-time:

• Tracked platforms include ChatGPT, Google AI Overview, Perplexity, Claude, Microsoft Copilot, and Reddit


• Key metrics cover Share of Voice percentage, mention type classification (explicit, implicit, cited), and head-to-head competitor comparison


• Gap analysis identifies queries where competitors are mentioned but the target brand is not


• One-click content generation that targets identified visibility gaps directly

Autonomous Agent Framework

Background AI agents run scheduled or on-demand workflows with full lifecycle management:

• Ambient agents — AI visibility monitor, competitor watcher, campaign tracker, opportunity scout


• Interactive agents — content generator, SEO optimizer, gap analyzer, keyword researcher


• Complete audit trail with execution logs, status tracking, and cron-based recurring schedule support

Background Job Orchestration

57 Sidekiq jobs organized into priority tiers, all protected by PostgreSQL advisory locks to prevent race conditions:

• Content generation, auto-scheduling, and publishing jobs (critical tier, immediate retry)


• Daily backlink matching and verification cycles (important tier, scheduled runs)


• AI visibility snapshot collection across seven platforms (important tier)


• Domain rating tracking and alert emails on DR improvements (background tier)


• Google Search Console keyword sync and metric updates (background tier)

External Integrations

• LLM Providers — Anthropic Claude, OpenAI GPT, Google Gemini with automatic fallback


• SEO Data — Ahrefs Brand Radar, DataForSEO, Google Search Console via OAuth


• Payments — Stripe subscriptions with trial periods, promo codes, and self-service billing portal


• Authentication — Google OAuth2 combined with magic link passwordless login


• Storage — AWS S3 for image hosting with MiniMagick processing and resizing


• Email — Brevo for transactional notifications and bulk campaign delivery


• Monitoring — Rollbar for exception tracking with full stack traces

Technology Stack