airesearch-plugin

AIResearch Plugin

Six-lens equity research inside your coding agent. One command, one
integrated report — no lens-picking, no chat limits, powered by whatever
model you already pay for.

Lenses: Supply Chain & Value Flow · Fundamentals · Macro · Technicals ·
Sentiment & Positioning · Risk Matrix & Conviction

Install — Claude Code

/plugin marketplace add WOOK98/airesearch-plugin
/plugin install airesearch@airesearch-marketplace

Then reload plugins (or restart Claude Code) and run the namespaced
commands:

/reload-plugins
/airesearch:deep-dive NVDA          # full six-lens report
/airesearch:deep-dive AXTI risk     # single-lens focus
/airesearch:deep-dive "Humanoid robot"  # industry mode: value chain + constituent universe
/airesearch:snapshot MU             # 30-second read
/airesearch:morning-brief           # watchlist triage

The skills also trigger implicitly — just ask "give me a deep dive on LITE"
or "quick take on SNDK?".

No API key needed to start — skills work with web search out of the box.
For live market data, see Pro data layer.

Install — ChatGPT / Codex Personal Marketplace

The repository ships a .codex-plugin/plugin.json manifest and marketplace
assets. See docs/codex-install.md for the personal
marketplace JSON and local install steps.

After install, the same skill prompts are available from the plugin card.

Install — DeepSeek Harness

AIResearch also ships a DSH bundle. It registers four skills in the Harness
skill catalog: airesearch-snapshot, airesearch-deep-dive,
airesearch-morning-brief, and airesearch-filing.

npx @dsh-1024store/cli add WOOK98/airesearch-plugin --profile web

After installation, restart the web profile if it is already running.
Then ask naturally:

snapshot TSLA
deep dive Humanoid robot
morning brief NVDA, TSLA, 0700.HK
filing NVDA latest 10-K

DeepSeek harness adapter

For non-Claude/Codex runners, this repository also ships a prompt-only
DeepSeek harness bundle under deepseek-harness/. It contains a task
manifest, shared system prompt, task prompts, and a zero-dependency Python
runner:

python3 deepseek-harness/run.py snapshot TSLA --dry-run
export DEEPSEEK_API_KEY=sk_your_key
python3 deepseek-harness/run.py deep_dive NVDA --context-file verified-context.json

The adapter expects verified market, filing, news, or holdings context from
the host harness. If context is missing, the prompts require unsupported
sections to be withheld instead of guessed.

Structure

├── .claude-plugin/          # plugin + marketplace manifests
├── deepseek-harness/        # DeepSeek-compatible prompt bundle + runner
├── commands/                # /airesearch:deep-dive, /airesearch:snapshot, /airesearch:morning-brief
└── skills/
    ├── deep-dive/
    │   ├── SKILL.md         # report skeleton: 6 sections, output spec
    │   └── references/      # one methodology file per lens
    ├── snapshot/SKILL.md
    └── morning-brief/SKILL.md

Credits

The Supply Chain lens is distilled from the public analytical framework of
Serenity (@aleabitoreddit). For the full
distillation with dated examples and track-record calibration, install the
companion skill: WOOK98/serenity-aleabitoreddit.

Pro data layer (optional)

The plugin ships with an .mcp.json pointing at the hosted
airesearch-data MCP server — 5 tools delivering real-time quotes,
GAAP fundamentals, deterministic technicals, and constituent data.
No LLM-estimated indicators, ever.

Set your key before starting Claude Code:

export AIRESEARCH_API_KEY=mcp_your_beta_key

Use the bare key value only, with no NAME= prefix and no quotes. The
client-side environment variable is always AIRESEARCH_API_KEY; do not set
MCP_API_KEYS locally, because that is the server-side allowlist variable.

Don't have a key yet? During the beta, DM @wook98
or email [email protected] — keys are issued manually while the
self-serve dashboard is in development (see Roadmap below).

Without a key the plugin still works — skills fall back to web search.

Roadmap

• v0.3 — Industry Mode. ✅ Shipped: get_etf_holdings MCP tool
  (ETF constituent data + industry universe builder), entity resolution
  hardening. Server version: 0.3.0.
• v0.2 — Data MCP server. ✅ Shipped: resolve_entity, get_quote,
  get_financials, get_technicals at airesearchs.com/api/mcp.
• v0.4 — Judgment-first reports + Morning Brief. Adds the Goldman-style
  report skeleton (three falsifiable judgments, thesis invalidation
  conditions, machine-readable monitor panel), namespaced command metadata,
  and the watchlist Morning Brief skill. Per-user API keys remain manual
  during beta.

Data integrity

Four layers protect against hallucinated data:

1. Entity resolution first — every query resolves to a verified listed ticker before any data fetch.
2. Deterministic indicators — RSI, MACD, moving averages computed from raw OHLCV bars, never LLM-estimated.
3. Source-attributed fundamentals — GAAP financials pulled live from market data tools, not cached summaries.
4. Graceful degradation — if the MCP server is unreachable, skills fall back to web search with a visible warning.

Disclaimer

Decision-support analysis, not financial advice. This plugin never places,
modifies, or cancels orders. Verify all prices and fundamentals before
acting.

→ /plugin marketplace add WOOK98/airesearch-plugin · Docs

MIT licensed.