{
  "markdown": "<!-- mcp-name: io.github.atomno-mcp/mcp-zakupki -->\n\n# atomno-mcp-zakupki\n\nMCP-сервер госзакупок: поиск тендеров на [zakupki.gov.ru](https://zakupki.gov.ru), история заказчиков и поставщиков, справочник ОКПД2. Законы 44-ФЗ, 223-ФЗ и 615-ПП — прямо в Cursor, Claude и любом клиенте MCP.\n\nRussian public procurement search for AI agents.\n\n[![PyPI version](https://img.shields.io/pypi/v/atomno-mcp-zakupki.svg)](https://pypi.org/project/atomno-mcp-zakupki/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)\n[![MCP](https://img.shields.io/badge/MCP-2025--06--18-purple.svg)](https://modelcontextprotocol.io)\n\nУстановили локально, прописали в конфиге Cursor / Claude Desktop / Cline —\nи в одном промпте просите: *«Покажи свежие тендеры за сегодня по ОКПД2\n62.0 в Москве с НМЦК ≤ 5 млн ₽»*. Сервер сходит в выбранный источник\nданных, нормализует ответ и вернёт LLM готовую структуру.\n\n## Зачем\n\n| Боль | Сейчас | С `atomno-mcp-zakupki` |\n|---|---|---|\n| Каждое утро 30–60 мин просеивать ЕИС вручную или платить 16–67 K ₽/год за Контур / Seldon | Excel-сводки + email-уведомления | Один MCP-вызов из Cursor → LLM сама фильтрует, объясняет, сравнивает |\n| Скрипты на Python с `ftp.zakupki.gov.ru` сломались с января 2025 | Ищут замену через коммерческие API | Официальный сайт ЕИС: поиск, XML-карточка, карточка организации |\n| AI-агент не может прочитать тендер сам | Копи-паст в чат | `get_tender(reg_number)` отдаёт всю карточку как JSON |\n\n## Что внутри (open-клиент)\n\n| Tool | Что делает |\n|---|---|\n| `search_tenders` | Поиск закупок на официальном сайте `zakupki.gov.ru`. Ключ не нужен. |\n| `get_tender` | Карточка закупки по реестровому номеру (официальная XML-печатная форма). |\n| `lookup_okpd2` | Поиск кода ОКПД2 / КТРУ по тексту (локальный справочник, без сети). |\n| `get_customer_history` | Карточка заказчика по ИНН и статус в реестре недобросовестных. Сводку объёмов сайт не считает. |\n| `get_supplier_stats` | Сводка по поставщику. Без токена машинного обмена ЕИС недоступна — тулза вернёт отказ, не нули. |\n\n> Источник по умолчанию — официальный сайт ЕИС. Покупной посредник отключён.\n> Сводка объёмов и статистика поставщика без токена машинного обмена недоступны.\n\n## Quick start\n\n### 1. Установка\n\n```bash\n# Через uvx (рекомендуется — без установки в систему):\nuvx atomno-mcp-zakupki --help\n\n# Через pipx:\npipx install atomno-mcp-zakupki\natomno-mcp-zakupki --version\n\n# В виртуальное окружение проекта:\npip install atomno-mcp-zakupki\n```\n\nОпциональный экстра для официального ЕИС-токена (требует сертификат Минфина):\n\n```bash\npip install \"atomno-mcp-zakupki[eis-official]\"\n```\n\n### 2. Конфигурация\n\nПоиск и карточка закупки работают без ключа — источник `zakupki.gov.ru`.\nПокупной посредник и SOAP-токен ЕИС не обязательны.\n\n| Переменная | Описание | Где взять |\n|---|---|---|\n| `MCP_ZAKUPKI_DAMIA_KEY` | API-ключ DaMIA API-Закупки | <https://damia.ru/apizakupki> (free-тариф «Старт» ≈ 100 запросов/мес) |\n| `MCP_ZAKUPKI_GOSPLAN_KEY` | API-ключ ГосПлан API v2 | <https://wiki.gosplan.info> (sandbox без регистрации: `fz44test.gosplan.info`) |\n| `MCP_ZAKUPKI_NAVODKI_KEY` | API-ключ navodki.ru | <https://navodki.ru> |\n| `MCP_ZAKUPKI_EIS_TOKEN` | Токен ЕИС (через `pmd/auth/welcome`) | <https://zakupki.gov.ru/pmd/auth/welcome> + сертификат Минфина |\n| `MCP_ZAKUPKI_API_KEY` | **Pro hosted** — обязателен для `get_customer_history` / `get_supplier_stats` и будущих AI-тулов | <https://atomno-mcp.ru/pricing#zakupki-pro> |\n| `MCP_ZAKUPKI_LOG_LEVEL` | DEBUG / INFO / WARNING / ERROR / CRITICAL | по умолчанию `INFO` |\n| `MCP_ZAKUPKI_CACHE_DB` | Путь к SQLite-кэшу | каталог данных пользователя (`%LOCALAPPDATA%/atomno/` или `~/.local/share/atomno/`) |\n| `MCP_ZAKUPKI_PROVIDERS` | Цепочка источников | по умолчанию `eis_public` |\n| `MCP_ZAKUPKI_RPS` | Лимит запросов в минуту | по умолчанию `30` |\n\n### 3. Подключение к Cursor\n\nОткройте `~/.cursor/mcp.json` (или `Cursor → Settings → Model Context\nProtocol`) и добавьте:\n\n```json\n{\n  \"mcpServers\": {\n    \"zakupki\": {\n      \"command\": \"uvx\",\n      \"args\": [\"atomno-mcp-zakupki\"],\n      \"env\": {\n        \"MCP_ZAKUPKI_LOG_LEVEL\": \"INFO\"\n      }\n    }\n  }\n}\n```\n\n### 4. Подключение к Claude Desktop\n\n`%APPDATA%\\Claude\\claude_desktop_config.json` (Windows) или\n`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"zakupki\": {\n      \"command\": \"uvx\",\n      \"args\": [\"atomno-mcp-zakupki\"]\n    }\n  }\n}\n```\n\n### 5. Подключение к Cline / Goose / Kiro\n\nЛюбой MCP-клиент: запустите `atomno-mcp-zakupki` (по умолчанию stdio\nтранспорт) и пропишите в его конфиге команду запуска.\n\nДля HTTP-режима:\n\n```bash\natomno-mcp-zakupki --transport http --host 127.0.0.1 --port 8765\n```\n\n## Примеры\n\n### Утренний мониторинг тендеров\n\n```\n[Cursor]: Покажи свежие тендеры за сегодня по ОКПД2 62.0 в УрФО\n          с НМЦК 500K-3M ₽, СМП-only.\n\n→ search_tenders(\n    okpd2_codes=[\"62.01\", \"62.02\", \"62.09\"],\n    regions=[\"66\", \"74\", \"59\", \"45\", \"72\", \"86\", \"89\"],\n    price_min_rub=500000, price_max_rub=3000000,\n    smp_only=True,\n    publish_date_from=\"2026-04-26\",\n    status=[\"applications_open\"]\n  )\n← 7 тендеров найдено за 412 мс.\n```\n\n### Карточка тендера\n\n```\n[Cursor]: Расскажи подробно про реестровый номер 0173100007426000018.\n\n→ get_tender(reg_number=\"0173100007426000018\", include_documents=True)\n← Все поля: заказчик, НМЦК, документация (PDF), сроки, площадка...\n```\n\n### Анализ заказчика (Pro)\n\n```\n[Cursor]: Кто такой ИНН 7449023800? Покажи историю закупок за 2 года.\n\n→ get_customer_history(inn=\"7449023800\", period_from=\"2024-01-01\")\n← Требуется MCP_ZAKUPKI_API_KEY (hosted Pro).\n```\n\n### Подбор кода ОКПД2\n\n```\n[Cursor]: Какой ОКПД2 у разработки веб-портала?\n\n→ lookup_okpd2(query=\"разработка веб-портала\", limit=5)\n← [{\"code\":\"62.01.11.000\",\"name\":\"Услуги по проектированию ИС\",\"match\":0.94}, ...]\n```\n\n## CLI\n\n```text\natomno-mcp-zakupki --help\natomno-mcp-zakupki --version\natomno-mcp-zakupki --check-config\natomno-mcp-zakupki --log-level DEBUG\natomno-mcp-zakupki --transport http --host 127.0.0.1 --port 8765\natomno-mcp-zakupki --transport sse --port 9000\n```\n\nПолный список опций — в `atomno-mcp-zakupki --help`.\n\n## Источники данных\n\n| Источник | Что отдаёт | Когда используется |\n|---|---|---|\n| **ЕИС, официальный сайт** | Поиск, XML-карточка, карточка организации, реестр недобросовестных | По умолчанию, без ключа |\n| **SOAP ЕИС** (`int.zakupki.gov.ru`) | Машинная выгрузка | Только с токеном после регистрации на портале |\n| **DaMIA / ГосПлан / navodki** | Коммерческие API | Только если явно заданы в `MCP_ZAKUPKI_PROVIDERS` и есть ключ |\n\nЦепочка по умолчанию: `MCP_ZAKUPKI_PROVIDERS=eis_public`.\nЕсли источник не ответил, тулза вернёт типизированную ошибку\n`provider_unavailable` или `not_implemented` — не пустой список.\n\n## Архитектура (вкратце)\n\n```\nAI-клиент (Cursor / Claude / Cline) ──MCP──▶ atomno-mcp-zakupki\n                                              │\n                                              ├──▶ lookup_okpd2 (offline)\n                                              ├──▶ Self-hosted API (search/get)\n                                              └──▶ hosted Pro (api.atomno-mcp.ru) — production\n```\n\nВсе провайдеры реализуют общий `BaseProvider`-интерфейс. Ответы\nнормализуются в Pydantic-модели `Tender`, `Customer`, `Document`,\n`OrgHistorySummary`.\n\n## Разработка\n\n```bash\ngit clone https://github.com/atomno-mcp/mcp-zakupki.git\ncd mcp-zakupki\n\npython -m venv .venv\nsource .venv/bin/activate            # Linux/macOS\n# .venv\\Scripts\\activate              # Windows\n\npip install -e \".[dev]\"\npytest -v --cov=src/mcp_zakupki\nruff check src tests\n```\n\n## Disclaimer\n\n- Сервис **не аффилирован** с Министерством финансов РФ, ФАС, оператором ЕИС\n  или конкретными ЭТП.\n- Данные берём с официального сайта ЕИС (`zakupki.gov.ru`) по обычным\n  публичным адресам, с официальными корневыми сертификатами Минцифры.\n- Машинный обмен SOAP требует токен и регистрацию на портале — без этого\n  сводка объёмов и статистика поставщика недоступны.\n- Используйте на свой риск. Решения о подаче заявок на тендеры — на\n  ответственности пользователя.\n\n## Лицензия\n\n[MIT](LICENSE) © 2026 Atomno.\n\n## Семья MCP-серверов atomno\n\n`atomno-mcp-zakupki` — пятый сервер семьи `atomno-mcp-*`:\n\n- [`atomno-mcp-cbr-rates`](https://github.com/atomno-mcp/mcp-cbr-rates) — курсы ЦБ РФ\n- [`atomno-mcp-egrul`](https://github.com/atomno-mcp/mcp-egrul) — реквизиты юр.лиц из ЕГРЮЛ\n- [`atomno-mcp-fns-check`](https://github.com/atomno-mcp/mcp-fns-check) — налоговая благонадёжность\n- [`atomno-mcp-fssp`](https://github.com/atomno-mcp/mcp-fssp) — задолженности и исп. производства (готовится)\n- **`atomno-mcp-zakupki`** — *вы здесь*\n- [`atomno-mcp-rosreestr`](https://github.com/atomno-mcp/mcp-rosreestr) — недвижимость, кадастр (готовится)\n- [`atomno-mcp-sudact`](https://github.com/atomno-mcp/mcp-sudact) — судебная практика (готовится)\n\nПодключите все вместе — и получите полное B2G-досье по тендеру за один промпт.\n",
  "bytes": 9049,
  "sha": "8ff6d9672116357756d957cf8d20942fb8ab7e1f6ea8b6b51e3c0c41fab28d62",
  "repo_slug": "atomno-mcp/mcp-zakupki",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_atomno_mcp_mcp_zakupki_7d738fc0/readme"
}