Потолок Context7: как собрать бесплатную связку для свежих доков AI-агента

Разработчик заметил, что его AI-агент начал выдавать устаревший код — z.string().email() вместо z.email(), Next 15 вместо 16. Причина: Context7 на бесплатном тарифе исчерпал кварту, сервер молча вернул пустоту, и агент стал полагаться на память. Это подтолкнуло автора системно проверить, не появились ли за полтора года более эффективные инструменты.

Он протестировал 8 методов доставки документации в контекст на одном токенайзере, замерив реальное количество токенов, скорость и точность. Победил Ref — платный сервис. Дважды автор едва не отбраковал инструменты, ошибка оказалась в его собственном вызове API, а не в самих решениях.

Итоговая сборка: локальный слой @neuledge как основной источник (миллисекунды, работа без сети, без лимитов) и Context7 free в качестве fallback'а. Автор проверил, что связка переживает квоту free-тарифа, и поделился методологией, таблицами замера, двумя рассказами о near-miss и миграционным китом для агента.