Agent skill

Marketwatch

by gauss314 in gauss314/skills

Scraper de MarketWatch: quotes, financials (income/balance/cash flow), SEC filings, analyst estimates, options chain, historical OHLCV.

MITAuto-check passedData & Analytics

Install Marketwatch

skills CLI
$ npx skills add gauss314/skills --skill marketwatch -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gauss314/skills marketwatch --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gauss314/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/marketwatch .claude/skills/marketwatch && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
marketwatch
GitHub stars
248
Token cost
~1.4k tokens
SKILL.md length
463 words
Files
3 (incl. scripts, references)
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

Scraper de MarketWatch: quotes, financials (income/balance/cash flow), SEC filings, analyst estimates, options chain, historical OHLCV.

  • Tasks that involve Web scraping
  • SKILL.md covers ⚠️ Aviso Legal, Instalación, Scripts and Uso rápido, plus 4 more sections
  • Runs Python scripts from its folder; calls python and pip
  • Tasks that involve Financial analysis

What it does

Marketwatch is an agent skill from gauss314/skills. Scraper de MarketWatch: quotes, financials (income/balance/cash flow), SEC filings, analyst estimates, options chain, historical OHLCV. Sin API key.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/REFERENCE.md` and `scripts/fetch_marketwatch.py`).

It sits in Data & Analytics, covering Web scraping and Financial analysis. It works with SEC EDGAR. The repository describes itself as: Financial market data consumption skills for claude code and AI agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Web scraping
  • Tasks that involve Financial analysis

Example prompts

  • “/marketwatch”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 5156f81. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • marketwatch.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Marketwatch loads about 1.4k tokens when it runs, and up to ~8k if it reads all its reference files. Until then it costs about 40 tokens; SKILL.md has 463 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from gauss314/skills at commit 5156f81, republished under its MIT licence (© gauss314). 463 words, ~1,417 tokens.

Download SKILL.mdSave it as .claude/skills/marketwatch/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
marketwatch
description
Scraper de MarketWatch: quotes, financials (income/balance/cash flow), SEC filings, analyst estimates, options chain, historical OHLCV. Sin API key.
license
MIT

MarketWatch — Financial Data Scraper

Scraper de MarketWatch que extrae quotes en tiempo real, financial statements (income, balance sheet, cash flow), SEC filings, analyst estimates, options chain y historical prices para acciones US y ADRs globales.

No requiere API key. Los datos se extraen del HTML de las páginas públicas.


  • MarketWatch no tiene API pública oficial. Este scraper accede a datos públicamente disponibles en la web.
  • MarketWatch usa Datadome para protección anti-bot. El scraper utiliza headers de navegador completo para bypass.
  • Respetá los términos de servicio de MarketWatch.
  • Implementá rate limiting (mín 3 segundos entre requests, recomendado 5s).
  • El sitio puede cambiar su estructura HTML, rompiendo el scraper.

Instalación

bash
pip install requests beautifulsoup4

Scripts

ScriptDescripción
fetch_marketwatch.pyScript principal: todos los endpoints

Uso rápido

bash
# 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

Endpoints disponibles

FlagDataFrecuenciaPeríodos
--quotePrecio, cambio, performance (5d, 1m, YTD)Tiempo real1 snapshot
--profileRatios clave, sector, industria, empleadosActual1 snapshot
--incomeIncome StatementAnual / Trimestral~5 años
--balanceBalance SheetAnual / Trimestral~5 años
--cashflowCash Flow StatementAnual / Trimestral~5 años
--financialsIncome + Balance + Cash Flow (atajo)Según --quarterly~5 años
--sec-filingsSEC filings (10-K, 10-Q, 8-K)Histórico~20+ entradas
--analystEstimaciones, target price, recomendacionesTrimestral/anual~15+ campos
--optionsOptions chain (calls/puts por strike)Fechas de expiraciónTodas disponibles
--historicalOHLCV histórico diarioDiario~1-3 meses
--allTodos los anterioresSegún --quarterly-

Datos disponibles por endpoint

Quote

Precio actual, cambio ($), cambio (%), Close anterior, y tabla de performance (5 Day, 1 Month, 3 Month, YTD, 1 Year).

Company Profile

Hasta 29 ratios financieros incluyendo: P/E Current, P/E Ratio, EPS, Market Cap, Shares Outstanding, Revenue/Employee, Employees, Dividend Yield, Beta, etc.

Show full SKILL.md (197 more words)Show less
Financial Statements

Cada statement contiene ~40-60 items (Revenue, COGS, Gross Profit, Operating Income, Net Income, EBITDA, EPS, etc. para income; Cash, Receivables, Total Assets, Debt, Equity, etc. para balance sheet; Operating Cash Flow, Free Cash Flow, Capex, etc. para cash flow).

SEC Filings

Listado de filings con: Filing Date, Document Date, Type (10-K, 10-Q, 8-K), Category.

Analyst Estimates

Average Recommendation, Average Target Price, Number of Ratings, High/Median/Low target, Current/Next Year Estimates, y tabla de cambios de rating por firma.

Options

Options chain organizada por fecha de expiración con calls y puts, strikes, precios, volumen, open interest.

Historical

OHLCV diario con Date, Open, High, Low, Close, Volume (últimos ~60 días).


Protección anti-bot (Datadome)

MarketWatch usa Datadome para protegerse de scraping automatizado.

SituaciónSíntomaSolución
Muchos requests seguidos401 UnauthorizedAumentar --delay (mín 3s, ideal 5s)
IP bloqueada temporalmente401 incluso con delayEsperar 5-10 minutos
Headers incorrectos401 inmediatoUsar headers de navegador (ya incluidos)
Sin session cookies401El scraper maneja cookies automáticamente

Recomendación: No más de 4-5 endpoints por ticker por ejecución.


Estructura del skill

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

📖 Referencia completa: Para entender en detalle cada endpoint, columnas de options, campos de financials, estructura de historical data, etc., consultá references/REFERENCE.md.

© gauss314, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts, references) in skills/marketwatch of gauss314/skills.

  • SKILL.md
  • references/REFERENCE.md
  • scripts/fetch_marketwatch.py

Open the folder on GitHubat commit 5156f81

Compare with similar skills

Marketwatch next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Marketwatch compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Marketwatch this skillgauss314/skills248—~1.4kAutomated safety check: PassMIT
Financial Researchfirecrawl/web-agent1.2k—~1.1kAutomated safety check: PassMIT
Eastmoney Market DataHKUDS/Vibe-Trading35k—~1kAutomated safety check: PassMIT
SEC EDGAR Filings FetcherHKUDS/Vibe-Trading35k—~1.4kAutomated safety check: PassMIT
US Market Data ToolkitGeeksfino/finskills282—~1.2kAutomated safety check: PassApache-2.0
Financial Statement Deep DiveGeeksfino/finskills282—~1.8kAutomated safety check: PassApache-2.0

Similar skills

  • Financial Research

    firecrawl/web-agent

    Pulls a public company's latest 10-K or 10-Q figures and analyst consensus from SEC EDGAR and Yahoo Finance, then cross-checks the two sources.

    1.2k GitHub stars~1.1k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Eastmoney Market Data

    HKUDS/Vibe-Trading

    Index of Eastmoney's free, no-token market data interfaces for China A-shares and Hong Kong stocks: fund flows, dragon-tiger lists, margin trading, reports and news.

    35k GitHub stars~1k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • SEC EDGAR Filings Fetcher

    HKUDS/Vibe-Trading

    Fetches U.S. SEC EDGAR data: resolves tickers to CIK numbers, lists recent 10-K, 10-Q and 8-K filings with document URLs, and pulls XBRL financial series.

    35k GitHub stars~1.4k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • US Market Data Toolkit

    Geeksfino/finskills

    Free Python scripts that fetch US stock data, SEC filings, insider trades and macro indicators, and run financial score calculators and portfolio analytics.

    282 GitHub stars~1.2k tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check passed
  • Runs a forensic review of one company's financial statements covering DuPont profitability, earnings quality, financial health scores and fraud-risk signals.

    282 GitHub stars~1.8k tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check passed
  • Edgartools

    agent-skills-hub/agent-skills-hub

    Python library for accessing, analyzing, and extracting data from SEC EDGAR filings.

    112 GitHub starsUsed in 2 repos~1.4k tokens
    Business, Finance & HRAuto-check passed

More from gauss314/skills

All 32 skills in this repo
  • Backtesting

    gauss314/skills

    Academic backtesting framework for quantitative research. An agent skill from gauss314/skills.

    248 GitHub stars~2.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Google Finance

    gauss314/skills

    Datos de Google Finance via batchexecute (API RPC interna sin auth ni API key).

    248 GitHub stars~3.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Historyofmarket

    gauss314/skills

    History of Market (historyofmarket.com) — API publica con 88 datasets historicos de indices US desde 1871.

    248 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Indec

    gauss314/skills

    Datos macro y sociales de Argentina via la API oficial Series de Tiempo del Estado (apis.datos.gob.ar/series).

    248 GitHub stars~3k tokensUpdated 3 mo ago
    Auto-check passed
  • Morningstar

    gauss314/skills

    Morningstar Screener via API JSON publica: descarga masiva de 53 universes (102K+ listings, 39 paises, NYSE/Nasdaq/BCBA/etc) con 33 campos (precio, market cap, ratios, retornos…

    248 GitHub stars~2.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Option Pricing

    gauss314/skills

    Pricing completo de opciones europeas y americanas. An agent skill from gauss314/skills.

    248 GitHub stars~4.7k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Questions about Marketwatch

What does Marketwatch do?

Scraper de MarketWatch: quotes, financials (income/balance/cash flow), SEC filings, analyst estimates, options chain, historical OHLCV. Marketwatch is an agent skill from gauss314/skills. Scraper de MarketWatch: quotes, financials (income/balance/cash flow), SEC filings, analyst estimates, options chain, historical OHLCV.

When should I use Marketwatch?

Marketwatch fits situations like: tasks that involve Web scraping; tasks that involve Financial analysis.

How do I install Marketwatch in Claude Code?

Run `npx skills add gauss314/skills --skill marketwatch -a claude-code`. Or copy the skill folder (skills/marketwatch in gauss314/skills) into .claude/skills/marketwatch in your project. Claude Code loads it when a task matches its description.

How do I install Marketwatch in Codex?

Run `npx skills add gauss314/skills --skill marketwatch -a codex`. Or copy the skill folder (skills/marketwatch in gauss314/skills) into .agents/skills/marketwatch in your project. Codex loads it when a task matches its description.

Can I use Marketwatch in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gauss314/skills --skill marketwatch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/marketwatch, .gemini/skills/marketwatch, .github/skills/marketwatch and .opencode/skills/marketwatch in your project.

What does Marketwatch need to run?

Going by SKILL.md and its folder, Marketwatch needs Python for the scripts in its folder and the command-line tools its instructions call (python and pip). Our summary lists: Python 3.

Does Marketwatch access the network?

SKILL.md names 1 domain. As links in the text: marketwatch.com. This is read from the text; nothing was executed.

Is Marketwatch safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Marketwatch use?

Marketwatch is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Marketwatch use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.5k tokens, read only when the agent opens those files.

What are the alternatives to Marketwatch?

Skills that share tags, products or a category with Marketwatch: Financial Research (firecrawl/web-agent, 1.2k stars), Eastmoney Market Data (HKUDS/Vibe-Trading, 35k stars), SEC EDGAR Filings Fetcher (HKUDS/Vibe-Trading, 35k stars) and US Market Data Toolkit (Geeksfino/finskills, 282 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Marketwatch?

gauss314 (a GitHub user) maintains it in gauss314/skills, which has 248 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on June 14, 2026.

Source: gauss314/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.