global-stock-data

环境要求

• Python 3.9 或更高版本
• 已安装 pip，且能执行 pip install
• 使用 Claude Code，或 Codex / OpenClaw 等 AI 编程助手
• 使用 SEC 数据层前需准备真实姓名与邮箱用于声明 User-Agent

安装与启动步骤

1. 1克隆仓库

   从 GitHub 拉取 global-stock-data 项目到本地，作为后续配置与使用的基础目录。

   git clone https://github.com/simonlin1212/global-stock-data.git

   复制

2. 2进入项目目录

   切换到刚克隆下来的项目文件夹，后续命令都在此目录执行。

   cd global-stock-data

   复制

3. 3安装唯一依赖

   README 快速开始第 3 步：安装 requests 依赖，即可让内嵌 Python 代码正常运行。

   pip install requests

   复制

4. 4设置 SEC_CONTACT

   打开 SKILL.md，把 SEC_CONTACT 改成你自己的真实姓名和邮箱。SEC 要求声明 User-Agent，未声明会被判为未声明自动化工具而拒绝。

5. 5在 Claude Code 中启用

   启动 Claude Code 后直接用自然语言提问，如 check AAPL's financials，技能会自动激活，无需手动注册。

6. 6Codex / OpenClaw 接入

   把 SKILL.md 内容粘贴到系统提示词或项目上下文文件中，其中内嵌的 Python 代码可直接运行。

关键配置

如何确认成功

在 Claude Code 中提问 check AAPL's financials，技能自动激活并返回该股财务数据即表示接入成功。

常见问题

注意事项

• 使用 SEC EDGAR 相关层之前必须先设置 SEC_CONTACT，否则请求会被拒绝。
• README 的快速开始写着 3 步 2 分钟，但节选中仅展示了第 3 步 pip install requests，克隆与进入目录为按仓库地址推断的通用准备动作。
• 项目覆盖 13 层数据、30 多个接口、11 个数据源，各来源合规等级不同，接入前请核对可用范围。
• 提问示例可直接复用 README 中的说法，如 0DTE 期权流、卖空量、Form 4 内部人申报、全市场筛选器等。