Claw-Screener

Stock screener combining technical analysis (Williams %R oversold signals) with Warren Buffett-style fundamental analysis using SEC data. Supports US (S&P 500) and Thai (SET) markets.

Installation

npm install

Agent Skills

This repo includes a Agent Skills-compatible SKILL.md for AI agents.

OpenClaw / Clawdbot

openclaw skills install git:rsoutar/claw-screener@main
cd  && npm install

Hermes Agent

Clone the full repo (the skill needs the TypeScript sources, not just SKILL.md):

git clone https://github.com/rsoutar/claw-screener.git ~/.hermes/skills/finance/claw-screener
cd ~/.hermes/skills/finance/claw-screener && npm install

Or add an existing clone to ~/.hermes/config.yaml:

skills:
  external_dirs:
    - ~/Projects/claw-screener

Then use /claw-screener in chat, or ask Hermes to screen or analyze stocks. See SKILL.md for full command reference.

Scripts

1. Combined Screening (screening.ts)

Runs both technical and fundamental analysis to find quality oversold stocks.

npm run screening [options]

Options:

Examples:

# US market, default settings
npm run screening

# US market, stricter fundamental requirements
npm run screening -- --market us --min-score 7 --top-n 5

# Thai market (technical only, no SEC data)
npm run screening -- --market bk

# JSON output for automation
npm run screening -- --format json

# Telegram format for messaging apps
npm run screening -- --format telegram

2. Technical Only (technicalOnly.ts)

Fast oversold scan using Williams %R indicator only. No SEC data required.

npm run technical [options]

Options:

Examples:

# Default scan
npm run technical

# More oversold stocks
npm run technical -- --threshold -70 --top-n 50

# Thai market
npm run technical -- --market bk

3. Analyze Stock (analyze.ts)

Deep analysis of a single stock using Buffett’s 10 formulas.

npm run analyze --  [options]

Options:

Examples:

# Analyze a US stock
npm run analyze -- AAPL

# Analyze with Telegram format
npm run analyze -- MSFT --format telegram

# JSON for programmatic use