SEO Fix Priority Engine — Turn Audit Issues into Action

Turn a confusing SEO audit containing hundreds or thousands of issues into a prioritized action plan. This Actor accepts SEO issues from any crawler, normalizes them, estimates impact and effort, and generates an actionable fix roadmap with quick-win identification.

The Problem This Solves

You ran an SEO audit. It found 500 issues. Now what?

Generic auditors list every problem but don't tell you which ones matter most. You're left wondering:

• Which issues should I fix first?
• Which problems affect the most pages?
• What are the quick wins?
• What can wait?

This Actor answers those questions.

Who Is It For?

• SEO agencies — Import audit results → generate priority roadmap → share top fixes with client
• Website owners — Upload issue list → understand what matters first → fix quick wins
• Developers — Get a prioritized task list with effort estimates
• Automated pipelines — SEO crawler → dataset export → this Actor → prioritized dataset

How It Works

SEO Issues (from any source)
       ↓
Input Validation & Normalization
       ↓
Synonym Mapping (404 internal links → broken_internal_links)
       ↓
Duplicate Grouping (sum affected pages)
       ↓
Impact Estimation (LOW / MEDIUM / HIGH / CRITICAL)
       ↓
Effort Estimation (LOW / MEDIUM / HIGH)
       ↓
Priority Scoring (Impact × log10(pages+1) ÷ Effort)
       ↓
Quick-Win Detection (HIGH impact + LOW effort)
       ↓
Recommendation Generation
       ↓
Ranked Output + Executive Summary

Supported Issue Types (22)

Category	Issue Types
Links	broken_internal_links, broken_external_links
Redirects	redirect_chains, redirect_loops
Titles	missing_title, duplicate_title, title_too_long, title_too_short
Meta	missing_meta_description, duplicate_meta_description
Headings	missing_h1, multiple_h1
Canonical	canonical_error, missing_canonical
Content	duplicate_content
Indexing	noindex_problem, robots_txt_problem
Performance	slow_page, large_page
Images	missing_alt_text
Architecture	orphan_page, internal_linking_problem
Structured Data	structured_data_error

Priority Methodology

Priority Formula

Priority Score = (Impact Weight × log10(affectedPages + 1) ÷ Effort Weight) / MAX_RAW_SCORE × 100

Impact Weights

Level	Weight	Description
CRITICAL	10	Can remove pages from search results entirely
HIGH	6	Significant negative effect on SEO
MEDIUM	3	Moderate effect, should be addressed
LOW	1	Minor or cosmetic issue

Effort Weights

Level	Weight	Description
LOW	1	Quick fix, often sitewide template change
MEDIUM	2	Requires individual page review
HIGH	4	Significant development work

Priority Labels

Score	Label	Meaning
75-100	CRITICAL	Fix immediately
50-74	HIGH	Fix soon
25-49	MEDIUM	Plan to address
0-24	LOW	Low priority

Quick Wins

Quick wins are issues with HIGH or CRITICAL impact AND LOW effort — the highest-ROI fixes.

Note: Priority scores are decision-support heuristics, not guarantees of search ranking improvements.

Input

{
  "seoIssues": [
    {"type": "broken_internal_links", "affectedPages": 47},
    {"type": "missing_meta_description", "affectedPages": 132},
    {"type": "canonical_error", "affectedPages": 12},
    {"type": "missing_alt_text", "affectedPages": 300},
    {"type": "redirect_loops", "affectedPages": 4},
    {"type": "orphan_page", "affectedPages": 7}
  ],
  "analysisMode": "balanced",
  "groupSimilarIssues": true,
  "includeRecommendations": true,
  "siteName": "Example Site"
}

Alternative Input Formats

The Actor normalizes diverse field names:

Canonical Field	Accepted Alternatives
type	issue, issue_type, problem, category
affectedPages	affected_pages, count, pages
seoIssues	issues

Synonym Normalization

Different tools use different names. The Actor maps them:

Input	Normalized To
"Broken Internal Links"	broken_internal_links
"404 internal links"	broken_internal_links
"Internal broken URL"	broken_internal_links
"Missing meta description"	missing_meta_description
"No meta description"	missing_meta_description

Output

The Actor pushes structured items to the dataset:

1. Analysis Summary (first item)

{
  "type": "analysis_summary",
  "summary": {
    "totalIssueRecords": 6,
    "recognizedIssues": 6,
    "unknownIssues": 0,
    "totalAffectedPages": 502,
    "quickWinCount": 2
  },
  "executiveSummary": {
    "overview": "The audit found 502 affected pages across 6 issue records...",
    "topPriority": "The highest priority is 'Broken Internal Links'...",
    "quickWinsText": "The best quick wins are:\n1. Broken Internal Links\n2. Missing Title Tags"
  },
  "topPriorities": [...],
  "quickWins": [...]
}

2. Prioritized Issues (subsequent items)

{
  "type": "prioritized_issue",
  "rank": 1,
  "issueType": "broken_internal_links",
  "displayName": "Broken Internal Links",
  "affectedPages": 47,
  "impact": {"level": "HIGH", "weight": 6},
  "effort": {"level": "LOW", "weight": 1},
  "priorityScore": 68.5,
  "priority": "HIGH",
  "quickWin": true,
  "recommendedAction": "Update links to valid URLs, remove obsolete links, or add 301 redirects...",
  "whyItMatters": "Broken internal links waste crawl budget...",
  "explanation": "Internal links point to pages that return a 4xx or 5xx error..."
}

3. Unknown Issues

Issues not in the taxonomy are preserved with priority: "REVIEW_REQUIRED":

{
  "type": "unknown_issue",
  "issueType": "javascript_hydration_warning",
  "priority": "REVIEW_REQUIRED",
  "note": "This issue type is not in the known taxonomy. Manual review recommended."
}

Performance

Issues	Time	Per Issue
10	0.2ms	0.02ms
100	0.8ms	0.008ms
1,000	7.4ms	0.007ms
10,000	86.4ms	0.009ms

Pricing

Pay-per-event: $0.25 per seo-analysis event

Each event = one complete SEO issue prioritization report.

Example costs:

• 1 analysis (up to 10,000 issues) = $0.25
• 10 analyses = $2.50
• 100 analyses = $25.00

Limitations

• Does not crawl websites — accepts issues you provide from another tool
• Deterministic — uses keyword/pattern matching, not AI (this is a feature: explainable, fast, free of API costs)
• English issue names — synonym dictionary is English-based
• 22 issue types — additional types can be added by extending src/rules/seo_issue_rules.py

Privacy

• No data sent to external APIs
• No credentials stored
• All processing within Apify platform

License

MIT