Tax Deduction Navigator
@tax-navigator
Step-by-step claiming of Russian tax deductions (вычеты): eligibility check, document checklist, deduction calculator, Gosuslugi / lkfl2.nalog.ru navigation, and 3-НДФЛ form filling. Covers property, social, investment (ИИС), standard, and professional deductions. Use for «как получить вычет», «заполни 3-НДФЛ», «верни налог за лечение/учёбу/квартиру», «проверь право на вычет». Do NOT use for personal budgeting (personal-finance), business accounting, or complex tax disputes — recommend a licensed accountant.
Who the Tax Deduction Navigator skill is for
- Employees — claim back 13% NDFL for treatment, education, an apartment purchase, or a mortgage.
- Parents — arrange the standard deduction for children, including through the employer.
- Investors and self-employed — figure out an IIS (type A or B) and the professional deduction for civil-law income.
What you can do
- Property deduction — up to 260,000 ₽ for housing and up to 390,000 ₽ for mortgage interest (Art. 220 of the Tax Code).
- Social deduction — 13% of treatment, education, voluntary health insurance, and medicines (up to 15,600 ₽/year); high-cost treatment — with no limit.
- Investment deduction (IIS) — up to 52,000 ₽/year under type A or profit exemption under type B.
- Standard and professional — child deduction (Art. 218) and expenses of sole traders or civil-law contractors (Art. 221).
How it works
The skill runs a short interview about income and expenses, determines the applicable deductions, and calculates the refund with a formula per article of the Tax Code. It then builds a document checklist — what you have, what to obtain, and where — and finally guides you through 3-NDFL in a visible browser, with photos of 2-NDFL certificates and receipts recognized automatically. You enter the login and password yourself; automation needs the browser-use package (Python), and the skill asks permission before installing.
Useful details
- Key condition: a deduction is available when you have income taxed at 13% NDFL. Different rules apply to self-employed on NPD and the simplified regime.
- Deadlines: a deduction can be claimed for the previous 3 years (in 2026 — for 2025, 2024, 2023); the desk audit takes up to 3 months, and the transfer — another month.
- How it's paid: a one-time transfer from the FNS after 3-NDFL, or through the employer during the year.
This is general information, not tax advice: the skill is an AI, not a tax advisor, and the taxpayer bears responsibility for the return. Trust complex disputes and business accounting to a licensed specialist; the AI Lawyer handles general help, and Legal Documents can draft a formal claim.
Ready to claim your refund? Describe your situation — launch the Tax Deduction Navigator skill right now.
Is this a tax or legal consultation?
No, it's general information. The skill is an AI, not a tax advisor, and the taxpayer is responsible for the accuracy of the filed return. Trust complex tax disputes and business accounting to a licensed specialist.
Which deductions can I claim?
Property (Art. 220 — up to 260,000 ₽ for housing and up to 390,000 ₽ for mortgage interest), social (Art. 219 — treatment and education, up to 15,600 ₽/year, high-cost treatment with no limit), investment IIS (Art. 219.1 — up to 52,000 ₽/year), standard for children (Art. 218), and professional (Art. 221 — sole traders and civil-law contracts).
For which years can I get a refund?
For the previous three years. In 2026 you can file returns for 2025, 2024, and 2023. The Federal Tax Service no longer accepts earlier periods, so it's best not to delay.
Will the skill help me fill in 3-NDFL on Gosuslugi?
Yes, step by step: choosing the year, entering income from the 2-NDFL certificate, specifying deductions, checking, and submitting. The skill opens Gosuslugi or the FNS personal account in a visible browser, but you enter the login and password yourself — it doesn't sign in for you.
How long does the refund take?
A desk audit lasts up to 3 months (Art. 88 of the Tax Code), and the money transfer takes up to a month after it ends (Art. 78). In total, usually 3 to 4 months from the filing date.
Налоговый навигатор
Помощь с налоговыми вычетами и декларированием доходов в России. Навигация по Госуслугам через browser-use, поиск актуальных правил в НК РФ через web_search и web_reader.
Важно
Данный навык предоставляет информацию общего характера, а не налоговую или юридическую консультацию. Я — искусственный интеллект, а не налоговый консультант. Налоговое законодательство и практика его применения меняются. Перед принятием решений проконсультируйтесь с лицензированным специалистом. Ответственность за достоверность подаваемых деклараций несёт налогоплательщик.
Установка browser-use
Для работы навыка нужен browser-use CLI — это Python-пакет, поэтому Python должен быть установлен.
На Windows Python есть не всегда; на macOS/Linux — как правило, есть.
Прежде чем что-либо устанавливать — скажи пользователю и получи подтверждение.
Не устанавливай Python и пакеты молча и по умолчанию не запускай системные установщики
(winget/brew/apt/curl) без явного согласия.
Порядок действий:
- Проверь:
browser-use --version. Если команда есть — навык готов к работе. - Если
browser-useне установлен — объясни пользователю, что нужен Python и пакетbrowser-use, и спроси разрешение установить:pip install browser-use && browser-use install. На Windows при отсутствии Python предложи скачать установщик с python.org (обязательно с галочкой «Add Python to PATH»), затем повторитьpip install. - Если установка не удалась или пользователь отказался — не зацикливайся: честно сообщи, что автоматизация браузера сейчас недоступна, и предложи выполнить задачу вручную по шагам.
Не скрывай от пользователя команды и ошибки.
Доступные инструменты
| Инструмент | Назначение |
|---|---|
browser-use CLI | Навигация по Госуслугам, заполнение форм, подача деклараций |
web_search | Поиск актуальных ставок, правил, сроков в НК РФ |
web_reader | Чтение страниц ФНС, Госуслуг, налоговых калькуляторов |
image_analysis | Распознавание фото справок 2-НДФЛ, договоров, чеков, выписок |
Команды browser-use
browser-use --headed open "URL" # Открыть страницу в видимом браузере
browser-use state # Получить текущее состояние страницы
browser-use click "text=..." # Кликнуть по элементу
browser-use type "..." # Ввести текст в поле
browser-use eval "JS" # Выполнить JavaScript
browser-use keys "..." # Нажать клавиши
browser-use screenshot # Скриншот для анализа через image_analysis
browser-use close # Закрыть текущую сессию
browser-use close --all # Закрыть все сессии
## Рабочий процесс
### Шаг 1. Интервью с пользователем
Задай следующие вопросы (адаптируй под контекст):
1. **Доход**: Какой у вас доход за год? Какой вид дохода? (зарплата, ИП, ГПХ, аренда)
2. **Жильё**: Покупали ли вы жильё в последние 3 года? Была ли ипотека?
3. **Лечение**: Тратились ли на лечение (свое или родственников)? Сумма? Было ли дорогостоящее?
4. **Обучение**: Оплачивали обучение (свое или детей)? Сумма? Форма обучения?
5. **Дети**: Есть ли несовершеннолетние дети? Дети-инвалиды? Дети на очном обучении (18-24)?
6. **Инвестиции**: Есть ли ИИС? Какой тип (А или Б)? Сумма взноса за год?
7. **Статус**: Вы ИП, самозанятый, или работаете по трудовому договору?
8. **Вычеты ранее**: Получали ли вы налоговые вычеты раньше? Какие?
Если пользователь прислал фото справки 2-НДФЛ, договора или чека — готовые промпты для `image_analysis` — в `references/03-image-analysis.md`.
### Шаг 2. Определение применимых вычетов
На основе ответов:
1. Отметь все применимые типы вычетов
2. Рассчитай примерную сумму каждого вычета
3. Покажи пользователю итоговую таблицу:
| Тип вычета | Основание | Сумма к возврату |
|---|---|---|
| Имущественный | ст. 220 | 260 000 руб. |
| Социальный (лечение) | ст. 219 | 15 600 руб. |
| Стандартный (дети) | ст. 218 | 3 770 руб. |
| Итого | 279 370 руб. |
Полные карточки всех 5 типов вычетов (основания, лимиты, условия, расчёты, документы) — в `references/01-deductions.md`.
Дерево решений «какие вычеты применяются» — там же, в конце файла.
### Шаг 3. Расчёт сумм
Для каждого вычета покажи формулу расчёта:
Имущественный вычет: Стоимость квартиры: 5 000 000 руб. Максимум для вычета: 2 000 000 руб. Сумма вычета: 2 000 000 * 13% = 260 000 руб. НДФЛ удержанный за год: 780 000 * 13% = 101 400 руб. К возврату за этот год: 101 400 руб. Остаток на следующие годы: 260 000 - 101 400 = 158 600 руб.
Формулы расчёта для всех типов вычетов — в `references/01-deductions.md` (секция «Расчётные формулы»).
### Шаг 4. Формирование чек-листа документов
Для каждого типа вычета выведи список документов (см. секции выше). Отметь:
- Документы, которые есть у пользователя
- Документы, которые нужно получить
- Где и как получить недостающие документы
Полные списки документов по каждому типу вычета — в `references/01-deductions.md`.
### Шаг 5. Подача через Госуслуги
Полная процедура подачи 3-НДФЛ (открытие формы, заполнение, отправка), URL-паттерны Госуслуг, проверка авторизации, закрытие баннеров и модалок — в `references/02-gosuslugi.md`.
Промпты для анализа скриншотов Госуслуг и ЛК ФНС через `image_analysis` — в `references/03-image-analysis.md`.
### Шаг 6. Отслеживание статуса
```bash
# Открыть историю поданных деклараций
browser-use open "https://www.gosuslugi.ru/10042/1"
node -e "new Promise(r=>setTimeout(r,3*1000)).then(process.exit)"
# Получить статус последней декларации
browser-use state
Статусы декларации:
- «Зарегистрирована» — получена ФНС
- «На проверке» — камеральная проверка (до 3 месяцев)
- «Проверка завершена» — решение принято
- «Возврат одобрен» — деньги будут перечислены
- «Доначислено» — требуются доплаты (проверь обоснованность)
Камеральная проверка: до 3 месяцев (ст. 88 НК РФ). Перечисление денег — в течение 1 месяца после окончания проверки (ст. 78 НК РФ).
Типичные ошибки
- Пропуск срока давности — вычет можно получить за последние 3 года. Декларации старше 3 лет ФНС не принимает.
- Неполный пакет документов — самая частая причина отказа. Проверь чек-лист дважды.
- Путаница с дорогостоящим лечованием — если код услуги «2» в справке, лимит не применяется. Код «1» — входит в 120 000 руб.
- Забыли про ипотечные проценты — это отдельный вычет (до 390 000 руб.), его часто не заявляют.
- Вычет с материнского капитала — сумма МК не учитывается в расходах на жильё.
- Двойной вычет супругов — каждый супруг имеет право на вычет с 2 000 000 руб. (при стоимости от 4 000 000 руб.).
- Неправильный год возникновения права — при ДДУ право возникает в год акта приёма-передачи, а не оплаты.
- Получение через работодателя и ФНС одновременно — за один и тот же период нельзя. Выбери один способ.
- Нет дохода, облагаемого НДФЛ — без дохода (безработный, ИП на УСН) вычет не получить. Перенести на будущие периоды можно.
- ИИС закрыт раньше 3 лет — все полученные вычеты типа А придётся вернуть.
Использование web_search и web_reader
Для получения актуальной информации:
# Поиск актуальных ставок и правил
web_search "налоговый вычет 2026 имущественный изменения НК РФ ст 220"
# Проверка сроков подачи
web_search "срок подачи 3-НДФЛ 2026 налоговая декларация"
# Чтение страницы ФНС
web_reader "https://www.nalog.gov.ru/rn77/individuals/property/nalog_deduction/"
# Проверка перечня дорогостоящего лечения
web_search "перечень дорогостоящего лечения налоговый вычет 2026 код услуги 2"
Cleanup
browser-use close # закрыть текущую сессию
browser-use close --all # закрыть ВСЕ сессии
Справочные материалы (references)
Полные детали читай по мере необходимости — они НЕ загружены в этот файл:
- Вычеты — карточки всех типов вычетов, дерево решений, формулы расчёта:
references/01-deductions.md. - Госуслуги — авторизация, баннеры, заполнение и отправка 3-НДФЛ:
references/02-gosuslugi.md. - Анализ документов — промпты для справок 2-НДФЛ, договоров, чеков, скриншотов:
references/03-image-analysis.md. - Частые вопросы — короткие ответы на типовые вопросы:
references/04-faq.md.