lopjlb 0.1.0

LOPJLB quantitative equity research client — regime, signals, earnings intel (yfinance-shaped, BFF-backed)

lopjlb

Thin Python client + CLI for LOPJLB quantitative equity research.

Talks only to https://www.lopjlb.com/bff/api/ (never api.lopjlb.com).

Four peer surfaces over one BFF (CLI does not call MCP):

Surface	Install / use
REST	curl https://www.lopjlb.com/bff/api/…
CLI	uv tool install lopjlb · brew install lopjlb/tap/lopjlb · curl -fsSL https://www.lopjlb.com/install.sh | sh
PyPI	pip install lopjlb / import lopjlb
HTTP MCP	Cursor / Claude → POST /bff/api/mcp (Enterprise hosts)

License: Proprietary — not open source. Copyright © LOPJLB Research. All rights reserved. See the repository LICENSE. You may use this client only to access LOPJLB’s published services under LOPJLB’s terms; you may not relicense or redistribute it as free/open source.

Install

# recommended
uv tool install lopjlb

# or
pipx install lopjlb
pip install lopjlb

# one-liner
curl -fsSL https://www.lopjlb.com/install.sh | sh

# Homebrew (after tap publish)
brew install lopjlb/tap/lopjlb

Free research needs no browser and no API key.

Free (no account)

Same insights as /stock/AAPL — direction, HMM regime, factor scores, earnings CallCards:

import lopjlb

print(lopjlb.regime())
t = lopjlb.Ticker("AAPL")
print(t.summary())       # direction, regime, scores (+ next_actions via CLI)
print(t.intel())         # earnings CallCard / rollup
print(t.info)            # company profile

lopjlb ticker AAPL
lopjlb ticker AAPL intel
lopjlb regime
lopjlb search NVDA
lopjlb schema          # CLI → REST map (not MCP)
lopjlb doctor

Stdout is JSON (pretty on a TTY). Errors go to stderr as JSON with retryable. No interactive prompts.

Enterprise (REST)

Mint a key once in Settings (browser once), then:

export LOPJLB_API_KEY=lopjlb_live_…
lopjlb export signals --format csv --out signals.csv
lopjlb intraday AAPL

client = lopjlb.Client(api_key="lopjlb_live_…")

Optional MCP debug smoke (hosts should call /mcp directly):

lopjlb debug mcp tools
lopjlb debug mcp call get_market_regime

Errors: 401 bad key · 402 entitlement · 429 rate limit.

Not included

Raw OHLCV dumps / FMP passthrough. Use sparklines / charts via the API or the stock page.