global-stock-data — скилл

Скилл с данными по американским и мировым рынкам: опционы, VIX, короткие продажи, сделки инсайдеров, ставки и курсы, без ключей API

  • 1 840 ★ репозитория
  • Последний коммит
  • Apache-2.0
Скилл

Расширенный доступ

Почему такой уровень

  • Код ходит в десяток внешних источников, часть из них в условиях запрещает автоматический доступ, и ответственность за соблюдение условий лежит на вас
  • Имя и почта из `SEC_CONTACT` уходят в заголовок User-Agent запросов к SEC
  • Скилл выполняет встроенный Python, который стоит просмотреть до первого запуска
Все причины и проверки

simonlin1212/global-stock-data

Установка

В терминале, через 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 источников без ключей

СкиллРасширенный доступ11,6 тыс.Звезды репозитория

Скилл запрашивает у Arkvol данные по рынкам Китая, Гонконга и США и пересказывает их с датой, показателями и границами применения

СкиллРасширенный доступ200Звезды репозитория

Скилл отвечает на вопросы о вероятностях событий по рыночным данным: прогнозные рынки, ставки, доходности, деривативы

СкиллРасширенный доступ909Звезды репозитория

Скилл помогает агенту получать данные китайских акций и сохранять ответы источников вместе с временем и пропусками

СкиллРасширенный доступ964Звезды репозитория

Пять скиллов для анализа инвестиций: отчетность техкомпаний, ценностное инвестирование, настроения рынка, ликвидность США и цикл биткоина

СкиллРасширенный доступ1,1 тыс.Звезды репозитория

Скилл и MCP-сервер дают агенту котировки, свечи и поиск тикеров по рынкам Китая, Гонконга и США

СкиллРасширенный доступ2 тыс.Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
global-stock-data (эта карточка)нет1 840
a-stock-dataнет11 554данные китайского рынка акций, а global-stock-data делает упор на США и мировые ставки
FinanceMCPнетключ необязателен869MCP-сервер финансовых данных, а здесь один файл скилла без отдельного процесса

Коротко о 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 → 日级资金流(主力/大单/中单/小单) 美股+港股

Сообщить о проблеме

Foxx AIglobal-stock-data
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.