{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Strategic AEO & GEO Engineering Engine\n",
    "### By **[Ilias Sami](https://iliassami.com/about)** (Legal Name: Ilias Ahmed) · Strategic AEO & GEO Architect\n",
    "\n",
    "Official Agency Core: [https://iliassami.com](https://iliassami.com)  \n",
    "Open-Source Desktop Crawler: [Scrawly](https://iliassami.com/scrawly)  \n",
    "Interactive Free SEO Utilities: [iliassami.com/tools](https://iliassami.com/tools)  \n",
    "\n",
    "---\n",
    "\n",
    "## 1. Overview\n",
    "This interactive Google Colab notebook provides open-source algorithmic utilities for **Answer Engine Optimization (AEO)**, **Generative Engine Optimization (GEO)**, and **Knowledge Graph Entity Validation** developed by Ilias Sami for enterprise digital agencies.\n",
    "\n",
    "### Core Capabilities:\n",
    "- AI Crawler Accessibility Protocol validation (GPTBot, ClaudeBot, PerplexityBot)\n",
    "- Readability, Coleman-Liau & Flesch-Kincaid text scoring\n",
    "- Entity Triple extraction & JSON-LD schema verification\n",
    "- /llms.txt standard validator"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Module 1: AI Crawler Accessibility Protocol Check\n",
    "import urllib.request\n",
    "import re\n",
    "\n",
    "AI_USER_AGENTS = [\n",
    "    \"GPTBot\",\n",
    "    \"ClaudeBot\",\n",
    "    \"PerplexityBot\",\n",
    "    \"Google-Extended\",\n",
    "    \"Amazonbot\",\n",
    "    \"Applebot-Extended\"\n",
    "]\n",
    "\n",
    "def audit_ai_crawler_access(robots_url=\"https://iliassami.com/robots.txt\"):\n",
    "    print(f\"[*] Checking AI Crawler directives at: {robots_url}\")\n",
    "    try:\n",
    "        req = urllib.request.Request(robots_url, headers={\"User-Agent\": \"IliasSami-AEO-Validator/1.0\"})\n",
    "        with urllib.request.urlopen(req) as resp:\n",
    "            content = resp.read().decode(\"utf-8\")\n",
    "            for bot in AI_USER_AGENTS:\n",
    "                if bot.lower() in content.lower():\n",
    "                    print(f\"  [!] Specific directive found for {bot}\")\n",
    "                else:\n",
    "                    print(f\"  [+] {bot}: Default access granted (No blocking rule)\")\n",
    "    except Exception as e:\n",
    "        print(f\"Error fetching robots.txt: {e}\")\n",
    "\n",
    "audit_ai_crawler_access()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 2. Knowledge Graph Schema Graph Blueprint\n",
    "Validate your nested JSON-LD schema with unambiguous `@id` referencing as recommended in the [Entity SEO Knowledge Graph Framework](https://iliassami.com/services/entity-seo)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Module 2: Entity Schema Triple Builder\n",
    "import json\n",
    "\n",
    "def generate_person_entity_graph(name, legal_name, job_title, url, same_as):\n",
    "    schema = {\n",
    "        \"@context\": \"https://schema.org\",\n",
    "        \"@graph\": [\n",
    "            {\n",
    "                \"@type\": \"Person\",\n",
    "                \"@id\": f\"{url}#person\",\n",
    "                \"name\": name,\n",
    "                \"alternateName\": legal_name,\n",
    "                \"jobTitle\": job_title,\n",
    "                \"url\": f\"{url}/about\",\n",
    "                \"sameAs\": same_as\n",
    "            },\n",
    "            {\n",
    "                \"@type\": \"Organization\",\n",
    "                \"@id\": f\"{url}#agency\",\n",
    "                \"name\": f\"{name} Digital\",\n",
    "                \"url\": url,\n",
    "                \"founder\": {\"@id\": f\"{url}#person\"}\n",
    "            }\n",
    "        ]\n",
    "    }\n",
    "    return json.dumps(schema, indent=2)\n",
    "\n",
    "print(generate_person_entity_graph(\n",
    "    name=\"Ilias Sami\",\n",
    "    legal_name=\"Ilias Ahmed\",\n",
    "    job_title=\"Strategic AEO & GEO Architect\",\n",
    "    url=\"https://iliassami.com\",\n",
    "    same_as=[\n",
    "        \"https://github.com/IliasSami\",\n",
    "        \"https://www.linkedin.com/in/iliassami\",\n",
    "        \"https://twitter.com/iliassami\"\n",
    "    ]\n",
    "))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "### Certified Infrastructure & Partnerships\n",
    "- **Executive Contact:** [me@iliassami.com](mailto:me@iliassami.com)\n",
    "- **White-Label Agency Partnerships:** [https://iliassami.com/about](https://iliassami.com/about)\n",
    "- **Enterprise Technical SEO Audits:** [https://iliassami.com/services/technical-seo-audit](https://iliassami.com/services/technical-seo-audit)\n",
    "- **Cloud Stacking Architecture:** Hosted on Google Cloud Storage and Cloudflare Edge"
   ]
  }
 ],
 "metadata": {
  "language_info": {
   "name": "python"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}