12306 — скилл для Claude Code: расписания и билеты КЖД
Скилл спрашивает у официального API 12306 расписание поездов, остаток мест и список станций. Пригодится, когда нужно спланировать поездку по Китаю прямо в чате.
npx skills add kirorab/12306-skill --skill 12306 -a claude-codeЧто делает 12306
Скилл даёт агенту два скрипта на Node.js. query.mjs принимает города или точные станции и возвращает поезда: тип, время отправления и прибытия, длительность, наличие мест по классам. stations.mjs показывает, какие станции относятся к городу — это важно, потому что запрос по названию города вернёт поезда со всех его вокзалов, а не только с главного. В Ухане это, например, 武汉站, 汉口站, 武昌站 и 武汉东站.
Формат вывода выбирается флагом: по умолчанию пишется HTML-файл, а -f md печатает таблицу в чат. Есть фильтры по типу поезда (-t G), диапазону отправления и прибытия, максимальной длительности в пути, наличию билетов и типу места. Флаг --json отдаёт сырые данные — на них удобно проверять точные имена станций при пересадке.
Ключ API не нужен, данные идут напрямую с 12306. Для работы требуется Node.js. Список станций кэшируется на 7 дней в {baseDir}/data/stations.json. При планировании пересадки берите оба сегмента через один и тот же вокзал: разные станции одного города — это дополнительная дорога, а не короткая пересадка.
Какие задачи решает
- посмотреть, какие поезда идут из Пекина в Шанхай на нужную дату
- отфильтровать только утренние высокоскоростные рейсы до двух часов в пути
- проверить, остались ли места в сидячем вагоне второго класса
- уточнить, какие вокзалы есть в городе, прежде чем строить маршрут
- сверить станции отправления и прибытия при пересадке
Примеры запросов агенту
- Покажи поезда из 北京 в 上海 на завтра, только G, таблицей
- Какие станции есть в 武汉?
- Найди рейсы 深圳 → 长沙 с отправлением до полудня и свободными местами
Как установить 12306
1Через Skills CLI (Vercel)
npx skills add kirorab/12306-skill --skill 12306 -a claude-code2Вручную: положить файлы
~/.claude/skills/12306/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/12306/
1Через Skills CLI (Vercel)
npx skills add kirorab/12306-skill --skill 12306 -a codex2Вручную: положить файлы
.agents/skills/12306/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add kirorab/12306-skill --skill 12306 -a cursor2Вручную: положить файлы
.cursor/skills/12306/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install kirorab/12306-skill 123062Вручную: положить файлы
.github/skills/12306/SKILL.md1Через Skills CLI (Vercel)
npx skills add kirorab/12306-skill --skill 12306 -a gemini-cli2Командой платформы
gemini skills install https://github.com/kirorab/12306-skillВручную: положить файлы
.devin/skills/12306/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add kirorab/12306-skill --skill 12306 -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о 12306
Как установить 12306 в Claude Code?
Выполните npx skills add kirorab/12306-skill --skill 12306 -a claude-code. Скилл появится в ~/.claude/skills/12306/SKILL.md.
Что делает скилл 12306?
Запрашивает у официального API 12306 расписание поездов, остаток билетов и сведения о станциях. Работает с поездами типов G, D, Z, T и K.
Нужен ли ключ API?
Нет, данные берутся напрямую с 12306. Для запуска скриптов нужен Node.js.