Claw-Screener

一款股票筛选器，将技术分析（威廉指标 %R 超卖信号）与基于美国证券交易委员会（SEC）数据的沃伦·巴菲特式基本面分析相结合。支持美国（标普 500）和泰国（SET）市场。

何时使用本技能

当您需要执行以下操作时，请使用本技能：

• 寻找技术面超卖、基本面强劲的股票
• 基于巴菲特的 10 条公式筛选优质股票
• 使用 Carlson 筛选标准（ROIC、增长性、股票回购）筛选长期复利型股票
• 对单只股票进行深度分析以辅助投资决策
• 以文本、JSON 或 Telegram 格式获取每日股票筛选结果

工具

本技能提供以下功能：

1. 综合筛选

同时满足技术面超卖（威廉指标 %R < -80）与基本面强劲（巴菲特评分 ≥ 设定阈值）条件的股票。

命令：

bun run src/screening.ts [选项]

选项：

示例：

bun run src/screening.ts
bun run src/screening.ts --market us --min-score 7 --top-n 5
bun run src/screening.ts --market bk
bun run src/screening.ts --format json
bun run src/screening.ts --format telegram

2. 纯技术面扫描

仅使用威廉指标 %R 进行快速超卖扫描，无需 SEC 数据，适用于美国与泰国市场。

命令：

bun run src/technicalOnly.ts [选项]

选项：

示例：

bun run src/technicalOnly.ts
bun run src/technicalOnly.ts --threshold -70 --top-n 50
bun run src/technicalOnly.ts --market bk

3. 单股分析

使用巴菲特的 10 条公式对单只股票进行深度分析。

命令：

bun run src/analyze.ts  [选项]

选项：

示例：

bun run src/analyze.ts AAPL
bun run src/analyze.ts MSFT --format telegram
bun run src/analyze.ts GOOGL --format json
bun run src/analyze.ts PTT.BK

4. 复利机器（Compounding Machine）

采用 Carlson 风格筛选标准识别“复利型股票”：

• 营收与净利润同比趋势强度
• ROIC 阈值（默认 >15%）
• 三年内流通股数量减少（股票回购信号）
• 营业利润率阈值（默认 >20%）
• 包含当前股息收益率与五年均值对比，以及简化的十年 DCF 情境参考

命令：

bun run src/compoundingMachine.ts [选项]

选项：

示例：

bun run src/compoundingMachine.ts
bun run src/compoundingMachine.ts --tickers AAPL,MSFT,NVDA --top-n 10
bun run src/compoundingMachine.ts --format json --max-tickers 100
bun run src/compoundingMachine.ts --tickers PLTR --show-rejected

运行时 / 缓存说明：

• 首次对完整美国市场范围执行无缓存运行耗时约 20–30+ 分钟。
• 此为预期行为：每个股票需发起多个 Yahoo 基本面/行情请求，并在限频场景下自动重试退避。
• 后续运行因 SQLite 缓存（sec_cache.db，默认 TTL 为 7 天）而显著加速。
• 如需快速验证，建议先执行小范围扫描（例如 --max-tickers 50 或指定 --tickers）。

代理向用户发送消息的指导原则：

• 若用户执行全市场范围的复利机器扫描，请明确提醒其首次运行可能耗时约 20–30 分钟。
• 建议用户在等待期间尝试快速验证替代方案：
  • bun run src/compoundingMachine.ts --max-tickers 50
  • bun run src/compoundingMachine.ts --tickers AAPL,MSFT,NVDA

5. 自选股管理

跟踪您关注的股票，并在它们进入超卖或超买状态时接收提醒。

命令：

bun run src/watchList.ts <命令> [选项]

命令：

选项：

示例：

bun run src/watchList.ts add AAPL
bun run src/watchList.ts add AAPL --market us --notes 'Big tech'
bun run src/watchList.ts add PTT.BK --market th
bun run src/watchList.ts remove AAPL
bun run src/watchList.ts list
bun run src/watchList.ts list --market us

存储位置：自选股保存至 ~/.claw-screener-watchlist.json

巴菲特的 10 条公式

基本面分析依据沃伦·巴菲特的投资标准对股票进行评估：

评分规则：每项达标得 1 分，满分 10 分。

技术指标

威廉指标 %R（Williams Percent Range）

• 取值范围：-100 至 0
• 超卖区间：< -80（潜在买入信号）
• 超买区间：> -20（潜在卖出信号）

综合评分公式

综合得分 = （技术得分 × 0.3） + （基本面得分 × 0.7）

• 技术得分 = (威廉指标 %R + 100) / 100
• 基本面得分 = (巴菲特评分 / 10) × 100

数据来源

• 美股：基本面数据来自 SEC EDGAR，价格数据来自 Yahoo Finance
• 泰股：仅使用 Yahoo Finance（无 SEC 数据可用）

安装

运行时要求

• Bun（>=1.3.1）—— 执行 TypeScript 脚本所需的运行时环境
• 无需安装 Node.js，Bun 已内置全部必需运行时功能

安装 Bun

若您尚未安装 Bun，请运行：

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

# Windows（PowerShell）
iwr https://bun.sh/install -outfile "install.ps1"; ./install.ps1

安装依赖

bun install

文件持久化

本技能创建并管理以下文件：

缓存管理

• 缓存文件将在首次运行时自动创建
• 可通过 --ttl-days 参数调整复利机器的缓存 TTL
• 删除缓存文件可强制重新拉取最新数据
• 缓存可显著提升后续运行性能

注意事项

• 首次对完整美股范围执行运行耗时约 20–30+ 分钟（属正常行为）
• 后续运行因缓存机制大幅提速
• 快速测试推荐使用 --max-tickers 50 或指定 --tickers

Bun 脚本别名

bun run dev              # 运行筛选（等价于 bun run src/screening.ts）
bun run screening        # 运行综合筛选
bun run technical        # 运行纯技术面扫描
bun run analyze          # 分析单只股票（需传入 ticker 参数）
bun run compounder       # 运行复利机器筛选器
bun run watchlist:add    # 将股票加入自选股
bun run watchlist:remove # 从自选股中移除股票
bun run watchlist:list   # 列出自选股中的股票

输出格式示例

文本格式（默认）

📊 综合质量筛选（美国（标普 500））
技术面：超卖信号（威廉指标 %R < -80）
基本面：基于 SEC 数据的巴菲特 10 条公式
最低巴菲特评分：5/10

结果：
  总扫描数：503
  超卖股票数：42
  高质量股票数：8（巴菲特评分 ≥5/10）

前 10 大机会：

1. AAPL   — 综合得分：85.2% | 巴菲特评分：8/10 | WR：-82.3
2. MSFT   — 综合得分：79.1% | 巴菲特评分：7/10 | WR：-85.1

Telegram 格式

📊 综合质量筛选（美国（标普 500））
扫描总数：503 只股票
超卖数量：42
高质量（巴菲特评分 ≥5/10）：8

🌟 前 10 大高质量机会：

1. **AAPL** — 综合得分：85% | 巴菲特评分：8/10 | WR：-82.3
2. **MSFT** — 综合得分：79% | 巴菲特评分：7/10 | WR：-85.1