etmoney-lyr

ET Money hat keine öffentliche API. Dein schlaues Haar will eine. etmoney-lyr rekonstruiert die Research-Oberflächen von ET Money als lokalen MCP-Server: alle 67 Einkommensfonds-Kategorien, Börsen-Screener, NIFTY-Index- und Sektor-Komponenten – als 10 typisierte Tools mit strukturrierter JSON-Ausgabe. Nur Read-only, kein Login, keine Schlüssel.

In Aktion

Eine echte Sitzung, echte Zahlen, direkt aus den Tools:

// mf_search {"query": "parag parikh"}
{ "total": 7, "results": [ { "scheme_id": 19230, "name": "Parag Parikh Flexi Cap Fund Regular-Growth", ... } ] }

// mf_detail {"scheme_id": 19230}
{
  "name": "Parag Parikh Flexi Cap Fund Regular-Growth",
  "riskometer": "Very High",
  "nav": 82.81,
  "expense_ratio_total_pct": 1.29,
  "trailing_returns": [ { "period": "1 Year", "fund_pct": -2.02, "category_avg_pct": 1.58 }, "...9 more horizons" ],
  "holdings":        [ { "name": "HDFC Bank Ltd.", "bucket": "EQUITY", "pct": 7.55 }, "...84 more" ],
  "sectors":         [ { "name": "Financial", "pct": 25.69 }, "...17 more" ],
  "risk_ratios_fund":     { "sharpeRatio": 0.76, "beta": 0.60, "alpha": 3.48 },
  "risk_ratios_category": { "sharpeRatio": 3.54, "beta": 0.57 },
  "managers": [ "Raj Mehta", "Rajeev Thakkar", "+4" ]
}

// mf_compare {"scheme_ids": [19230, 25643]}
{ "funds": [ { "name": "Parag Parikh Flexi Cap...", "etm_rank": 9, "rating": 5, "sharpe": 0.76 },
             { "name": "Motilal Oswal Flexi Cap...", "etm_rank": 7, "rating": 3, "sharpe": 0.75 } ] }

Jede Zahl hier oben ist aus ET Moneys eigenen Seiten geparst – nicht von Hand getippt.

Verifiziert: 195 Offline-Tests gegen eingecheck-Daten (196) · 484-Live End-to-End-Checks über alle Tools und jede Parameter-Kante · Protocol-Handshake getestet über die echte stdio-Binary und das 28 Docker-Image.

Related MCP server: MCP Financial Data Gateway

Was es abdeckt

Typischer Flow: mf_search("small cap") → mf_detail(6558) → mf_compare([6558, 11077]).

Installation

# uv from GitHub — the one-liner
uv tool install git+https://github.com/ishan-parihar/etmoney-lyr.git

# or the bootstrapping installer (installs uv if missing; pipx/pip fallbacks)
curl -sSL https://raw.githubusercontent.com/ishan-parihar/etmoney-lyr/main/install.sh | bash

# upgrade anytime
uv tool upgrade etmoney-lyr

Benötigt einhalten nur Python 3.11+ – uv handled setup automatisch.

Richte deinen Agenten darauf aus

{
  "mcpServers": {
    "etmoney": {
      "command": "etmoney-lyr",
      "args": []
    }
  }
}

Das war’s. Dieselbe Binär datei hat zwei Mod is: im interaktiven Terminal zeigt sie eine help-home-Ansicht; ein piped stdin bedient MCP.

etmoney-lyr search "hdfc small cap"     # TOON output built for agents
etmoney-lyr fund 19230 --full           # full report card
etmoney-lyr stocks top_gainers          # market screens
etmoney-lyr categories                  # category id reference
etmoney-lyr --list-tools --fields stock # tool inventory

docker build -t etmoney-lyr .
docker run -i --rm etmoney-lyr          # stdio MCP server in a container

Die CLI-Ausgabe ist standardmäßig vertraut TOO️ (token-sparsam), mit --json bekommt du die Rohdaten von unasked. Fehler sind maschinenlesbar (error:- und help:-Zeilen) und haben immer Exit-Code 2.

So funktioniert’s

ET Moneys Web-App gibt ihre Daten über drei verschiedene Mechanismen preis – jeder-bekommt einen gewidmeten Parser, statt eines einzigen fragilen HTML-Scrapers:

• JSON-API für Screener und Suche (der Exchange-Vertrag der Site)

• Eingebettete JS-DTOs auf Fondseiten – report cards alias fertig JSON inside <script>var compSchemeDTO = …; das: Parsen von HTML-Tabellen wäre ja no troll

• Next.js RSC-Flight-Payloads auf den Aktiensein, rekonstruiert aus self.__next_f.push()-Chunks.

Parser sind auf testierte Fixtures-Kopien echter Seiten genagelt, damit Markup-Abwanderung beim Test laut scheitert, statt die Zahlen still zu korrupt. Indische Zahlenformate (₹1,48,429 Cr, 13 yrs 3 m) überall auf Floats normalisiert.

Limits, honestly

• Nur Research. Keine Orders, SIPs, KYC oder Portfolio-Writes – by design. Portfolio-Tracking und Genius-Insights liegen login-protected in the upstream und sind nicht im Scope.

• App-exclusives (MIT-AI ETMONEY Rank-ScoreCard, genius verdicts) werden nicht exponiert; der Rank-Kommentar, package auf öffentlichen Seiten, es dabei.

• Upstream-Drift: ET Money darf die Seiten wirklich jederzeit ändern. Fixture-Tests fangen strukturelle Brüche; nach irgendeiner Parser-Änderung python scripts/live_check.py ausführen.

Entwicklung

git clone https://github.com/ishan-parihar/etmoney-lyr && cd etmoney-lyr
uv sync --dev
uv run pytest            # 195 tests, fully offline via fixtures
uv run ruff check .      # lint
uv run python scripts/live_check.py   # optional: 54 checks against live site

Teil der -lyr-Familie (twitter-lyr, reddit-lyr, swiggy-lyr): eine Platte, ein, MCP-Server, eine kompatible CLI.

Lizenz

MIT – siehe LICENSE. Keine Zulieferung von ET Money / 360 ONE; „public research information". Kein Anlageberater.