# GODRANK Brief — Topical Map Generator

:::info
:bulb: Promotion brief for the Topical Map Generator — an AI-powered Semantic SEO tool built on Base44 + Perplexity Sonar Pro.
:::

## :beginner: Project Info

:::success
Describe the essential information of this project.
:::

:small_blue_diamond: **Project Name:** Topical Map Generator
:small_blue_diamond: **Leader:** Niro Levi
:small_blue_diamond: **Budget:** ~$0.02–$0.25 per map (Perplexity Sonar Pro API costs only)
:small_blue_diamond: **Contributors:** Niro Levi (Architecture & SEO Methodology), Perplexity Sonar Pro (AI Research Engine), Base44 (No-Code Platform)
:small_blue_diamond: **Target Audience:** SEO professionals, content strategists, agency owners, niche site builders, and anyone building topical authority for organic search
:small_blue_diamond: **Expected Launch Date:** Q2 2026

## :triangular_flag_on_post: Background

:::success
Describe the problem/mission you are solving.
:::

Building topical authority is the most effective long-term SEO strategy — but creating a proper topical map is brutally time-consuming. Most SEOs either skip it entirely, use shallow keyword research tools, or spend 20–40 hours manually applying frameworks like Koray Tugberk Gubur's 23-step Semantic SEO methodology.

The result? Most websites never achieve true topical coverage. They publish disconnected content, miss critical entity-attribute relationships, and wonder why competitors outrank them despite having fewer pages.

**The Topical Map Generator solves this by automating the entire 23-step methodology into a single click.** It uses Perplexity Sonar Pro — a real-time AI research engine with live web access and citations — to perform niche research, generate topics with full semantic structure, and filter for gaps and cannibalization. What used to take days now takes 60 seconds.

## :pencil: Objectives and Challenges

:::success
What does this project want to achieve? Are there any challenges?
:::

### :small_blue_diamond: Problem Formulation:

Current topical mapping approaches fail in three ways:

1. **Keyword tools (Ahrefs, SEMrush)** generate flat keyword lists with no semantic structure — no entity-attribute pairs, no section hierarchy, no internal link architecture
2. **Generic AI tools (ChatGPT, Claude)** produce shallow lists without real search data, live competitor analysis, or methodological rigor
3. **Manual methodology application** requires deep expertise in Koray's framework and 20+ hours per niche — unscalable for agencies or multi-site operators

The Topical Map Generator bridges the gap: **methodological rigor + AI research speed + real-time web intelligence.**

### :small_blue_diamond: Expected Techniques:

1. **3-Pass Perplexity Sonar Pro Architecture** — Pass 1: Niche research (knowledge domains, entity word relations, competitor analysis) → Pass 2: Full topic generation (ontology + token insertion + predicate-noun combinations) → Pass 3: Filtering (RPP scoring, gap analysis, deduplication)
2. **Koray's 23-Step Semantic SEO Methodology** — Fully encoded: 5 Core Components, Core/Outer section logic, 4 title tag methodologies, Quality/Trending/Standard node types, Root→Seed→Node internal linking, zero-volume topic inclusion

### :small_blue_diamond: Expected Goals and Criteria:

| **Goal/Criteria** | **Description** | **Note** |
|:--:|:--:|:--:|
| Sub-60s Generation | Complete topical map in under 60 seconds for standard scope | Quick scope: ~30s |
| 13-Column Output | Every topic includes all 13 Koray columns: section, sub-section, raw topic, title tag, URL slug, meta description, image URL slug, image alt text, search intent, priority, node type, internal link targets, notes | Full methodology compliance |
| Core/Outer Separation | Properly classified sections with correct authority flow direction | Outer → Core linking |
| XLSX Export | Professional 5-sheet export (Overview, Core, Outer, All Topics, Priority Queue) | Ready for client delivery |
| Section Expansion | Drill into any sub-section to generate 15+ additional topics on demand | Infinite depth capability |
| Built-in AI Agent | Embedded SEO advisor that helps define 5 Core Components and reviews maps for gaps | Guides non-experts through the methodology |
| Scalable Pricing | $0.02–$0.25 per map — enables agency-scale batch generation | No monthly SaaS fee |

### :small_blue_diamond: Expected Challenges:

1. **LLM JSON reliability** — Sonar Pro sometimes wraps JSON in markdown or adds prose around structured output
2. **Topic deduplication across passes** — Multiple research passes can produce overlapping topics
3. **Scope calibration** — Ensuring Quick/Standard/Comprehensive scopes produce appropriate topic counts
4. **Rate limiting** — High-volume usage may hit Perplexity API rate limits

#### Expected Solution:
- Robust JSON extraction with regex fallback parsing (strips code fences, finds arrays/objects)
- Deduplication by URL slug normalization in the filtering pass
- Scope-aware system prompts with explicit topic count targets per scope tier
- Built-in error handling with status tracking (draft → researching → generating → filtering → complete → error) and retry capability

## :timer_clock: Timeline

:::success
Schedule the timeline, including essential dates and deadlines.
:::

| **Item** | **Date** | **Note** |
|:--:|:--:|:--:|
| Architecture Design | Mar 9, 2026 :white_check_mark: | Base44 + Sonar Pro, 3-pass pipeline |
| Backend Functions | Mar 9, 2026 :white_check_mark: | 3 functions: generate, expand, export |
| Entity Schemas | Mar 9, 2026 :white_check_mark: | 3 entities: Project, Topic, Research |
| Frontend Prompts | Mar 9, 2026 :white_check_mark: | 4 page prompts + AI agent system prompt |
| Base44 Deployment | Mar 10–12, 2026 | Paste functions, create entities, deploy pages |
| Alpha Testing | Mar 12–16, 2026 | Test with 5 niches, validate methodology compliance |
| XLSX Export QA | Mar 16–18, 2026 | Verify all 5 sheets, formatting, column completeness |
| AI Agent Tuning | Mar 18–22, 2026 | Test agent guidance flow, refine system prompt |
| Beta Launch | Mar 23, 2026 | Soft launch to SEO community |
| Public Launch | Apr 6, 2026 | Full promotion + HackMD writeup + demo video |

## :book: Reference

:::success
List the reference you use in this project.
:::

1. [Koray Tugberk Gubur — Semantic SEO for Topical Authority (Course)](https://www.koraygubur.com/)
2. [Perplexity Sonar Pro API Documentation](https://docs.perplexity.ai/guides/getting-started)
3. [Perplexity API Pricing](https://docs.perplexity.ai/guides/pricing)
4. [Base44 — No-Code App Builder](https://base44.com)
5. [Base44 Backend Functions Documentation](https://docs.base44.com/backend-functions)
6. [SheetJS (xlsx) — JavaScript Spreadsheet Library](https://sheetjs.com/)
7. [Koray Tugberk Gubur — Topical Map Creation Methodology (2024–2026 Updates)](https://www.koraygubur.com/)
8. [Google Quality Raters Guidelines — E-E-A-T Framework](https://guidelines.raterhub.com/)
9. 8. [Creator - GODRANK.COM](https://godrank.com/)

---

## :rocket: Product Highlights (Promotion Copy)

### One-Liner
> **Generate a complete, methodology-compliant Semantic SEO topical map in 60 seconds — not 60 hours.**

### Key Differentiators

**vs. Keyword Research Tools (Ahrefs, SEMrush)**
Traditional tools give you flat keyword lists. The Topical Map Generator gives you a structured content architecture — with Core/Outer sections, entity-attribute pairs, internal link targets, and priority nodes. It's the difference between a pile of bricks and a blueprint.

**vs. Generic AI (ChatGPT, Claude)**
Generic LLMs hallucinate search data and don't follow a real methodology. Sonar Pro researches the live web with citations, while the entire pipeline is hardcoded to Koray's 23-step framework. Every topic is grounded in real competitive intelligence.

**vs. Manual Methodology Application**
Even if you've taken Koray's course, building a full map manually takes 20–40 hours per niche. This tool encodes the entire methodology — from entity word relations to RPP filtering to Quality Node classification — into an automated pipeline. Your expertise goes into reviewing and refining, not spreadsheet labor.

### Who Is This For?

- **SEO Professionals** who follow Semantic SEO methodology but need to scale
- **Agency Owners** who need to produce topical maps for multiple clients per week
- **Niche Site Builders** who want to start with a proper content architecture from day one
- **Content Strategists** who need data-backed content calendars with clear internal linking plans
- **Solo Founders** who can't afford an SEO agency but want agency-quality topical planning

### How It Works (3 Steps)

1. **Define** — Enter your niche, central entity, and central search intent. The AI agent helps you nail down all 5 Core Components.
2. **Generate** — One click triggers 3 Sonar Pro research passes. Watch as it progresses: researching → generating → filtering → complete.
3. **Export** — Download a professional XLSX with 5 sheets, or Markdown for direct use in your CMS. Expand any section for deeper coverage.

### Pricing Model
Pay only for what you use. No monthly subscription. Each map costs $0.02–$0.25 in Perplexity API fees depending on scope. Generate 100 Standard maps for under $12.