{"id":42529405,"url":"https://github.com/cmdrvl/edgar-change-interpreter","last_synced_at":"2026-01-28T16:12:12.132Z","repository":{"id":330652931,"uuid":"1123477475","full_name":"cmdrvl/edgar-change-interpreter","owner":"cmdrvl","description":"Claude skill for identifying material changes, silent risks, and interpretation traps in SEC filings (10-K, 10-Q, 8-K). Built by CMD+RVL.","archived":false,"fork":false,"pushed_at":"2025-12-27T02:39:50.000Z","size":49,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-28T16:06:45.800Z","etag":null,"topics":["10k","10q","8k","agent-tools","anthropic","claude","claude-skill","cmdrvl","decision-support","edgar","filings","financial-analysis","risk-analysis","sec"],"latest_commit_sha":null,"homepage":"https://cmdrvl.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cmdrvl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-27T00:40:03.000Z","updated_at":"2025-12-27T02:39:54.000Z","dependencies_parsed_at":"2025-12-28T16:07:15.596Z","dependency_job_id":null,"html_url":"https://github.com/cmdrvl/edgar-change-interpreter","commit_stats":null,"previous_names":["cmdrvl/edgar-change-interpreter"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/cmdrvl/edgar-change-interpreter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmdrvl%2Fedgar-change-interpreter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmdrvl%2Fedgar-change-interpreter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmdrvl%2Fedgar-change-interpreter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmdrvl%2Fedgar-change-interpreter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cmdrvl","download_url":"https://codeload.github.com/cmdrvl/edgar-change-interpreter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmdrvl%2Fedgar-change-interpreter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28846857,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T15:15:36.453Z","status":"ssl_error","status_checked_at":"2026-01-28T15:15:13.020Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["10k","10q","8k","agent-tools","anthropic","claude","claude-skill","cmdrvl","decision-support","edgar","filings","financial-analysis","risk-analysis","sec"],"created_at":"2026-01-28T16:12:11.329Z","updated_at":"2026-01-28T16:12:12.112Z","avatar_url":"https://github.com/cmdrvl.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Edgar Change Interpreter\n\nA Claude Skill for interpreting material change, silent risk, and disclosure traps in SEC filings. It focuses on what changed (and what disappeared) across 10-K, 10-Q, and 8-K filings so you can review deltas without missing subtle shifts.\n\n- **What this focuses on:** material changes, omitted risks, and explicit evidence from filings\n- **What this deliberately avoids:** generic summaries and trade advice\n\n---\n\n## Why change interpretation (not summaries)?\n\nSummaries describe what exists in a single filing. Decisions hinge on what changed between periods, what quietly disappeared, and how risk language shifted. This skill is built to surface those deltas and make uncertainty explicit.\n\n---\n\n## Quickstart\n\n```bash\nmkdir -p ~/.claude/skills\ncp -R skills/edgar-change-interpreter ~/.claude/skills/\n```\n\nRestart Claude, then ask:\n\n```text\nCompare the latest 10-K vs. prior year for material changes and silent risks in the Risk Factors section.\n```\n\n---\n\n## What Does This Do?\n\nWhen you're reviewing SEC filings, this skill helps Claude:\n- **Spot material changes** between current and prior filings\n- **Flag silent risks** — things that disappeared or changed without explanation\n- **Quote evidence** directly from the filing text\n- **Be explicit about uncertainty** — no hallucinated conclusions\n\n---\n\n## Quick Start\n\n### Prerequisites\n\n- **Node.js v20 or higher** (see [Appendix A](#appendix-a-installing-nodejs-with-nvm) if you don't have it)\n- **Claude CLI** with MCP support (see [Appendix B](#appendix-b-setting-up-claude-cli))\n\n### Step 1: Install the Claude Skill\n\nCopy the skill folder to your Claude skills directory:\n\n```bash\n# Create the skills directory if it doesn't exist\nmkdir -p ~/.claude/skills\n\n# Copy the skill\ncp -R skills/edgar-change-interpreter ~/.claude/skills/\n```\n\nThe skill is now installed. Continue to Step 2 to set up automatic filing retrieval, or skip to [Usage Examples](#usage-examples) to use the skill by pasting filing text manually.\n\n### Step 2: Set Up the MCP Server (Recommended)\n\nThe MCP server fetches SEC filings for you automatically — no more copy-pasting from the SEC website. Skip to [Usage Examples](#usage-examples) if you want to use the skill manually without the server.\n\n```bash\n# Navigate to the server directory\ncd mcp/edgar-server\n\n# Install dependencies\nnpm install\n\n# Create your environment file\ncp .env.example .env\n```\n\nEdit the `.env` file with your information (the SEC requires a user-agent for API access):\n\n```bash\nSEC_USER_AGENT_NAME=\"Your Name or Company\"\nSEC_USER_AGENT_EMAIL=\"your@email.com\"\nSEC_MAX_RPS=2\n```\n\nBuild the server:\n\n```bash\nnpm run build\n```\n\nRun it once to get your registration command:\n\n```bash\nnpm start\n```\n\nThe server will print something like this:\n\n```\n[edgar-mcp-server] Started successfully!\n\nTo add this server to Claude CLI, run:\n\nclaude mcp add-json edgar '{\"type\":\"stdio\",\"command\":\"node\",\"args\":[\"/path/to/dist/index.js\"],\"env\":{...}}'\n```\n\n**Important:** Stop the server (Ctrl+C), then copy and run that `claude mcp add-json ...` command. Claude Code manages starting the server automatically — you don't need to keep it running manually.\n\n### Step 3: Start Claude Code\n\nNow start Claude Code:\n\n```bash\nclaude\n```\n\nThat's it! Claude will automatically start the MCP server in the background when needed.\n\n### Step 4: Verify Everything Works\n\nRun these quick checks to confirm your setup:\n\n```bash\n# Check that the MCP server is registered\nclaude mcp list\n# Should show \"edgar\" in the list\n\n# Check that the skill is installed\nls ~/.claude/skills/edgar-change-interpreter\n# Should show the skill files\n```\n\n**Quick test prompt** — paste this into Claude Code to confirm both the skill and MCP server are working:\n\n```text\nUse the edgar tools to resolve the company \"AAPL\" and tell me their CIK number.\n```\n\nIf you see a CIK number (like 0000320193), you're all set.\n\n---\n\n## Usage Examples\n\n### Without MCP Server (Manual)\n\nJust paste filing text directly into Claude:\n\n```text\nAnalyze the material changes and silent risks in this 10-Q excerpt:\n\n[PASTE FILING TEXT HERE]\n```\n\n### With MCP Server (Automatic)\n\nAsk Claude to fetch the filing for you:\n\n```text\nUse the edgar tools to fetch Apple's latest 10-K and analyze it for material changes.\n```\n\nOr be more specific:\n\n```text\nFetch AAPL's latest 10-K with the prior period included, then analyze the changes in their risk factors.\n```\n\n### Available MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `edgar.resolve_company` | Convert a ticker (AAPL) to a CIK number |\n| `edgar.latest_filing` | Get metadata for the most recent filing |\n| `edgar.fetch_filing_text` | Download and convert a filing to plain text |\n| `edgar.get_and_prepare_for_skill` | All-in-one: fetch filing(s) and prepare for analysis |\n\n---\n\n## Troubleshooting\n\n### Skill not being used\n\nIf Claude analyzes a filing without the structured output format (Material Changes, Silent Risks, etc.), the skill might not be installed correctly.\n\n**Check the skill is installed:**\n```bash\nls ~/.claude/skills/edgar-change-interpreter/skill.md\n```\n\nIf the file doesn't exist, re-run Step 1 to copy the skill folder.\n\n**Tip:** You can explicitly invoke the skill by typing `/edgar-change-interpreter` in Claude Code, or by mentioning \"use the edgar change interpreter skill\" in your prompt.\n\n### \"File content exceeds maximum allowed size\"\n\nThe filing text was too large. Try asking for a smaller excerpt or specific sections:\n\n```text\nFetch AAPL's 10-K but focus only on the Risk Factors section.\n```\n\n### MCP server not responding\n\n1. Check that you registered it with Claude (`claude mcp list` should show \"edgar\")\n2. Try removing and re-adding it: `claude mcp remove edgar`, then run the add command again\n3. Check your `.env` file has valid SEC_USER_AGENT values\n\n---\n\n## About CMD+RVL\n\nCMD+RVL builds decision-grade data, signals, and evidence for financial analysis. This skill is an open, standalone component of that work, designed to make interpretation and uncertainty explicit.\n\n---\n\n## Extending this skill\n\nYou can optionally pair this with historical filing packs or MCP/API fetchers for easier sourcing. It always works standalone with pasted text when you want a minimal, offline workflow.\n\n---\n\n## Disclaimer\n\nThis skill provides decision support only and does not offer investment advice. Always verify findings against the original SEC filings.\n\n---\n\n## Appendix A: Installing Node.js with nvm\n\n[nvm](https://github.com/nvm-sh/nvm) (Node Version Manager) is the easiest way to install and manage Node.js versions.\n\n### macOS / Linux\n\nOpen Terminal and run:\n\n```bash\n# Install nvm\ncurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash\n\n# Restart your terminal, then install Node.js\nnvm install 20\nnvm use 20\n\n# Verify it worked\nnode --version  # Should show v20.x.x\n```\n\n### Windows\n\nUse [nvm-windows](https://github.com/coreybutler/nvm-windows):\n\n1. Download the installer from the [releases page](https://github.com/coreybutler/nvm-windows/releases)\n2. Run the installer\n3. Open a new Command Prompt and run:\n\n```bash\nnvm install 20\nnvm use 20\nnode --version\n```\n\n---\n\n## Appendix B: Setting Up Claude CLI\n\nThe Claude CLI lets you use Claude from your terminal with MCP tool support.\n\n### Install Claude CLI\n\n```bash\n# macOS (using Homebrew)\nbrew install claude\n\n# Or using npm (any platform)\nnpm install -g @anthropic-ai/claude-cli\n```\n\n### First-Time Setup\n\n```bash\n# Authenticate with your Anthropic account\nclaude login\n\n# Verify it's working\nclaude --version\n```\n\n### Managing MCP Servers\n\n```bash\n# List registered MCP servers\nclaude mcp list\n\n# Add a server (the edgar server prints this command for you)\nclaude mcp add-json edgar '{\"type\":\"stdio\",\"command\":\"node\",\"args\":[\"/path/to/index.js\"]}'\n\n# Remove a server\nclaude mcp remove edgar\n\n# Test a server\nclaude mcp get edgar\n```\n\n### Using Claude with MCP Tools\n\nOnce the edgar server is registered, just start a conversation:\n\n```bash\nclaude\n\n# Then type your request:\n\u003e Fetch Apple's latest 10-K and summarize the key risk factors.\n```\n\nClaude will automatically use the edgar tools when needed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmdrvl%2Fedgar-change-interpreter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmdrvl%2Fedgar-change-interpreter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmdrvl%2Fedgar-change-interpreter/lists"}