> For the complete documentation index, see [llms.txt](https://oodlz-ai-studio.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oodlz-ai-studio.gitbook.io/docs/outbound-agents/awareness/1-topics/loop-1-seo-trend.md).

# Loop 1: SEO/Trend

Real ranked keywords from competitor articles, market-routed, filtered for editorial quality, reframed into awareness-stage headlines.

> **Topics already ranking on the open web — surfaced, scored, and reframed for the brand's audience.**

Loop 1 extracts topics the brand's competitors are already winning on. The DataForSEO `ranked_keywords` endpoint returns up to 500 real keywords per competitor, anchored to actual search demand. The pipeline filters competitor articles for editorial quality, pulls the keywords behind each one, and reframes the content into awareness-stage topics tagged with source, market, category, target keyword, and real keyword difficulty.

## How It Works

For each competitor domain, the loop fires a single DataForSEO call routed by TLD — market-specific for country-code domains, global for generic domains. The result is the competitor's ranked URLs and their keyword data.

Editorial filtering applies a 3-rule check before any keyword is extracted: a URL blocklist removes obvious non-content paths, a slug word-count threshold filters out thin URLs, and a keyword-ceiling rule drops mass-published content-farm pages with abnormal keyword counts. The filter recovers content that older path-allowlist approaches missed entirely.

Surviving articles pass to a topic-generation step that converts each into an awareness-stage headline calibrated to the brand's audience. Numbered listicle formats — "10 Ways to...", "25 Tips for..." — are reframed into awareness-stage headlines or skipped if no awareness-stage angle exists. Every output topic carries the real keyword difficulty value from `ranked_keywords` — never the AdWords advertiser-competition metric that corrupts most AI tools.

## What You Get

* Topics anchored to real keyword demand from competitors that are actually ranking.
* 3-rule editorial filter that recovers competitor content older approaches missed.
* Awareness-stage reframing of every topic — no content-farm listicle reaches the calendar.
* Real keyword difficulty scores per topic — the rankability factor in composite scoring is grounded in actual SEO data.