| name | seo-content-decay-refresh |
| description | Use when detecting declining organic content, separating ranking decay from seasonality, prioritizing existing pages for refresh, or producing evidence-based content refresh briefs with DataForSEO MCP. |
SEO Content Decay Refresh
Use Historical Rank Overview, Relevant Pages, Ranked Keywords, Historical SERPs, Historical Keyword Data, Google Trends, and Content Parsing.
Scope
Require a domain; if absent, ask and wait. Normalize it to a lowercase hostname without credentials, port, trailing dot, or leading www.. Default to United States/en; disclose assumptions. Use Google organic and ignore_synonyms: true. Ask before retries, pagination, or exceeding the caps below.
Workflow
- Call
dataforseo_labs_google_historical_rank_overview to establish domain-level organic ETV, keyword-count, and position-bucket trends.
- Call
dataforseo_labs_google_relevant_pages for 50 pages ordered by organic ETV, then dataforseo_labs_google_ranked_keywords for 1,000 organic keywords ordered by ETV. Join exact normalized URLs; preserve unmatched rows.
- Select up to ten high-ETV keywords across important pages, maximum two per page. Call
dataforseo_labs_google_historical_serps per keyword for the latest 24 months. Extract the target's monthly organic URL, rank_group, and ETV; record URL switching.
- Batch those keywords through
dataforseo_labs_google_historical_keyword_data. Call kw_data_google_trends_explore in batches of five with type: web, item_types: ["google_trends_graph"], and time_range: past_5_years.
- Compare the latest three complete months with the same months one year earlier. Calculate
position_loss = recent_median_position - baseline_median_position, demand_change = 100 * (recent_median_volume / baseline_median_volume - 1), and traffic_impact = max(baseline_median_ETV - recent_median_ETV, 0). Sum sampled keyword impact per page; never substitute an external CTR model.
- Classify Structural when position loss is at least 3 and demand change is above -10%; Seasonal when demand falls at least 15%, positions stay within 2, and Trends shows a comparable recurring dip in two prior years; Mixed when position loss is at least 3 and demand falls at least 15%; otherwise Inconclusive/stable. Label missing or zero baselines.
- Prioritize by traffic impact, current ETV, business intent, and confidence. Call
on_page_content_parsing for up to five pages. Recommend refresh for stale/incomplete structural losses; consolidate for overlapping URLs or intent cannibalization; redirect only for obsolete pages with a relevant replacement; otherwise leave unchanged.
Brief and report
For each priority, provide declining keywords, position and ETV deltas, classification evidence, recommendation, specific additions/removals, an updated H1/H2/H3 outline, and source URL → target URL internal-link suggestions with anchor and rationale. Mark unverified links. Explain that this protects existing traffic while seo-content-suggestions proposes new articles.
Validate statuses and sampling; do not invent values. Log endpoint, response cost, and coverage. Sum unrounded costs and show Total cost: x,xx USD; identify missing cost values.
Write a detailed Markdown report beginning with the local ISO date. Use the requested root or SEO/; create <root>/<domain>/. Save <YYYY-MM-DD>_Content-Decay-Refresh_<domain>.md, for example 2026-06-19_Content-Decay-Refresh_example.com.md. Include Scope, summary, domain trend, page/keyword table, impact calculations, classifications, briefs, internal links, methodology, call log, and limitations. Return the absolute path.
