stock-api — скилл
Скилл и MCP-сервер дают агенту котировки, свечи и поиск тикеров по рынкам Китая, Гонконга и США
- 1 986 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ходит в сеть: запрашивает котировки у публичных интерфейсов китайских финансовых порталов
- Запускается через npx и тянет пакет из npm при каждом первом вызове без закрепления версии
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/stock-apiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ходит в сеть: запрашивает котировки у публичных интерфейсов китайских финансовых порталов
- Запускается через npx и тянет пакет из npm при каждом первом вызове без закрепления версии
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
stock-api отвечает на вопросы о цене акции, истории свечей и коде бумаги по названию компании. Один пакет npm работает четырьмя способами: как библиотека TypeScript для Node.js, как скрипт для браузера, как командная строка и как MCP-сервер. Все четыре используют общую логику и одинаковые данные. Агент без MCP может прочитать файл SKILL.md из репозитория и сам вызывать команды npx stock-api. Они печатают JSON: get-stock для одной котировки, get-stocks для нескольких, get-klines для дневных, недельных и месячных свечей с опциональной корректировкой цены и search-stocks для поиска кода по названию. По умолчанию пакет по очереди пробует Tencent, Sina и Eastmoney и отдает ответ первого доступного источника, выбрать его вручную можно параметром --source. MCP-сервер отдает инструменты get_stock, get_stocks, get_klines, search_stocks и inspect_stock.
Для кого. Для разработчиков и аналитиков, которые хотят давать Claude Code, Codex или другому агенту быстрый доступ к котировкам китайских, гонконгских и американских бумаг.
Подходит, если
- Нужна текущая цена одной или нескольких бумаг, например SH510500 и SZ000651, прямо в диалоге с агентом
- Для графика или анализа нужны дневные, недельные или месячные свечи за заданное число периодов с корректировкой qfq или hfq
- Известно только название компании, например «格力电器», и агенту надо найти код бумаги, а затем котировку
- В проекте на TypeScript нужен клиент котировок без зависимостей, и тот же код вы хотите отдать агенту через MCP
Не подходит, если
- Нужны котировки российских бумаг: пакет охватывает рынки Китая, Гонконга и США
- Нужны лицензированные биржевые данные для отчетности
- Вы хотите торговать: пакет только читает данные и не выставляет заявки
Пример запроса к агенту
Покажи цену акций Gree Electric и дневные свечи за последние 20 дней, код сначала найди поиском по названию 格力电器Ограничения
- Данные идут из публичных интерфейсов Tencent, Sina и Eastmoney. Разработчик не гарантирует их точность, полноту, актуальность и доступность.
- Перед коммерческим, частым или промышленным использованием проверьте условия источников и лицензию на данные.
- Поиск через Eastmoney может не работать с зарубежных сетей и IP облачных серверов, потому что источник отдает защитный ответ. В автоматическом режиме поиск переходит на Tencent и Sina, а котировки и свечи этот сбой не затрагивает.
- Нужен Node.js 18 или новее. MCP-сервер заявляет поддержку версий протокола 2025-11-25 и 2025-06-18.
- Документация и тексты SKILL.md написаны по-китайски и по-английски.
Как отключить. Удалите блок stock-api из mcpServers в настройках клиента. В своем проекте пакет удаляется командой `npm uninstall stock-api`. Ключей и постоянных процессов он не создает.
Частые вопросы
Как поставить stock-api в Claude Code?
Добавьте в настройки MCP запись stock-api с командой npx и аргументами -y, stock-api, mcp. Если MCP не нужен, дайте агенту ссылку на SKILL.md из репозитория, и он будет запускать команды npx stock-api сам.
Какие рынки и какой формат кодов поддерживает stock-api?
Материковый Китай, Гонконг и США. Код пишется с префиксом: SH и SZ для материковых бирж, HK для Гонконга, US для США, например SH510500, SZ000651, HK02020 и USDJI.
Откуда stock-api берет котировки и что будет, если источник недоступен?
Из публичных интерфейсов Tencent, Sina и Eastmoney. Если источник не отвечает, пакет переходит к следующему. В репозитории есть значки состояния каждого интерфейса.
Можно ли использовать stock-api для торговых решений?
Это справочные данные: разработчик не дает инвестиционных советов и не обещает непрерывную работу источников.
Чем stock-api отличается от Alpha Vantage MCP?
stock-api не требует ключей и ориентирован на рынки Китая и Гонконга с поддержкой США, а источники у него публичные и бесплатные. Alpha Vantage работает через ключ и свой API с собственными лимитами.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл с данными рынка акций Китая: котировки, отчеты, финансы, новости и еще 11 категорий из 34 источников без ключей
Локальная база котировок и ETF китайского фондового рынка A-share с MCP-сервером для запросов на естественном языке
Скилл ищет узкие места в цепочке поставок отрасли и отбирает акции китайских бирж, Гонконга и США с проверкой по котировкам
13 скиллов для квантовой торговли на рынке китайских A-акций: данные AKShare и BaoStock, бэктесты Backtrader и RQAlpha, документация QMT и JoinQuant
Неофициальный клиент Yahoo Finance с MCP-сервером, CLI и агентским скиллом: котировки, история цен, финансовые отчеты и опционы для агента
Claude for Financial Services CN
claude-for-financial-services-cn
Неофициальный набор из 63 скиллов для Claude Code: DCF, сравнение компаний, LBO, отчеты и деки по китайским акциям с данными Wind, iFind и AkShare
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| stock-api (эта запись) | нет | 1 986 | ||
| Alpha Vantage MCP Server | да | OAuth | 222 | официальный MCP-сервер Alpha Vantage с историческими рядами и индикаторами, работает через ключ API |
| a-stock-data | нет | 11 233 | скилл только по рынку Китая, с отчетами, финансами и новостями из десятков источников | |
| FinanceMCP | нет | ключ необязателен | 865 | MCP-сервер финансовых данных через Tushare и Binance, включая облигации, макропоказатели и крипту |
Коротко о README
Пакет без зависимостей для Node.js, браузера, командной строки и MCP, к каждому способу даны установка и примеры. Таблица сравнивает три источника и их возможности.
Бейдж для README
Исходный SKILL.md
--- name: stock-api description: Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets. Use when the user asks for a stock price, a quote, market data, candlestick/K-line data, or to look up a stock code by company name. --- # stock-api Get normalized stock market data by running the `stock-api` CLI. It covers China A-shares, Hong Kong, and US markets, with automatic provider fallback across Tencent, Sina, and Eastmoney. ## When to use - The user wants a current price or quote for one or more stocks. - The user wants K-line / candlestick history for charting or analysis. - The user knows a company name but not its code (search first, then quote). ## How to run Use `npx stock-api <command>`. Every command prints JSON to stdout. Stock codes use a market prefix: `SH` / `SZ` (China), `HK` (Hong Kong), `US` (US). Examples: `SH510500`, `SZ000651`, `HK02020`, `USDJI`. ### Get one quote ```bash npx stock-api get-stock SH510500 ``` ### Get several quotes at once ```bash npx stock-api get-stocks SH510500 SZ000651 ```