global-stock-data — скилл
Скилл с данными по американским и мировым рынкам: опционы, VIX, короткие продажи, сделки инсайдеров, ставки и курсы, без ключей API
- 1 840 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Код ходит в десяток внешних источников, часть из них в условиях запрещает автоматический доступ, и ответственность за соблюдение условий лежит на вас
- Имя и почта из `SEC_CONTACT` уходят в заголовок User-Agent запросов к SEC
- Скилл выполняет встроенный Python, который стоит просмотреть до первого запуска
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/global-stock-dataОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Код ходит в десяток внешних источников, часть из них в условиях запрещает автоматический доступ, и ответственность за соблюдение условий лежит на вас
- Имя и почта из `SEC_CONTACT` уходят в заголовок User-Agent запросов к SEC
- Скилл выполняет встроенный Python, который стоит просмотреть до первого запуска
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
global-stock-data — один файл `SKILL.md` со встроенным кодом на Python. Он сводит данные, разбросанные по десятку источников, в набор вызовов для агента и освобождает от возни с префиксами Eastmoney, авторизацией Yahoo и сопоставлением CIK в SEC EDGAR. Автор насчитывает 16 слоев, свыше 50 точек доступа и 17 источников, и ни одному не нужен ключ. В составе котировки и свечи (для США с 1984 года, для Японии, Тайваня, Кореи, Индии и Европы через суффикс тикера), индикаторы MA, MACD, RSI и Боллинджер, считаемые локально, отчетность и метрики XBRL. Отдельно выделены опционы CBOE с греками и потоком 0DTE, индекс VIX с 1990 года и срочная структура, ежедневный объем коротких продаж и данные FINRA о коротких позициях, поток документов SEC (Form 4 по сделкам инсайдеров, 8-K, 13F), скринер на данных EDGAR, кривая доходности Казначейства, отчеты CFTC и ставки 38 центробанков. Каждый источник помечен уровнем лицензии, его условия приведены дословно. Проект распространяет только код, данные пользователь забирает сам по правилам каждого источника.
Для кого. Для частных инвесторов и аналитиков, которые просят Claude Code или Codex собрать рыночные данные США и мира и хотят видеть, на каких условиях доступен каждый источник.
Подходит, если
- Нужна цепочка опционов CBOE с греками и оценка потока 0DTE по тикеру
- Нужна история VIX с 1990 года и срочная структура, чтобы отличить контанго от бэквордации
- Надо посмотреть сделки инсайдеров по Form 4 и квартальные позиции фондов по 13F с весами
- Нужны ставки центробанков, SOFR, курсы ЕЦБ и результаты аукционов Казначейства одним запросом
- Нужен скринер по всему рынку США на данных EDGAR по любому тегу XBRL
Не подходит, если
- Вы строите коммерческий продукт: автор советует брать только источники уровня S, остальные для личных исследований
- Нужны потоковые котировки в реальном времени для торговли: скилл делает запросы по требованию
- Нужны данные гонконгской биржи по CCASS: этот слой автор удалил из-за условий источника
Пример запроса к агенту
Покажи VIX и его срочную структуру на сегодня и сделки инсайдеров по Apple за последние 30 днейОграничения
- Перед работой со слоями SEC в `SKILL.md` нужно указать настоящие имя и почту в `SEC_CONTACT`: SEC отклоняет запросы без заявленного User-Agent, и код сообщит об ошибке, если поле пустое.
- Лицензионные уровни разные. Уровень S разрешает коммерческое использование (EDGAR, Казначейство, ФРС, ЕЦБ, BIS, TWSE и другие). FINRA и спотовые цены EIA относятся к уровню B, CBOE, Eastmoney, Sina и Tencent к уровню C, Yahoo и Nasdaq к уровню D, то есть для личного изучения на свой страх.
- Для коммерческих задач опирайтесь только на уровень S. Тайваньский слой отдает данные только за последний торговый день, историю дает Yahoo.
- Нужны Python 3.9 и новее и пакет `requests`, на Windows еще `tzdata`. Код проверен автором с Claude Code, в Codex и OpenClaw `SKILL.md` вставляется в контекст.
Как отключить. Удалите папку `~/.claude/skills/global-stock-data`. Для Codex и OpenClaw уберите вставленный текст `SKILL.md` из системного промпта или файла контекста проекта.
Частые вопросы
Как установить global-stock-data в Claude Code?
Создайте папку `~/.claude/skills/global-stock-data`, скачайте в нее `SKILL.md` по адресу из README и выполните `pip install requests`. Затем впишите имя и почту в `SEC_CONTACT`. После запуска Claude Code скажите, например, «проверь отчетность AAPL», и скилл включится сам.
Нужны ли ключи API?
Нет, все 17 источников работают без авторизации. Для слоев SEC требуется только заявленный контакт в User-Agent.
Можно ли использовать данные в коммерческом продукте?
Только из источников уровня S: EDGAR, Казначейство, ФРС, ЕЦБ, BIS, TWSE и других. Автор отдельно предупреждает, что слово «официальный» не значит «бесплатный для любого использования». Остальные уровни он отводит под личные исследования.
Что делать с Codex или OpenClaw?
Вставьте `SKILL.md` в системный промпт или файл контекста проекта. Встроенный Python выполнится как есть, потому что файл устроен как размеченный Markdown со встроенным кодом.
Какие рынки кроме американского покрыты?
Свечи с Yahoo через суффикс тикера идут для Японии, Тайваня, Кореи, Индии, Европы и Гонконга. Для Тайваня есть официальные API TWSE и TPEx, для глобальных ставок и курсов слои BIS, ЕЦБ, ФРС и Нью-Йоркского ФРС.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл с данными рынка акций Китая: котировки, отчеты, финансы, новости и еще 11 категорий из 34 источников без ключей
Скилл запрашивает у Arkvol данные по рынкам Китая, Гонконга и США и пересказывает их с датой, показателями и границами применения
Скилл отвечает на вопросы о вероятностях событий по рыночным данным: прогнозные рынки, ставки, доходности, деривативы
Скилл помогает агенту получать данные китайских акций и сохранять ответы источников вместе с временем и пропусками
Пять скиллов для анализа инвестиций: отчетность техкомпаний, ценностное инвестирование, настроения рынка, ликвидность США и цикл биткоина
Скилл и MCP-сервер дают агенту котировки, свечи и поиск тикеров по рынкам Китая, Гонконга и США
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| global-stock-data (эта карточка) | нет | 1 840 | ||
| a-stock-data | нет | 11 554 | данные китайского рынка акций, а global-stock-data делает упор на США и мировые ставки | |
| FinanceMCP | нет | ключ необязателен | 869 | MCP-сервер финансовых данных, а здесь один файл скилла без отдельного процесса |
Коротко о README
В README разобраны архитектура из 16 слоев, шкала лицензионных уровней с цитатами из условий источников, быстрый запуск за три шага, перечень точек доступа по группам (цена, оценка, потоки, документы, макро, ставки, Тайвань, энергетика) и ответы на вопросы. Отдельно объяснено, почему слой гонконгской биржи удален, а Yahoo и Nasdaq оставлены.
Бейдж для README
Исходный SKILL.md
--- name: global-stock-data description: 美股港股全栈数据工具包(官方源优先)— 十六层架构·50+端点·17数据源·全部零鉴权。在原有行情/K线/技术指标(MA/MACD/RSI/KDJ/布林带)/基本面/资金面/期权/SEC Filing/工具八层之上,新增:CBOE官方期权链(完整希腊字母+IV+0DTE流+异动识别)、FINRA全市场每日空头成交量、SEC EDGAR申报事件流(Form4内部人/8-K/13F机构持仓)、EDGAR全市场横截面筛选、美债收益率曲线/CFTC COT/财报日历;V2.1 新增全球利率汇率层(BIS 38家央行政策利率、欧洲央行汇率/利率/欧元区收益率曲线、纽约联储SOFR/EFFR、美联储H.10汇率/H.6货币存量、美国财政部国债拍卖/联邦债务),Yahoo K线修复全历史日线与时区并支持日本/台湾/韩国/印度/欧洲等市场代码;V2.2 新增CBOE波动率指数历史与VIX期限结构、FINRA做空余额(每月两期)、SEC Form 4内部人逐笔交易与13F机构持仓解析、台股官方OpenAPI(证交所+柜买中心,可商用)、美国能源信息署EIA原油/天然气价格与库存。每个数据源标注合规级别与条款原文。内嵌全部调用代码,自包含零依赖外部文件。适用于美股港股个股分析、全市场筛选、财报解读、期权与0DTE策略、做空数据追踪、内部人交易与13F持仓、SEC文件检索、资金流与机构持仓分析、全球利率汇率与央行政策跟踪、VIX波动率、台股、原油天然气等场景。 origin: custom version: 2.2.0 --- > 📦 项目主页:https://github.com/simonlin1212/global-stock-data — 更新、反馈、支持作者 > > 作者:Simon 林 · X [@linsizhen](https://x.com/linsizhen) · 邮箱:simonlin0423@gmail.com # 美股港股全栈数据工具包 V2.2 — 官方源优先 十六层数据架构,50+ 个端点,17 个数据源,全部零鉴权,实测可用(2026-07-24 全量回归验证;V2.1 新增与修复部分 2026-10-11 实测;V2.2 新增部分 2026-10-12 实测)。层数按「原有八层 + V2.0 五层(CBOE 期权链单算一层)+ V2.1 一层 + V2.2 两层(台股、能源)」计;V2.2 的波动率指数、做空余额、Form 4 / 13F 解析是原有层里的新小节,不另计层。 **V2.0 设计原则:官方源优先。** 新增层的主力数据取自美国政府(SEC EDGAR / Treasury / CFTC)、 自律组织(FINRA)与交易所(CBOE / Nasdaq)的公开端点;V2.1 再加国际清算银行、欧洲央行、 美联储、纽约联储四家官方机构;V2.2 再加台湾证交所、柜买中心与美国能源信息署 EIA。**每个数据源都标注了合规级别与条款原文** (见下方「数据源合规分级」)——"官方"不等于"可自由使用",各源差异极大。 **本工具只分发代码,不分发、不转售任何市场数据**;数据由使用者自行按各源条款获取。 **使用方式:** 将本文件放入 `~/.claude/skills/global-stock-data/SKILL.md`,Claude Code 会自动识别并在美股/港股相关对话中激活。 ``` 行情层(实时/延时) ├── 新浪财经 → 美股 gb_XXXX 36字段 / 港股 rt_hkXXXXX 25字段 ├── 腾讯财经 → 美股 usXXXX 71字段 / 港股 r_hkXXXXX 78字段 └── 东财 push2 → 美股/港股 secid 实时行情,含中文名/涨跌幅/换手率 K线层(日/周/月/分钟) ├── 新浪 → 美股日K (回溯至1984年) └── Yahoo chart → 美股+港股+日本/台湾/韩国/印度/欧洲等 (v8 API, 零crumb, 全历史日线) [D级] 技术指标层(纯计算,零额外依赖) └── MA/EMA + MACD + RSI + KDJ + 布林带 基于K线OHLCV,纯Python计算 基本面层 ├── 东财 datacenter → 美股/港股三表(资产负债+利润+现金流) + GMAININDICATOR(关键指标) ├── Yahoo crumb → 23个模块(财务数据+关键指标+分析师+机构持仓) └── SEC EDGAR XBRL → 美股503个GAAP指标 (仅美股) 资金面层 └── 东财 push2his → 日级资金流(主力/大单/中单/小单) 美股+港股