{
  "markdown": "# MCP-сервер для Почты России — отслеживание посылок и расчёт доставки через ИИ\n\n[![npm](https://img.shields.io/npm/v/@theyahia/pochta-russia-mcp)](https://www.npmjs.com/package/@theyahia/pochta-russia-mcp)\n[![CI](https://github.com/theYahia/pochta-russia-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/theYahia/pochta-russia-mcp/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nЕсли вы искали, как отследить отправление Почты России по трек-номеру из чата, посчитать тариф и срок доставки или найти индекс и ближайшее отделение — это оно. 6 инструментов: трекинг, расчёт стоимости и сроков, поиск отделений, индексы, нормализация адресов. Спрашиваете «где посылка 12345678901234» — получаете статус, а не страницу с капчей.\n\n## Возможности (6 инструментов)\n\n| Инструмент | Описание | Что требуется |\n|---|---|---|\n| `track` | Отслеживание отправления по трек-номеру | `POCHTA_LOGIN` + `POCHTA_PASSWORD` (SOAP-трекинг) |\n| `calculate` | Расчёт стоимости и сроков доставки | `POCHTA_TOKEN` + `POCHTA_LOGIN` + `POCHTA_PASSWORD` |\n| `delivery_time` | Расчёт сроков доставки между индексами | `POCHTA_TOKEN` + `POCHTA_LOGIN` + `POCHTA_PASSWORD` |\n| `get_offices` | Поиск почтовых отделений | `POCHTA_TOKEN` + `POCHTA_LOGIN` + `POCHTA_PASSWORD` |\n| `zip_lookup` | Информация по почтовому индексу | `POCHTA_TOKEN` + `POCHTA_LOGIN` + `POCHTA_PASSWORD` |\n| `normalize_address` | Нормализация адреса через API | `POCHTA_TOKEN` + `POCHTA_LOGIN` + `POCHTA_PASSWORD` |\n\n## Быстрый старт\n\n### Claude Desktop / Cursor / Windsurf (stdio)\n\n```json\n{\n  \"mcpServers\": {\n    \"pochta\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@theyahia/pochta-russia-mcp\"],\n      \"env\": {\n        \"POCHTA_TOKEN\": \"<ACCESS_TOKEN>\",\n        \"POCHTA_LOGIN\": \"<LOGIN>\",\n        \"POCHTA_PASSWORD\": \"<PASSWORD>\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add pochta \\\n  -e POCHTA_TOKEN=<ACCESS_TOKEN> \\\n  -e POCHTA_LOGIN=<LOGIN> \\\n  -e POCHTA_PASSWORD=<PASSWORD> \\\n  -- npx -y @theyahia/pochta-russia-mcp\n```\n\n### Streamable HTTP\n\n```bash\nnpx @theyahia/pochta-russia-mcp --http --port=3000\n```\n\nMCP endpoint: `http://localhost:3000/mcp`\nHealth check: `http://localhost:3000/health` → `{\"status\":\"ok\",\"version\":\"…\",\"tools\":6}`\n\n## Переменные окружения\n\n| Переменная | Обязательная | Описание |\n|---|---|---|\n| `POCHTA_TOKEN` | Да | Access-токен приложения → заголовок `Authorization: AccessToken …` |\n| `POCHTA_LOGIN` | Да | Логин кабинета → часть `X-User-Authorization: Basic …` |\n| `POCHTA_PASSWORD` | Да | Пароль кабинета → часть `X-User-Authorization: Basic …` |\n| `POCHTA_KEY` | Нет | Back-compat: готовый `base64(login:password)` для `X-User-Authorization` (вместо LOGIN/PASSWORD) |\n| `POCHTA_TIMEOUT_MS` | Нет | Таймаут запроса в мс (по умолчанию 15000) |\n\nПолучите доступ к API: [Кабинет отправителя](https://otpravka.pochta.ru/) → Настройки → API.\nСпецификация: <https://otpravka.pochta.ru/specification>.\n\n## Авторизация\n\nREST-методы otpravka-api используют **два** заголовка (согласно официальной спецификации):\n\n- `Authorization: AccessToken <POCHTA_TOKEN>` — access-токен приложения;\n- `X-User-Authorization: Basic <base64(POCHTA_LOGIN:POCHTA_PASSWORD)>` — учётные данные кабинета.\n\nОтслеживание (`track`) использует SOAP-API трекинга (`tracking.russianpost.ru`) и требует\n`POCHTA_LOGIN` + `POCHTA_PASSWORD` (access-токен там не применяется).\n\n## ⚠️ Миграция на 2.0.0 (breaking change)\n\nВ версиях ≤ 1.x заголовки авторизации формировались неверно (access-токен и ключ были\nперепутаны местами), из-за чего REST-методы не проходили авторизацию. В 2.0.0 контракт\nисправлен:\n\n- **Было:** `POCHTA_TOKEN` + `POCHTA_KEY`. Этот набор больше не работает сам по себе.\n- **Стало:** `POCHTA_TOKEN` + `POCHTA_LOGIN` + `POCHTA_PASSWORD`.\n- `POCHTA_KEY` сохранён только как опциональный back-compat (готовый `base64(login:password)`\n  для `X-User-Authorization`).\n\n## Надёжность\n\n- Повторные попытки (до 3) с экспоненциальной задержкой на сетевые ошибки, `429` и `5xx`.\n- Таймаут запроса (по умолчанию 15 с, настраивается через `POCHTA_TIMEOUT_MS`).\n- Диагностические логи ретраев/ошибок пишутся в `stderr` (канал stdout занят MCP).\n\n## Skills (Claude Code)\n\n| Команда | Описание |\n|---|---|\n| `/track <номер>` | Отследить посылку Почты России |\n| `/calculate <от> <до> <вес>` | Расчёт стоимости отправления |\n| `/parcel <от> <до> <вес>` | Полный расчёт с ближайшим отделением |\n\n## Тесты\n\n```bash\nnpm install\nnpm run typecheck\nnpm test\n```\n\n## Лицензия\n\nMIT\n",
  "bytes": 4538,
  "sha": "634544791705f69d33fd7f23ed37f26ba7269a7ed192dd331a99e8dd6214a4ae",
  "repo_slug": "theyahia/pochta-russia-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_theyahia_pochta_russia_mcp_6d58f3e8/readme"
}