MIT License · Бесплатно навсегда

causabi-geo

Open-source CLI и Python-библиотека для GEO-оптимизации. Аудит, исправление и мониторинг видимости в AI-поиске — без аккаунта.

Установка
pip install causabi-geo
geo-optimizer analyze https://yourdomain.com
~3 200
Строк кода
40+ tests
Тестовое покрытие
4 core
Внешних зависимостей
MIT
Лицензия

Как работает

Одна команда → краул → скор → генерация фиксов

1
Краул
httpx загружает страницу. JS-сайты — через crawl4ai/Playwright. Извлекает: текст, структурированные данные, robots.txt, заголовки, ссылки.
2
Скор
Чистый Python-скоринг по 6 измерениям. Без LLM — детерминированный, воспроизводимый, за <1 секунды.
3
Профиль (опционально)
С --api-key: один вызов Gemini извлекает название бизнеса, описание, FAQ-вопросы, целевые запросы и фичи продукта.
4
Генерация фиксов
Создаёт патч robots.txt, schema.json, faq-schema.json и llms.txt — всё готово к деплою. Включает HOW-TO-APPLY.md.

Разбивка по модулям

6 сфокусированных модулей, каждый до 200 строк

Scorer~180 lines
geo_optimizer/core/scorer.py

Считает AI readiness score 0–100 по 6 измерениям. Чистая логика — без LLM, работает за <1 сек.

robots.txt (20pt)Schema.org (25pt)FAQ Schema (20pt)Content depth (15pt)Brand signals (10pt)Freshness (10pt)
Robots Auditor~80 lines
geo_optimizer/core/robots.py

Проверяет какие из 10+ AI-краулеров разрешены или заблокированы в robots.txt. Генерирует исправленную версию.

GPTBotClaudeBotPerplexityBotApplebot-ExtendedBytespiderGooglebot-Extendedcohere-aianthropic-ai
Schema Generator~120 lines
geo_optimizer/fix/schema.py

Генерирует Organization или SoftwareApplication JSON-LD из данных краулера.

OrganizationSoftwareApplicationWebSiteLocalBusinesssameAs linksNAP data
FAQ Generator~90 lines
geo_optimizer/fix/faq.py

Создаёт FAQPage JSON-LD. С --api-key использует Gemini для генерации вопросов из контента.

FAQPage JSON-LDGemini AI questionsschema.org/QuestionacceptedAnswer8-12 Q&A pairs
llms.txt Generator~70 lines
geo_optimizer/fix/llms_txt.py

Создаёт llms.txt — это robots.txt для AI-агентов. Claude, GPT-4 и Perplexity его читают.

llmstxt.org standardMarkdown formatKey pages linkedBusiness descriptionContact info
Citation Monitor~300 lines
backend/app/monitor/

Проверяет упоминается ли домен в ответах ChatGPT, Perplexity, Gemini и Яндекс.

ChatGPT (Responses API)Perplexity Sonar citations[]Gemini grounding chunksYandex text detection

Методология скоринга

Веса основаны на исследовании Princeton GEO и исследованиях частоты цитирований ChatGPT, Perplexity и Gemini.

Schema.org25 pts

Organization / SoftwareApplication / WebSite с богатыми атрибутами.

robots.txt20 pts

Проверяет 10+ AI-краулеров: GPTBot, ClaudeBot, PerplexityBot, Applebot-Extended, Bytespider, cohere-ai и другие.

FAQ Schema20 pts

FAQPage JSON-LD. Исследования показывают +41% к частоте цитирований без FAQ schema.

Content depth15 pts

Количество слов, структура заголовков, внутренние ссылки. Тонкие страницы (<300 слов) дают около нуля.

Brand signals10 pts

sameAs ссылки (LinkedIn, GitHub, Wikipedia), телефон, адрес. Выше авторитет бренда = больше AI-цитирований.

Freshness10 pts

dateModified или заголовок Last-Modified. Страницы старше 12 месяцев дают 0; младше 3 месяцев — полные 10.

Хочешь полный аудит?

CLI проверяет одну страницу. causabi.com глубоко краулит весь сайт, мониторит цитирования в ChatGPT/Perplexity еженедельно и генерирует фиксы с AI.