Metadata-Version: 2.3
Name: django-octo-seo
Version: 0.1.1
Summary: Django-based technical SEO architecture for large-scale URL indexing and single-query metadata rendering.
Project-URL: Homepage, https://github.com/jeanpmodev/django_octo_seo
Project-URL: Repository, https://github.com/jeanpmodev/django_octo_seo
Author-email: jeanpmodev <jeanpmodev@gmail.com>
License: MIT
License-File: LICENSE
Keywords: django,json-ld,metadata,open-graph,schema-org,seo
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Requires-Python: >=3.12
Requires-Dist: django>=6.1.2
Requires-Dist: python-dotenv
Description-Content-Type: text/markdown

# django_octo_seo

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
[![Python](https://img.shields.io/badge/Python-3.11+-blue)](https://python.org)
[![Framework: Django](https://img.shields.io/badge/Framework-Django-darkgreen)](https://djangoproject.com)
[![Package Manager: Rye](https://img.shields.io/badge/Package_Manager-Rye-orange)](https://astral.sh)


**django_octo_seo** is a production-grade, high-performance SEO injection engine designed for scalable web infrastructures. It serves as a core decoupled module under the **Django-Octo** structural framework ecosystem.

This module guarantees strict database-to-head tag integrity, mapping dynamic SEO objects straight from a pre-populated PostgreSQL/SQLite layer directly into a semantic HTML5 rendering pipeline in a single database lookup.

---

## ⚡ Key Architectural Features

- **Unified Bot Controller:** Replaced fragmented crawler instructions (`Googlebot`, `Bingbot`, `Yandex`, `Baidu`) with an optimized single-pass meta-tag runtime execution.
- **Single-Block JSON-LD Graphs:** Automated structural parsing of schema datasets (`WebSite`, `BlogPosting`) packaged into a single script rendering block to improve parsing speed.
- **Absolute URL Context Binding:** Native cross-origin preview validation utilizing Django's schema handling (`request.scheme`) to prevent media preview degradation across international CDNs and messaging APIs (WhatsApp, Slack, LinkedIn).
- **Rye Environment Integration:** Fully integrated with the ultra-fast Rust-based Python package manager for reliable dependency locks.

---

## 📋 The 8-Layer SEO & Security Matrix

The architecture exposes **8 distinct, highly optimized matrix layers** linked directly from the model fields to the client-side browser document metadata container:

| Metric ID | Component Classification | Target Tag Structure | Engineering Objective |
| :---: | :--- | :--- | :--- |
| **01** | **Security Layer** | `X-Frame-Options` | Enforces clickjacking protection natively at the document head layer. |
| **02** | **Semantic Web Core** | `<title>` | Length-validated dynamic node mapping to maximize CTR on SERPs. |
| **03** | **Indexer Snippet** | `meta name="description"` | Explicit boundary-filtered string constraint avoiding automated truncation. |
| **04** | **Multi-Crawler Policy** | `meta name="robots"` | Unifies multi-bot index/follow indicators into a single parsing execution. |
| **05** | **Link Authority** | `link rel="canonical"` | Hardlocks root canonical routing mappings to prevent scrapers from draining link juice. |
| **06** | **Micro-Format Asset** | `meta name="thumbnail"` | Pre-cached index target specifying the explicit site thumbnail icon context. |
| **07** | **Social Semantic Graph** | `og:*` & `twitter:*` | Automated layout sync mapping semantic social objects directly to Open Graph APIs. |
| **08** | **Structured Dataset** | `application/ld+json` | Injects valid Rich Results syntax validating organization and content profiles. |

---

## ⚙️ Installation & Setup (Using Rye)

This repository includes a pre-populated `db.sqlite3` containing real telemetry data from [ticapsoriginal.com](https://ticapsoriginal.com) to allow immediate architectural verification.

### 1. Clone & Synchronize Environment
Clone the repository and trigger the Rust-backed Rye environment compiler to lock and synchronize dependencies:
```bash
git clone https://github.com/jeanpmodev/django_octo_seo.git
cd django_octo_seo
rye sync
```

### 2. Initialize Runtime Service
Fire up the local development engine instance:
```bash
rye run python manage.py runserver
```
Navigate to `http://127.0.0` to inspect the structural head layer live.

---

## 📄 License & Ecosystem Blueprint

Distributed under the permissive terms of the **MIT License**. 

`django_octo_seo` is an open-source structural sub-module developed for the **Django-Octo** architecture. For deep technical insights regarding enterprise database design, professional networking data, and global IT sectors, please explore our platform documentation at [ticapsoriginal.com](https://ticapsoriginal.com).
