earlyseo-blog 1.0.0

Drop-in blog integration for Django & Flask — powered by EarlySEO. Articles are served from EarlySEO's CDN. Just add your site ID and go.

earlyseo-blog

Drop-in blog integration for Django and Flask — powered by EarlySEO. Articles are authored in the EarlySEO dashboard and served from a global CDN. This package fetches and renders them in your Python web app.

Quick start

pip install earlyseo-blog

Django

pip install "earlyseo-blog[django]"

settings.py

INSTALLED_APPS = [
    # …
    "earlyseo_blog.django",
]

EARLYSEO_SITE_ID = "your-site-id"   # from Dashboard → Integrations → SDK

urls.py

from django.urls import include, path

urlpatterns = [
    path("blog/", include("earlyseo_blog.django.urls")),
]

That's it — visit /blog to see your articles.

Template tags

Override the built-in fallback HTML by creating your own templates:

<!-- templates/earlyseo/blog_list.html -->
{% extends "base.html" %}
{% load earlyseo %}

{% block extra_head %}{% earlyseo_styles %}{% endblock %}

{% block content %}
  {% for article in articles %}
    <h2><a href="{% url 'earlyseo_blog:blog_detail' slug=article.slug %}">{{ article.title }}</a></h2>
    <p>{{ article.meta_description }}</p>
  {% endfor %}
{% endblock %}

Available template tags: {% earlyseo_styles %}, {% earlyseo_article_css %}, {% earlyseo_article article %}.

---

Flask

pip install "earlyseo-blog[flask]"

app.py

from flask import Flask
from earlyseo_blog.flask.views import create_blog_blueprint

app = Flask(__name__)
app.config["EARLYSEO_SITE_ID"] = "your-site-id"

app.register_blueprint(create_blog_blueprint(), url_prefix="/blog")

Override the built-in HTML by placing templates/earlyseo/blog_list.html and templates/earlyseo/blog_detail.html in your templates folder.

---

CLI scaffolding

The package includes a CLI to bootstrap templates and configuration:

earlyseo-blog

Run it from the root of your Django or Flask project. It will:

1. Detect your framework
2. Ask for your Site ID
3. Generate starter templates and a .env file

---

Python client (standalone)

Use the client directly in any Python app:

from earlyseo_blog import EarlySeoClient

client = EarlySeoClient(site_id="your-site-id")

# List articles (page 1)
page = client.get_list_page(1)
for article in page.articles:
    print(article.title, article.slug)

# Get a single article
article = client.get_article("my-article-slug")
print(article.title)
print(article.content_html)

Async client

from earlyseo_blog import AsyncEarlySeoClient

async def main():
    async with AsyncEarlySeoClient(site_id="your-site-id") as client:
        page = await client.get_list_page(1)
        article = await client.get_article("my-article-slug")

Install the async extra for HTTP/2 support:

pip install "earlyseo-blog[async]"

---

Models

All responses are validated with Pydantic v2:

Model	Description
Manifest	Site manifest with total pages/articles
ArticleListItem	Summary for list views
ArticleListPage	Paginated list of ArticleListItem
Article	Full article with content_html

from earlyseo_blog.models import Article, Manifest

---

CSS

Built-in styles for article content and blog layout:

from earlyseo_blog.css import ARTICLE_CSS, BLOG_CSS

Include them in your <style> tag or template to get default styling.

---

Configuration

Setting	Description	Default
site_id	Your EarlySEO site ID (required)	—
cdn_base_url	CDN base URL	https://media.earlyseo.com

Django: Set EARLYSEO_SITE_ID and optionally EARLYSEO_CDN_BASE_URL in settings.py.

Flask: Set in app.config["EARLYSEO_SITE_ID"] and optionally app.config["EARLYSEO_CDN_BASE_URL"].

---

Requirements

• Python ≥ 3.9
• httpx ≥ 0.24
• pydantic ≥ 2.0
• Django ≥ 4.2 (for Django integration)
• Flask ≥ 2.3 (for Flask integration)

License

MIT