Локальное зеркало docs.aitunnel.ru как Claude Skill — 46 страниц markdown про OpenAI-совместимый API к 100+ моделям ИИ для России без VPN, плюс crawl4ai-скрейпер для регенерации зеркала.
SaferSkills independently audited aitunnel-docs (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Этот скилл — обёртка над зеркалом docs.aitunnel.ru (45 страниц markdown в references/), плюс скрипты для регенерации этого зеркала. Цель — отвечать на вопросы об Aitunnel из актуальной официальной документации, а не из догадок.
Определи тему вопроса пользователя по routing-таблице ниже. Если тема явно одна — переходи к шагу 2. Если их несколько (например, «как кешировать в Python через aitunnel» = prompt-caching + python-sdk) — выбери все релевантные файлы.
Все пути ниже — относительно references/ внутри этого скилла.
| Тема вопроса | Файл |
|---|---|
Аутентификация, заголовок Authorization, формат sk-aitunnel-… | api/authentication.md |
| Создание/удаление API-ключей, лимиты на ключ, бюджеты | guide/api-keys.md |
| Оплата, баланс, тарифы, пополнение, юр.лицо | guide/payments.md |
| Список моделей и цены за 1M токенов | external/aitunnel-ru-models.md |
Какие endpoints вообще есть, общая карта /v1/* | api/reference.md |
| Специфичные методы AITUNNEL (не из OpenAI/Claude API) | api/aitunnel-methods.md |
Параметры запроса (temperature, max_tokens, top_p, seed…) | api/parameters.md |
| Стриминг (SSE), формат чанков | api/streaming.md |
| Лимиты RPS / RPM / TPM | api/limits.md |
| HTTP-ошибки, коды, обработка | api/errors.md |
Claude Messages API через Aitunnel (/v1/messages) | api/messages.md |
| Использование OpenRouter из России | api/openrouter.md |
Embeddings (/v1/embeddings) | api/embeddings.md |
Rerank (/v1/rerank) | api/rerank.md |
| Reasoning tokens (extended thinking, o-series) | api/reasoning.md |
| Moderation API | api/moderation.md |
| Responses API — обзор (что это, чем отличается от chat.completions) | api/responses/overview.md |
| Responses API — базовое использование | api/responses/basic-usage.md |
| Responses API — reasoning | api/responses/reasoning.md |
| Responses API — tool calling | api/responses/tool-calling.md |
| Responses API — встроенный web search | api/responses/web-search.md |
| Prompt caching, sticky routing, cache_read/write tokens | features/prompt-caching.md |
| Structured outputs / JSON schema / response_format | features/structured-outputs.md |
| Tool calling / function calling (для chat.completions) | features/tool-calling.md |
| Картинки и PDF на вход (vision-модели, multimodal input) | features/images-and-pdfs.md |
| Видео на вход модели | features/videos.md |
| Генерация изображений (DALL-E, Imagen, Flux и т.п.) | features/image-generation.md |
| Редактирование изображений (image-to-image) | features/image-editing.md |
| Генерация видео (text-to-video, image-to-video) | features/video-generation.md |
| TTS (text-to-speech, генерация речи) | features/text-to-speech.md |
| Аудио — STT, транскрипция, прочее аудио | features/audio.md |
| Встроенный веб-поиск как фича | features/web-search.md |
| Сжатие/трансформация истории сообщений | features/message-transforms.md |
| PII-редактирование | features/pii-redaction.md |
| Подключить Cursor | guides/cursor-integration.md |
| Подключить Claude Code | guides/claude-code-integration.md |
| Подключить Codex CLI | guides/codex-cli-integration.md |
| Подключить Qwen Code | guides/qwen-code-integration.md |
| Подключить OpenCode | guides/opencode-integration.md |
| Подключить OpenClaw | guides/openclaw-integration.md |
| Использовать через LangChain | guides/langchain-integration.md |
| Подключить Xcode | guides/xcode-integration.md |
| Использовать через Python + OpenAI SDK | guides/python-openai-sdk.md |
| Быстрый старт, hello world, base_url + первый запрос | index.md |
| Общие вопросы, поддержка, бытовые | faq.md |
Если вопрос на стыке тем или не уверен — открой references/_index.md (полное оглавление со ссылками на исходные URL docs.aitunnel.ru).
НЕ загружай всё подряд. Прочитай через Read только найденный файл (или 2-3, если вопрос составной). Каждый файл уже самодостаточен и содержит примеры на TypeScript / Python / curl где это уместно.
Frontmatter каждого файла содержит source_url — оригинальная страница на docs.aitunnel.ru. Используй её, когда нужна ссылка пользователю.
OpenAI/Claude API. У Aitunnel могут быть свои особенности (например, формат ключа sk-aitunnel-…, base_url=https://api.aitunnel.ru/v1/, специфичные методы).
на <source_url раздела> или в FAQ» вместо угадывания.
base_url/OPENAI_BASE_URL в https://api.aitunnel.ru/v1/(для Claude Messages API — https://api.aitunnel.ru/v1; уточняй по api/messages.md).
Этот скилл — про конкретно сервис Aitunnel. Не загружай его файлы, если вопрос:
В таких случаях отвечай обычным образом, без загрузки references/.
Триггеры: «обнови документацию aitunnel», «refresh aitunnel docs», «пересобери docs», «обнови docs aitunnel».
Запусти PowerShell-обёртку (она сама ставит PYTHONUTF8=1 — обязательное требование crawl4ai на Windows — и AITUNNEL_DOCS_OUTPUT в references/ скилла):
pwsh -File <путь-к-скиллу>/scripts/update.ps1Цепочка под капотом:
scrape_aitunnel.py — fetch sitemap docs.aitunnel.ru (~48 URL) + aitunnel.ru/models через crawl4ai.postprocess.py — чистит VitePress-мусор (Skip to content, Pager, якоря, навигация).link_rewrite.py — переписывает абсолютные docs.aitunnel.ru-ссылки в относительныеи регенерирует references/_index.md.
Зависимости: Python 3.9+, crawl4ai, httpx, Playwright Chromium (см. crawl4ai-setup в одноимённом пакете). На Windows установлено в %APPDATA%\Python\Python310\Scripts.
После апдейта — кратко рапортуй пользователю: сколько страниц обновлено / появилось / исчезло (можно сравнить число файлов до и после).
Если скрипт упал на скрейпе — посмотри references/_failed.txt (создаётся только при провалах) и предложи retry: python scripts/scrape_aitunnel.py уже сделает второй проход с увеличенным таймаутом автоматически.
aitunnel-docs/
├── SKILL.md (этот файл)
├── references/ (45 .md — копия docs.aitunnel.ru)
│ ├── _index.md (оглавление)
│ ├── index.md, faq.md
│ ├── api/ (13) + api/responses/ (5)
│ ├── features/ (13)
│ ├── guide/ (2), guides/ (9)
│ └── external/ (1 — список моделей с ценами)
└── scripts/
├── scrape_aitunnel.py (crawler)
├── scrape_clean.py (опц.: PruningContentFilter pass)
├── postprocess.py (чистка)
├── link_rewrite.py (ссылки + _index.md)
└── update.ps1 (обёртка для одной команды)~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.