HTML explainer artifact

Add NSE India Printing Press tool to Claude Code

Source: https://github.com/mvanhorn/printing-press-library/tree/main/library/developer-tools/nse-india
Generated: 2026-05-22T06:48:30Z

NSE India Printing Press CLI — explainer

What this link is

Type: GitHub subdirectory for a generated Printing Press CLI, not just a README/bookmark.
Target: mvanhorn/printing-press-library/library/developer-tools/nse-india.
Stack: Go 1.23+ CLI built with Cobra, modernc.org/sqlite for local state, and mcp-go for an MCP server surface.
Purpose: Give agents/scripted workflows read-only access to NSE India equity, index, corporate filing, mover, and market-status data without API keys or a Python runtime.

Source map

nse-india/
├─ README.md              install/use docs and command reference
├─ SKILL.md               agent skill wrapper for Claude/Codex/Hermes-style use
├─ AGENTS.md              local rules for agents modifying/using the generated CLI
├─ cmd/
│  ├─ nse-india-pp-cli/   terminal CLI entrypoint
│  └─ nse-india-pp-mcp/   MCP server entrypoint for Claude Desktop/tool clients
├─ internal/
│  ├─ cli/                Cobra command tree
│  ├─ client/             NSE HTTP client/browser-header behavior
│  ├─ store/              SQLite persistence for cross-session analysis
│  ├─ mcp/                MCP tool surface mirroring the CLI
│  └─ types/cache/config  support packages
├─ research.json          alternatives and generated feature rationale
└─ dogfood-results.json   generated verification report

What it can do

Live market checks: market status, quotes, index constituents, active movers.
Equity detail: 52-week high/low, sector PE, order-book depth, delivery %, VaR margin, index memberships, pre-open IEP.
Corporate data: actions, announcements, annual reports, financial results, insider-trading disclosures.
Local-state analytics: delivery spikes, IEP drift, announcement floods, sector breadth, index-driver attribution, portfolio P&L/margin health, delivery-price divergence.
Agent-friendly output: --json, --select, --dry-run, and --agent for compact non-interactive JSON behavior.

Install/use path for Dab

# Printing Press route: CLI + skill
npx -y @mvanhorn/printing-press install nse-india

# CLI only
npx -y @mvanhorn/printing-press install nse-india --cli-only

# Hermes skill route from the README
hermes skills install mvanhorn/printing-press-library/cli-skills/pp-nse-india --force

# Go fallback, CLI only
go install github.com/mvanhorn/printing-press-library/library/developer-tools/nse-india/cmd/nse-india-pp-cli@latest

Quick checks after install:

nse-india-pp-cli --version
nse-india-pp-cli doctor --json
nse-india-pp-cli agent-context --pretty
nse-india-pp-cli market status --agent
nse-india-pp-cli equity quote RELIANCE --agent

Authentication / operational caveat

No API key is expected; it mimics browser-compatible NSE website headers.
Some options-chain flows may need a browser session cookie via nse-india-pp-cli auth login --chrome if data comes back empty.
Treat it as read-only market-data tooling; it should not be used for trading/order placement.

Maturity signals

Generated by Printing Press v4.0.4 with recorded run metadata.
GoReleaser config, Makefile, lint config, Apache-2.0 license, CLI and MCP entrypoints.
Dogfood report says PASS: 42 commands defined/registered, 10/10 examples valid, 8/8 novel features found, MCP surface parity passing, no dead flags/functions reported.
Main risk is upstream fragility: NSE website endpoints/header requirements can change, so useful cron workflows need health checks and graceful empty-data handling.

Fit for Ananth / Dab workflows

Strong fit if Ananth wants Indian-market monitoring from Dab: morning market status, portfolio watch, corporate-action alerts, delivery-spike scans, or market snippets for the daily podcast/briefing pipeline.
Good candidate to install as a Dab/Hermes skill because it gives agents a clean command surface instead of scraping NSE ad hoc.
Best first automation: a small read-only daily NSE briefing job that runs market status, selected equity quote checks, and one local-state scan after a few days of sync history.

Suggested next step

Install CLI-only first on the Pi, verify doctor and a quote command, then decide whether to install the Hermes skill wrapper. Avoid building workflows until a few sample NSE calls are confirmed live from the Pi network.