# Sec Edgar

U.S.

- Repository: https://github.com/HKUDS/Vibe-Trading (37375 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add HKUDS/Vibe-Trading --skill sec-edgar -g -a claude-code -y`
Codex: `npx skills add HKUDS/Vibe-Trading --skill sec-edgar -g -a codex -y`
Cursor: `npx skills add HKUDS/Vibe-Trading --skill sec-edgar -g -a cursor -y`
Gemini CLI: `npx skills add HKUDS/Vibe-Trading --skill sec-edgar -g -a gemini-cli -y`

## Description

U.S. SEC EDGAR fetch interface, resolve a ticker to its CIK, list recent filings (10-K / 10-Q / 8-K and friends) with primary-document URLs, and pull XBRL companyfacts financial series. Free, no API key; rate-limited by IP so every request is throttled and carries a contact User-Agent. United States only.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# SEC EDGAR

## Overview

The U.S. Securities and Exchange Commission (SEC) publishes free, no-auth JSON endpoints for every reporting company on its EDGAR system: a ticker-to-CIK directory, a recent-filings index, and the full set of XBRL ("companyfacts") financial concepts a company has reported. This skill documents how Vibe-Trading fetches that data through the bundled `sec_edgar_client` transport and the `get_sec_filings` agent tool.

This is the **fetch** skill, it covers how to get filing-index rows, document URLs, and us-gaap metric series out of EDGAR. The separate `edgar-sec-filings` skill is the **methodology** layer (how to read a 10-K, score insider activity, interpret 8-K items); for any actual data retrieval it delegates here.

Scope is the United States only. EDGAR has no coverage of A-shares, HK, or other non-U.S. markets, route those through `tushare` / `yfinance` / `akshare` instead.

> Link convention: every link below that points into `references/` is written **relative to this document** (`references/...`), the form GitHub resolves when someone opens the file in a browser. The `read_file` tool resolves the same string against the skill that owns it, so the agent and a human reader reach one file. Keep the relative form when adding new docs, and keep reference paths unique across skills: a path two skills both carry is reported as ambiguous rather than guessed.

## Quick Start

Preferred path, the `get_sec_filings` tool (read-only, throttled, returns strict JSON):

```json
{ "ticker": "AAPL", "form": "10-K", "limit": 5 }
```

```json
{ "ticker": "MSFT", "metric": "Revenues", "limit": 8 }
```

The tool resolves the ticker to a CIK, fetches the filing index (optionally filtered by `form`), and, when `metric` is set, also pulls the XBRL series for that us-gaap concept. See `sec-edgar/references/get_sec_filings_tool.md` for the full parameter and envelope contract.

The rest: https://github.com/HKUDS/Vibe-Trading/blob/HEAD/agent/src/skills/sec-edgar/SKILL.md