Agent skill

Companiesmarketcap

by gauss314 in gauss314/skills

Scraper de CompaniesMarketCap: rankings (marketcap, earnings, revenue, employees, ratios), stock history y ETF holdings.

MITAuto-check passedBusiness, Finance & HR

Install Companiesmarketcap

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

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

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

At a glance

Scraper de CompaniesMarketCap: rankings (marketcap, earnings, revenue, employees, ratios), stock history y ETF holdings.

  • Tasks that involve Stock and market analysis
  • 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 Web scraping

What it does

Companiesmarketcap is an agent skill from gauss314/skills. Scraper de CompaniesMarketCap: rankings (marketcap, earnings, revenue, employees, ratios), stock history y ETF holdings. Sin API key.

Its SKILL.md is about 970 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_cmc.py`).

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

Example prompts

  • “/companiesmarketcap”

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

    • companiesmarketcap.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

Companiesmarketcap loads about 970 tokens when it runs, and up to ~2.9k if it reads all its reference files. Until then it costs about 38 tokens; SKILL.md has 279 words of instructions outside code blocks.

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

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). 279 words, ~970 tokens.

Download SKILL.mdSave it as .claude/skills/companiesmarketcap/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
companiesmarketcap
description
Scraper de CompaniesMarketCap: rankings (marketcap, earnings, revenue, employees, ratios), stock history y ETF holdings. Sin API key.
license
MIT

CompaniesMarketCap — Financial Rankings Scraper

Scraper de CompaniesMarketCap que extrae rankings financieros (market cap, earnings, revenue, employees, P/E, márgenes, activos, deuda, cash), marketcap histórico de stocks y ETF holdings.

Usa el sistema de CSV download nativo del sitio (?download=csv) — no requiere API key y es más mantenible que scrapear HTML.


  • CompaniesMarketCap no tiene API pública oficial. Usa el endpoint CSV que está públicamente disponible.
  • Respetá los términos de servicio del sitio.
  • Implementá rate limiting (mín 2 segundos entre requests).

Instalación

bash
pip install requests beautifulsoup4

Scripts

ScriptDescripción
fetch_cmc.pyScript principal: rankings, stock history, ETF holdings

Uso rápido

bash
# Ranking de market cap (default)
python scripts/fetch_cmc.py --rankings

# Ranking de earnings
python scripts/fetch_cmc.py --rankings --metric earnings

# Ranking de revenue (top 10)
python scripts/fetch_cmc.py --rankings --metric revenue --limit 10

# Stock marketcap histórico
python scripts/fetch_cmc.py --stock NVDA
python scripts/fetch_cmc.py --stock GGAL

# ETF holdings
python scripts/fetch_cmc.py --etf SPY --holdings

# Todo junto + output a JSON
python scripts/fetch_cmc.py --stock AAPL --rankings --output aapl_full.json

# Modo silencioso (solo JSON)
python scripts/fetch_cmc.py --rankings --metric earnings --limit 5 --quiet

Endpoints

FlagDataMétodoDetalle
--rankingsRanking listCSV download12 métricas + ETFs, ~10,852 empresas
--stock TICKERMarketcap históricoHTML28-31 años por stock
--etf TICKER --holdingsETF holdingsHTML~505 posiciones (SPY)
--etf TICKERETF summaryHTMLInformación del ETF
Rankings disponibles (--metric)
MétricaDescripción
marketcap (default)Market Capitalization
earningsEarnings (TTM)
revenueRevenue (TTM)
employeesEmployee count
pe_ratioPrice/Earnings ratio
operating_marginOperating margin (TTM)
total_assetsTotal assets
net_assetsNet assets
liabilitiesTotal liabilities
debtTotal debt
cashCash on hand
pb_ratioPrice/Book ratio
etfsETF market caps

Flags adicionales

FlagDescripción
--limit NLimitar a N filas en rankings
--output archivo.jsonGuardar output a archivo
--delay NDelay entre requests (default: 2.0s)
--quietModo silencioso (solo JSON)

Resolución automática ticker → slug

El scraper resuelve automáticamente el slug de la URL a partir del nombre de la compañía en el CSV:

TickerNombre → Slug
NVDANVIDIA → nvidia
AAPLApple → apple
GGALGalicia Financial Group → galicia-financial-group
SPYSPDR S&P 500 ETF → spdr-sp-500-etf
BRK-BBerkshire Hathaway → berkshire-hathaway

Estructura del skill

skills/companiesmarketcap/
├── SKILL.md                              # Este archivo
├── references/
│   └── REFERENCE.md                      # Documentación completa
└── scripts/
    └── fetch_cmc.py                      # Script principal

📖 Documentación detallada: Consultá references/REFERENCE.md para la documentación exhaustiva de cada endpoint, columnas, ejemplos y consideraciones técnicas.

© 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/companiesmarketcap of gauss314/skills.

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

Open the folder on GitHubat commit 5156f81

Compare with similar skills

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

Companiesmarketcap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Companiesmarketcap this skillgauss314/skills248—~970Automated safety check: PassMIT
Financial Researchfirecrawl/web-agent1.2k—~1.1kAutomated safety check: PassMIT
Investor Call Prepgooseworks-ai/goose-skills1.2k1 repos~3.8kAutomated safety check: PassMIT
Regimejackson-video-resources/markov-hedge-fund-method484—~1.6kAutomated safety check: PassCustom licence
Apify Buying Signal Detectionapify/awesome-skills266—~5.1kAutomated safety check: NotesApache-2.0
One-Line Stock Analysis Reportsmingli30119/stock-analysis619—~8.6kAutomated safety check: WarnMIT

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
  • Investor Call Prep

    gooseworks-ai/goose-skills

    Prepare for investor calls by pulling upcoming meetings from Google Calendar, deeply researching each investor and their firm (website scraping, portfolio analysis, thesis extraction), checking for…

    1.2k GitHub starsUsed in 1 repo~3.8k tokens
    Business, Finance & HRAuto-check passed
  • Regime

    jackson-video-resources/markov-hedge-fund-method

    Detect the market regime (Bull / Bear / Sideways) for ANY asset and turn it into a tradeable signal or a risk filter.

    484 GitHub stars~1.6k tokensUpdated 4 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)…

    266 GitHub stars~5.1k tokensUpdated 18 days ago
    Business, Finance & HRAuto-check: notes
  • One-Line Stock Analysis Reports

    mingli30119/stock-analysis

    Turns a single request like 'analyze this stock' into a full research report, pulling 30-plus data sources into an interactive HTML page with charts.

    619 GitHub stars~8.6k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check: warnings
  • Manus

    sanjay3290/ai-skills

    Delegate complex, long-running tasks to Manus AI agent for autonomous execution.

    432 GitHub stars~1.7k tokensUpdated 1 mo ago
    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

Questions about Companiesmarketcap

What does Companiesmarketcap do?

Scraper de CompaniesMarketCap: rankings (marketcap, earnings, revenue, employees, ratios), stock history y ETF holdings. Companiesmarketcap is an agent skill from gauss314/skills. Scraper de CompaniesMarketCap: rankings (marketcap, earnings, revenue, employees, ratios), stock history y ETF holdings.

When should I use Companiesmarketcap?

Companiesmarketcap fits situations like: tasks that involve Stock and market analysis; tasks that involve Web scraping.

How do I install Companiesmarketcap in Claude Code?

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

How do I install Companiesmarketcap in Codex?

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

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

What does Companiesmarketcap need to run?

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

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

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

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

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

What are the alternatives to Companiesmarketcap?

Skills that share tags, products or a category with Companiesmarketcap: Financial Research (firecrawl/web-agent, 1.2k stars), Investor Call Prep (gooseworks-ai/goose-skills, 1.2k stars), Regime (jackson-video-resources/markov-hedge-fund-method, 484 stars) and Apify Buying Signal Detection (apify/awesome-skills, 266 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Companiesmarketcap?

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.