Docs/Getting Started/How It Works

How It Works

Understand the end-to-end pipeline: from keyword research to article delivery.

The Pipeline

FirstSearch.AI is a content factory. You connect your website, and the system automatically researches keywords, generates articles, creates images, and delivers everything to your CMS. Here's how each stage works.

Stage 1: Website Analysis
Stage 2: Keyword Research
Stage 3: Content Calendar
Stage 4: Article Generation
Stage 5: Image Generation
Stage 6: Webhook Delivery

Stage 1: Website Analysis

When you add a website, the system crawls your domain and extracts:

  • - Business profile — what you do, your niche, target audiences
  • - Existing content — pages from your sitemap for internal linking
  • - Competitors — sites ranking for similar keywords
  • - Language — auto-detected, articles are written in your site's language

This profile is the foundation for everything downstream. The better the system understands your business, the more relevant the articles.

Stage 2: Keyword Research

An AI keyword agent discovers high-opportunity keywords in your niche using a hybrid approach:

  • - Seed expansion — generates keyword ideas from your niche and competitors
  • - Data enrichment — pulls real search volume, difficulty, and CPC data
  • - Semantic deduplication — prevents keyword cannibalization using embeddings
  • - Opportunity scoring — ranks keywords by realistic ranking potential for your domain
Multi-language
Keyword research runs in your site's language. Swedish sites get Swedish keywords, German sites get German keywords, and so on. Currently supported: English, Swedish, German, French, Spanish, Norwegian, Danish, Dutch, Finnish, Italian, Portuguese.

Stage 3: Content Calendar

The top 45 keywords become your content calendar — one article per day for 45 days. Each calendar entry includes:

  • - Target keyword and search intent
  • - Scheduled publication date
  • - Search volume and difficulty metrics
  • - Related keywords for semantic coverage

You can review and modify the calendar before generation begins. Swap keywords, reorder dates, or add your own topics. When the calendar runs out, it auto-extends with fresh keywords.

Stage 4: Article Generation

Each article is generated using a two-stage AI architecture:

Stage 4a: The Brain (Research & Planning)

A single AI call with web search access researches the topic and creates a detailed blueprint:

  • - Finds real, authoritative sources to cite
  • - Plans 6-10 sections with specific content briefs
  • - Chooses a unique angle (contrarian, data-driven, myth-busting, etc.)
  • - Selects a consistent visual style for all images
  • - Writes SEO-optimized title, H1, and meta description

Stage 4b: Section Writers (Parallel Execution)

Each section is written in parallel by specialized AI writers that follow the blueprint exactly. They expand the content briefs into full prose with:

  • - Pre-researched facts and source citations
  • - Image and video placement
  • - Internal links to your existing content
  • - Proper heading hierarchy (H2/H3/H4)

The result is a 2,000-3,500 word article with a Key Takeaways summary, FAQ section, and structured data.

Stage 5: Image Generation

A separate task generates 3-4 AI illustrations per article using the visual style chosen by The Brain. All images in a single article share the same artistic template for a cohesive, publication-quality feel.

Available styles include Editorial Illustration, Digital Illustration, Isometric, Flat Design, Watercolor, 3D Render, Geometric Abstract, and more. The system selects the best fit based on the article's topic and tone.

Images are hosted permanently and delivered as direct URLs in the webhook payload.

Stage 6: Webhook Delivery

The completed article is delivered to your configured webhook endpoint as a POST request containing:

  • - Full article content in Markdown
  • - SEO metadata (title, meta description, Open Graph, Twitter cards)
  • - Featured image + section images (permanent URLs)
  • - Article schema (JSON-LD) + FAQ schema for rich results
  • - Categories, tags, and article metrics

See the Webhook Integration guide for the full payload reference, authentication details, and code examples.

After Delivery

Once published, FirstSearch.AI continues working:

  • - Performance tracking — monitors Google Search Console data for your articles
  • - Content intelligence — identifies which articles are performing and which need updates
  • - AI visibility — tracks your brand mentions in ChatGPT and AI search results
  • - Calendar extension — automatically generates new keywords when your calendar runs out