Agent skill

Macrotrends

by gauss314 in gauss314/skills

Scraper de Macrotrends: financial statements, ratios, employee count con 15+ años de data histórica.

MITAuto-check passedBusiness, Finance & HR

Install Macrotrends

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

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

GitHub CLI
$ gh skill install gauss314/skills macrotrends --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/macrotrends .claude/skills/macrotrends && 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
macrotrends
GitHub stars
247
Token cost
~1.5k tokens
SKILL.md length
492 words
Files
4 (incl. scripts, references)
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

Scraper de Macrotrends: financial statements, ratios, employee count con 15+ años de data histórica.

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

What it does

Macrotrends is an agent skill from gauss314/skills. Scraper de Macrotrends: financial statements, ratios, employee count con 15+ años de data histórica. Sin API key.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/MARKETS_REFERENCE.md`, `references/STATEMENTS_REFERENCE.md` and `scripts/fetch_financials.py`).

It sits in Business, Finance & HR, covering Financial analysis and Web scraping. 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 Financial analysis
  • Tasks that involve Web scraping

Example prompts

  • “/macrotrends”

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):

    • macrotrends.net

    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

Macrotrends loads about 1.5k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 31 tokens; SKILL.md has 492 words of instructions outside code blocks.

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

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). 492 words, ~1,482 tokens.

Download SKILL.mdSave it as .claude/skills/macrotrends/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
macrotrends
description
Scraper de Macrotrends: financial statements, ratios, employee count con 15+ años de data histórica. Sin API key.
license
MIT

Macrotrends — Financial Data Scraper

Scraper de Macrotrends que extrae datos financieros históricos: income statements, balance sheets, cash flow statements, financial ratios y employee count con hasta 15+ años de data para ~6,500 tickers de mercados US (NYSE, NASDAQ, AMEX), incluyendo ADRs internacionales de +30 países.

Los datos vienen en JSON embebido en la página (no requiere API key, solo requests + BeautifulSoup).


  • Macrotrends no tiene API pública oficial. Este scraper accede a datos públicamente disponibles en la web.
  • Respetá los términos de servicio de Macrotrends.
  • Implementá rate limiting (mín 2 segundos entre requests, recomendado 3s).
  • El sitio puede cambiar su estructura HTML/JS, rompiendo el scraper.

Instalación

bash
pip install requests beautifulsoup4

Scripts

ScriptDescripción
fetch_financials.pyScript principal: statements, ratios, employees

Uso rápido

bash
# Income statement anual
python scripts/fetch_financials.py --ticker NVDA --income

# Todo lo disponible (income + balance + cashflow + ratios + employees)
python scripts/fetch_financials.py --ticker AAPL --all

# Statements trimestrales
python scripts/fetch_financials.py --ticker MSFT --income --quarterly
python scripts/fetch_financials.py --ticker MSFT --balance --quarterly

# Ratios anuales o trimestrales
python scripts/fetch_financials.py --ticker NVDA --ratios
python scripts/fetch_financials.py --ticker GGAL --ratios --quarterly

# Employee count
python scripts/fetch_financials.py --ticker NVDA --employees

# Output a archivo JSON
python scripts/fetch_financials.py --ticker AAPL --all --output data.json

# Silencioso (solo JSON)
python scripts/fetch_financials.py --ticker NVDA --all --quiet

Endpoints disponibles

FlagDataFrecuenciasPeríodos
--incomeIncome StatementAnual, Trimestral~15 años / ~60 quarters
--balanceBalance SheetAnual, Trimestral~15 años / ~60 quarters
--cashflowCash FlowSolo anual~15 años
--ratiosFinancial Ratios (20 ratios)Anual, Trimestral~15 años / ~60 quarters
--employeesEmployee CountAnual~15 años
--allTodos los anterioresSegún --quarterly-
Flags adicionales
FlagDescripción
--quarterlyUsa frecuencia trimestral (donde esté disponible)
--outputArchivo JSON de salida (default: stdout)
--slugSlug manual (si el search no funciona)
--delayDelay entre requests (default: 3.0s)
--quietModo silencioso

Resolución ticker → slug

Macrotrends usa URLs con el formato /stocks/charts/{TICKER}/{SLUG}/financial-statements.

El slug se resuelve automáticamente via el search endpoint interno. Ejemplos:

TickerSlug
AAPLapple
NVDAnvidia
MSFTmicrosoft
GGALgrupo-financiero-galicia-sa
TSLAtesla

Si el search falla, se puede pasar el slug manualmente:

bash
python scripts/fetch_financials.py --ticker GGAL --slug grupo-financiero-galicia-sa --all

Datos disponibles por statement

Income Statement (22 campos)

Revenue, COGS, Gross Profit, R&D, SG&A, Operating Income, Net Income, EBITDA, EBIT, EPS, Shares Outstanding, etc.

Balance Sheet (23 campos)

Cash, Receivables, Inventory, Total Assets, Total Liabilities, Shareholders Equity, Debt, Retained Earnings, etc.

Show full SKILL.md (201 more words)Show less
Cash Flow (29 campos)

Net Income, Depreciation, Working Capital Changes, Capex, Free Cash Flow, Dividends, Stock Repurchases, etc.

Financial Ratios (20 ratios)

Current Ratio, Debt/Equity, Gross/Operating/Net Margins, ROE, ROA, ROI, Book Value/Share, FCF/Share, etc.

Employee Count

Año a año, empleados totales.

Ver referencia completa de campos en references/STATEMENTS_REFERENCE.md.


Cobertura de Mercados

Macrotrends cubre ~6,500 tickers que cotizan en NYSE, NASDAQ y AMEX (incluyendo ADRs).

TipoCantidadEjemplos
US Common Stocks~5,300AAPL, NVDA, MSFT
ADRs Internacionales~276+GGAL (Argentina), BABA (China), TM (Japón), PBR (Brasil), SAN (España), BP (UK)
ETFs & Fondos~91SPY, QQQ, VTI
Class A/B Shares~22BRK.A, BRK.B

Ver detalle completo de mercados, ADRs por país y cómo buscar tickers en references/MARKETS_REFERENCE.md.


Rate Limits

ComportamientoRecomendación
Requests seguidos sin delay429 Too Many Requests
Delay recomendado3 segundos entre requests
Tickers por ejecución~5-6 como máximo (para evitar bloqueo)
BackoffSi recibís 429, esperá 30-60s

Errores comunes

ErrorCausaSolución
429 Too Many RequestsRate limitAumentar --delay o esperar
slug not foundNo se pudo resolver el tickerUsar --slug manualmente
No data found for XEndpoint no disponibleVerificar que el ticker existe en Macrotrends
originalData not foundPágina cambió estructuraReportar issue

Estructura del skill

skills/macrotrends/
├── SKILL.md                              # Este archivo
├── references/
│   ├── STATEMENTS_REFERENCE.md           # Referencia de campos
│   └── MARKETS_REFERENCE.md             # Cobertura de mercados y ADRs
└── scripts/
    └── fetch_financials.py               # Script principal

© 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 3 other files (scripts, references) in skills/macrotrends of gauss314/skills.

  • SKILL.md
  • references/MARKETS_REFERENCE.md
  • references/STATEMENTS_REFERENCE.md
  • scripts/fetch_financials.py

Open the folder on GitHubat commit 5156f81

Compare with similar skills

Macrotrends 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.

Macrotrends compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Macrotrends this skillgauss314/skills247—~1.5kAutomated safety check: PassMIT
Financial Researchfirecrawl/web-agent1.2k—~1.1kAutomated safety check: PassMIT
Apify Buying Signal Detectionapify/awesome-skills265—~5.1kAutomated safety check: NotesApache-2.0
Business Overview Analysiszj-unicom-ai/UniEmployee359—~662Automated safety check: PassMIT
Longbridge Earningshelsome/folio2701 repos~2.5kAutomated safety check: PassNone
Financial Analyzinghuangjia2019/claude-code-engineering1.1k—~474Automated safety check: PassNone

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
  • Apify Buying Signal Detection

    apify/awesome-skills

    Official

    Set up a recurring buying-signal detection pipeline that finds companies showing buying intent across three signal types — job postings (hiring for the persona), fundraising events (recent raises)…

    265 GitHub stars~5.1k tokensUpdated 17 days ago
    Business, Finance & HRAuto-check: notes
  • Business Overview Analysis

    zj-unicom-ai/UniEmployee

    Produces a full business health analysis from sales, finance, inventory and customer CSV files: core KPIs, monthly trends, drill-downs and recommendations.

    359 GitHub stars~662 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Longbridge Earnings

    helsome/folio

    Earnings analysis — pre- and post-earnings. An agent skill from helsome/folio.

    270 GitHub starsUsed in 1 repo~2.5k tokens
    Business, Finance & HRAuto-check passed
  • Financial Analyzing

    huangjia2019/claude-code-engineering

    Analyze financial data, calculate financial ratios, and generate analysis reports.

    1.1k GitHub stars~474 tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Surveys open Korean government startup and R&D support programs and sorts them by fit with your project, checking eligibility against the original notices.

    392 GitHub stars~3.5k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check: notes

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.

    247 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).

    247 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.

    247 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).

    247 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…

    247 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.

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

Questions about Macrotrends

What does Macrotrends do?

Scraper de Macrotrends: financial statements, ratios, employee count con 15+ años de data histórica. Macrotrends is an agent skill from gauss314/skills. Scraper de Macrotrends: financial statements, ratios, employee count con 15+ años de data histórica.

When should I use Macrotrends?

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

How do I install Macrotrends in Claude Code?

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

How do I install Macrotrends in Codex?

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

Can I use Macrotrends 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 macrotrends -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/macrotrends, .gemini/skills/macrotrends, .github/skills/macrotrends and .opencode/skills/macrotrends in your project.

What does Macrotrends need to run?

Going by SKILL.md and its folder, Macrotrends 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 Macrotrends access the network?

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

Is Macrotrends 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 Macrotrends use?

Macrotrends 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 Macrotrends use?

About 1.5k tokens (SKILL.md is roughly 5.9k 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 2.7k tokens, read only when the agent opens those files.

What are the alternatives to Macrotrends?

Skills that share tags, products or a category with Macrotrends: Financial Research (firecrawl/web-agent, 1.2k stars), Apify Buying Signal Detection (apify/awesome-skills, 265 stars), Business Overview Analysis (zj-unicom-ai/UniEmployee, 359 stars) and Longbridge Earnings (helsome/folio, 270 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Macrotrends?

gauss314 (a GitHub user) maintains it in gauss314/skills, which has 247 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.