How adtechthai/narastainless-seo works
This repository is an SEO analysis and content-planning package for narastainless.com, not a general-purpose application. Its main workflow turns Ahrefs exports and search-performance data into recovery and competitor analyses, keyword clusters, and client-facing dashboards and reports; a parallel editorial workflow organizes research and article deliverables. The README documents the high-level raw-to-processed-to-output flow. Script excerpts show several dashboard and report transformations, but do not establish every data handoff, so unsampled connections are omitted.
Main entry points: 02_processed_data Processed data · build_dashboard_v2.py Dashboard builder · _research Research dossiers · build_report_2026_08.py Monthly report builder
Components 22
SEO analysis
- Keyword filtering
04_scripts/rebuild_data.py - Keyword clusters
04_scripts/cluster_definitions.py - Competitor analysis
04_scripts/analyze_competitors.py - Keyword analysis
04_scripts/analyze_competitor_keywords.py - SERP research
04_scripts/fetch_serp.py - Competitor table
04_scripts/build_competitor_traffic_data.py
Dashboards and reports
- SEO dashboard
narastainless_seo_dashboard.html - Dashboard builder
04_scripts/build_dashboard_v2.py - SEO dashboards
03_outputs - Competitor page
04_scripts/add_competitor_page.py - Competitor report
04_scripts/build_competitor_html.py - Technical audit
04_scripts/add_technical_audit_page.py - Monthly report builder
04_scripts/build_report_2026_08.py - Report data
03_outputs/report-2026-08.data.js - SEO deliverables
03_outputs/narastainless_seo_analysis.xlsx
Editorial planning
- Article drafts
05_articles - Research dossiers
05_articles/_research - Research splitter
04_scripts/split_research.py
SEO data
- Ahrefs exports
01_raw_data - Processed data
02_processed_data - SERP results
02_processed_data/serp_results.json
Other components
- SEO analyst
Connections 22
- SEO analyst → Ahrefs exports: provides exports
README.md - Ahrefs exports → Processed data: processes data
README.md - SEO analyst → Keyword filtering: rebuilds keywords
README.md - Keyword filtering → Processed data: creates filtered data
README.md - SEO analyst → Competitor analysis: analyzes recovery
README.md - Competitor analysis → Processed data: generates recovery data
README.md - SEO analyst → Keyword clusters: plans content
README.md - Keyword clusters → Dashboard builder: supplies clusters
04_scripts/build_dashboard_v2.py - SEO dashboard → Dashboard builder: provides GSC data
04_scripts/build_dashboard_v2.py - Processed data → Dashboard builder: provides GA4 data
04_scripts/build_dashboard_v2.py - Dashboard builder → SEO dashboards: builds dashboard
04_scripts/build_dashboard_v2.py - Processed data → Competitor table: reads competitor exports
04_scripts/build_competitor_traffic_data.py - Competitor table → Competitor page: feeds competitor view
04_scripts/add_competitor_page.py - Processed data → Competitor report: reads recovery data
04_scripts/build_competitor_html.py - Competitor report → SEO dashboards: builds competitor report
04_scripts/build_competitor_html.py - Processed data → Technical audit: reads audit data
04_scripts/add_technical_audit_page.py - Monthly report builder → Report data: generates report data
03_outputs/report-2026-08.data.js - SEO analyst → Research dossiers: creates research
README.md - Research dossiers → Article drafts: guides article drafts
README.md - Research splitter → Research dossiers: writes dossiers
04_scripts/split_research.py - SEO analyst → SEO deliverables: reviews deliverables
README.md - Monthly report builder → SEO deliverables: produces analysis