aitunnel-docs

Локальное зеркало документации docs.aitunnel.ru в виде Claude Skill — 46 страниц markdown + скрипты для регенерации зеркала через crawl4ai.

AITUNNEL — единый OpenAI-совместимый API к 100+ моделям ИИ (OpenAI, Anthropic Claude, Google Gemini, DeepSeek, Meta, Qwen) для пользователей из России без VPN.

Зачем это нужно

Когда ты задаёшь Claude вопрос про aitunnel — про лимиты, формат ключа sk-aitunnel-…, конкретный endpoint, цены на модели, как подключить Cursor / Claude Code / LangChain — модель без скилла начинает галлюцинировать или отвечать как про обычный OpenAI/OpenRouter. Этот скилл фиксирует точную копию официальной документации и роутит запросы в нужный файл.

Установка как Claude Skill

# Глобально (для всех проектов)
git clone https://github.com/<your-username>/aitunnel-docs.git ~/.claude/skills/aitunnel-docs

# Или в конкретный проект
git clone https://github.com/<your-username>/aitunnel-docs.git .claude/skills/aitunnel-docs

После клонирования Claude Code автоматически подхватит скилл — SKILL.md содержит описание-триггер: при упоминании «aitunnel», «sk-aitunnel-», вопросах про модели/лимиты/ ошибки aitunnel, или фразах вида «как подключить X к aitunnel» скилл активируется и загружает релевантный файл из references/.

Структура

aitunnel-docs/
├── SKILL.md                       Описание скилла + routing-таблица тем
├── references/                    46 .md — копия docs.aitunnel.ru
│   ├── _index.md                  Полное оглавление
│   ├── index.md, faq.md
│   ├── api/                       Endpoints, auth, params, streaming, limits, errors
│   │   └── responses/             Responses API (overview / basic / reasoning / tools / web search)
│   ├── features/                  Prompt caching, structured outputs, tool calling, vision, TTS, …
│   ├── guide/                     API-ключи, оплата
│   ├── guides/                    Интеграции: Cursor, Claude Code, Codex CLI, LangChain, Xcode, …
│   └── external/                  aitunnel.ru/models — список моделей с ценами
└── scripts/
    ├── scrape_aitunnel.py         crawl4ai → sitemap docs.aitunnel.ru + aitunnel.ru/models
    ├── postprocess.py             чистка VitePress-мусора (Skip to content, Pager, якоря)
    ├── link_rewrite.py            абсолютные docs.aitunnel.ru-ссылки → относительные + _index.md
    ├── scrape_clean.py            опц.: PruningContentFilter pass
    └── update.ps1                 одна команда — для Windows / pwsh

Каждый файл в references/ имеет YAML-frontmatter с полями title, source_url (исходная страница на docs.aitunnel.ru) и crawled_at (timestamp последнего скрейпа).

Обновление документации

В Claude Code достаточно сказать «обнови документацию aitunnel» / «refresh aitunnel docs» — скилл сам запустит цепочку. Вручную:

# Windows / PowerShell
pwsh -File scripts/update.ps1

# Linux / macOS
PYTHONUTF8=1 \
AITUNNEL_DOCS_OUTPUT="$(pwd)/references" \
python scripts/scrape_aitunnel.py && \
python scripts/postprocess.py && \
python scripts/link_rewrite.py

Скрипт делает три прохода:

1. scrape_aitunnel.py — fetch sitemap docs.aitunnel.ru (~48 URL) + aitunnel.ru/models через crawl4ai. При провалах — автоматический retry с увеличенным таймаутом.
2. postprocess.py — чистит VitePress-мусор: «Skip to content», навигация, Pager, якорные ссылки.
3. link_rewrite.py — абсолютные docs.aitunnel.ru-ссылки переписывает в относительные пути и регенерирует references/_index.md.

Зависимости

• Python 3.9+
• crawl4ai (требует Playwright Chromium — crawl4ai-setup доустанавливает браузер)
• httpx

pip install crawl4ai httpx
crawl4ai-setup

Windows: переменная PYTHONUTF8=1 обязательна — без неё crawl4ai/rich падают на cp1251 при выводе Unicode. update.ps1 ставит её сам.

При провалах какие-то URL попадут в references/_failed.txt (создаётся только при провалах, в .gitignore) — повторный запуск скрипта сделает второй проход с увеличенным таймаутом.

Лицензия

Содержимое references/ — официальная документация AITUNNEL (docs.aitunnel.ru), принадлежит правообладателю сервиса. Скрипты в scripts/ — MIT.