mcpField
M
marketwatch

marketwatch

github.com/gauss314数据与数据库252241 次安装19 周前更新
代码仓库

关于 marketwatch

面向需要收集美股及全球 ADR 数据的用户的 Python 抓取工具，可从 MarketWatch 公开页面获取行情、公司与财务信息、申报文件、分析师预估、期权和历史价格，无需 API 密钥。

主要功能

  1. 01实时行情与公司简介
  2. 02年度及季度财务报表
  3. 03SEC 申报文件与分析师预估
  4. 04期权链与历史价格
  5. 05通过命令行获取单项或组合数据

适用场景

  1. 01查看股票的当前行情和公司简介
  2. 02收集年度或季度财务报表
  3. 03查询申报文件、分析师预估或期权
  4. 04获取近期每日 OHLCV 数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gauss314/skills --skill marketwatch

安装后在 Claude Code 中输入/marketwatch确认已加载。

附带文件references/REFERENCE.mdscripts/fetch_marketwatch.py

详细介绍

MarketWatch — 金融数据抓取工具

从 MarketWatch 抓取美国股票和全球 ADR 的实时报价、财务报表（损益表、资产负债表、现金流量表）、SEC 文件、分析师预估、期权链和历史价格。

无需 API 密钥。数据从公开网页的 HTML 中提取。

⚠️ 法律声明

  • MarketWatch 没有官方公共 API。此抓取工具会访问网站上公开可用的数据。
  • MarketWatch 使用 Datadome 进行反机器人保护。此抓取工具使用完整的浏览器标头来绕过保护。
  • 请遵守 MarketWatch 的服务条款。
  • 请实施速率限制（请求间隔至少 3 秒，建议 5 秒）。
  • 网站可能会更改 HTML 结构，导致抓取工具失效。

安装

pip install requests beautifulsoup4

脚本

脚本描述
fetch_marketwatch.py主脚本：包含所有端点

快速使用

# Quote + perfil de compañía
python scripts/fetch_marketwatch.py --ticker AAPL --quote --profile

# Income statement anual (por defecto)
python scripts/fetch_marketwatch.py --ticker MSFT --income

# Income statement trimestral
python scripts/fetch_marketwatch.py --ticker AAPL --income --quarterly

# Balance sheet + cash flow trimestral
python scripts/fetch_marketwatch.py --ticker NVDA --balance --cashflow --quarterly

# Todos los financials (income + balance + cashflow)
python scripts/fetch_marketwatch.py --ticker AAPL --financials

# SEC filings (10-K, 10-Q, 8-K)
python scripts/fetch_marketwatch.py --ticker AAPL --sec-filings

# Analyst estimates + target price
python scripts/fetch_marketwatch.py --ticker AAPL --analyst

# Options chain
python scripts/fetch_marketwatch.py --ticker AAPL --options

# Historical OHLCV
python scripts/fetch_marketwatch.py --ticker AAPL --historical

# Todo lo disponible
python scripts/fetch_marketwatch.py --ticker GGAL --all

# A JSON
python scripts/fetch_marketwatch.py --ticker AAPL --all --output aapl.json

# Control de rate limiting
python scripts/fetch_marketwatch.py --ticker AAPL --quote --delay 5

可用端点

标志数据频率周期
--quote价格、涨跌、表现（5 天、1 个月、年初至今）实时1 个快照
--profile关键比率、行业、产业、员工人数当前1 个快照
--income损益表年度 / 季度约 5 年
--balance资产负债表年度 / 季度约 5 年
--cashflow现金流量表年度 / 季度约 5 年
--financials损益表 + 资产负债表 + 现金流量表（快捷方式）取决于 --quarterly约 5 年
--sec-filingsSEC 文件（10-K、10-Q、8-K）历史约 20 条以上
--analyst预估、目标价、评级季度 / 年度约 15 个以上字段
--options期权链（按行权价列出看涨 / 看跌期权）到期日所有可用数据
--historical每日历史 OHLCV每日约 1-3 个月
--all以上所有数据取决于 --quarterly-

各端点提供的数据

报价

当前价格、涨跌额（$）、涨跌幅（%）、前收盘价，以及表现表格（5 日、1 个月、3 个月、年初至今、1 年）。

公司简介

最多 29 项财务比率，包括： 当前市盈率、市盈率、每股收益、总市值、流通股数、员工人均收入、员工人数、股息收益率、Beta 等。

财务报表

每份报表包含约 40-60 个项目（损益表包括收入、销售成本、毛利、营业收入、净收入、EBITDA、每股收益等；资产负债表包括现金、应收款项、总资产、债务、权益等；现金流量表包括经营现金流、自由现金流、资本支出等）。

SEC 文件

文件列表包括：提交日期、文件日期、类型（10-K、10-Q、8-K）、类别。

分析师预估

平均评级、平均目标价、评级数量、最高 / 中位数 / 最低目标价、当年 / 次年预估，以及按公司列出的评级变动表。

期权

按到期日整理的期权链，包含看涨期权和看跌期权、行权价、价格、成交量、未平仓合约数。

历史数据

每日 OHLCV，包含日期、开盘价、最高价、最低价、收盘价、成交量（最近约 60 天）。

反机器人保护（Datadome）

MarketWatch 使用 Datadome 防止自动化抓取。

情况症状解决方案
连续发出过多请求401 Unauthorized增加 --delay（至少 3 秒，最好 5 秒）
IP 被临时封锁即使设置了延迟，仍返回 401等待 5-10 分钟
标头不正确立即返回 401使用浏览器标头（已包含）
没有会话 Cookie返回 401抓取工具会自动处理 Cookie

建议： 每个股票代码每次运行最多请求 4-5 个端点。

技能结构

skills/marketwatch/
├── SKILL.md                              # Este archivo
├── references/
│   └── REFERENCE.md                      # Documentación completa de todos los endpoints
└── scripts/
    └── fetch_marketwatch.py              # Script principal

📖 完整参考： 要详细了解每个端点、options 列、财务字段、历史数据结构等，请参阅 references/REFERENCE.md。

评论

支持 Markdown