Сравнение 8 способов доставки документации в контекст ИИ-агента: победитель Ref, но есть бесплатная альтернатива

После полутора лет использования Context7 автор столкнулся с проблемой: бесплатный лимит исчерпан, сервер молча возвращает пустой ответ, а агент пишет на устаревшем коде (например, z.string().email() вместо z.email(), Next 15 вместо 16). Это подтолкнуло к системному сравнению 8 альтернатив на одном токенайзере — по объёму контекста, стоимости в токенах и точности.

Победителем оказался Ref, но он платный. Дважды автор чуть не исключил достойные инструменты — ошибка была в его вызове API, а не в них. В итоге собрана бесплатная связка: локальный @neuledge как основной слой (миллисекунды, работа без сети и лимитов) + Context7 free как fallback. Проверил, переживёт ли квота free-тарифа — результат в статье.

Внутри: методология тестирования, таблица сравнения, разбор двух near-miss-ситуаций и миграционный кит для настройки агента. Статья будет полезна разработчикам, которые хотят оптимизировать подачу документации в контекст LLM-агентов.