"""SEO Score API — Live monitoring dashboard.
A self-hosted single-file Flask dashboard that polls a list of URLs through
the SEO Score API on a schedule, renders score cards with sparklines, and
auto-refreshes in the browser.
Setup:
pip install flask seoscoreapi
export SEOSCORE_API_KEY=sk_your_key_here
export DASHBOARD_URLS="https://yoursite.com,https://yoursite.com/pricing"
python monitor_dashboard.py
Then open http://localhost:8080.
Customize:
POLL_INTERVAL_SECONDS — how often each URL is re-audited (default 900 = 15 min)
Live demo: https://seoscoreapi.com/demo/dashboard
Blog post: https://seoscoreapi.com/blog/seo-monitoring-dashboard
"""
import os
import threading
import time
from datetime import datetime
from flask import Flask, render_template_string
from seoscoreapi import audit, history
API_KEY = os.environ["SEOSCORE_API_KEY"]
URLS = [u.strip() for u in os.environ["DASHBOARD_URLS"].split(",") if u.strip()]
POLL_INTERVAL = int(os.getenv("POLL_INTERVAL_SECONDS", "900"))
app = Flask(__name__)
state = {url: {"loading": True} for url in URLS}
state_lock = threading.Lock()
def status_for(delta):
if delta is None:
return "neutral"
if delta <= -5:
return "critical"
if delta < 0:
return "warning"
return "ok"
def refresh_one(url):
"""Run an audit + fetch history for one URL, store result in `state`."""
try:
result = audit(url, api_key=API_KEY)
hist = history(url, api_key=API_KEY, limit=30).get("series", [])
prev = state.get(url, {}).get("score")
delta = (result["score"] - prev) if prev is not None else None
with state_lock:
state[url] = {
"score": result["score"],
"grade": result["grade"],
"categories": {k: v.get("score") for k, v in result.get("audit", {}).items()},
"delta": delta,
"status": status_for(delta),
"spark": [h["score"] for h in hist[-30:]],
"fetched_at": datetime.utcnow().strftime("%Y-%m-%d %H:%M UTC"),
"error": None,
}
except Exception as e:
with state_lock:
state[url] = {**state.get(url, {}), "error": str(e), "status": "error"}
def poll_loop():
while True:
for url in URLS:
refresh_one(url)
time.sleep(POLL_INTERVAL)
threading.Thread(target=poll_loop, daemon=True).start()
TEMPLATE = """
SEO Monitor
SEO Monitor — refreshes every 60s
{% for url, data in state.items() %}
{{ url }}
{% if data.get('error') %}
{{ data.error }}
{% elif data.get('loading') %}
Awaiting first audit…
{% else %}
{{ data.score }}{{ data.grade }}
{% if data.delta is not none %}
{{ '+' if data.delta >= 0 else '' }}{{ '%.0f' % data.delta }}
{% endif %}
{% for cat, score in data.categories.items() %}{{ cat }} {{ score }}{% endfor %}
{% if data.spark and data.spark|length > 1 %}
{% endif %}
{{ data.fetched_at }}
{% endif %}
{% endfor %}
"""
@app.route("/")
def home():
with state_lock:
return render_template_string(TEMPLATE, state=dict(state))
if __name__ == "__main__":
app.run(host="0.0.0.0", port=8080)