Community研究與資料分析github.com

lionman888/us-crowding-radar

本地優先的美股擁擠風險監控工具,提供可解釋的評分與儀表板。

us-crowding-radar 是什麼?

這是一個在地優先、具備可解釋性的美股擁擠風險監控工具。它透過 Python CLI 以及本機 Web 儀表板,幫助使用者評估特定股票的擁擠程度(即市場中過度集中的籌碼與資金)。該工具使用 Clawby 的 API 來取得數據,並進行多維度評分,包括方向、覆蓋率、元件證據等。支援 watchlist 管理、掃描(可快取或強制重新整理)、以及選擇性通知功能。所有敏感憑證(如 CLAWBY_API_KEY)僅從環境變數或受保護的本機檔案讀取,確保安全。此工具主要適用於開發者與量化交易者,支援在 Cursor、Claude Code 等 AI 編碼環境中執行,並強調不應將擁擠分數視為價格預測或投資建議。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add lionman888/us-crowding-radar

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

US Crowding Radar

請使用本倉庫中已測試的 Python CLI。請勿重新實作評分邏輯或直接呼叫未文件化的介面。

安全性

  • 這是唯讀的市場情報,非交易執行。
  • 絕對不要請求、列印、記錄或將 CLAWBY_API_KEY 放入命令引數中。
  • 儀表板透過其本機 UI 接受金鑰,會針對 Clawby 的官方 /api/account 端點驗證,並可將其儲存至 Git 忽略的本機憑證檔案,權限設定為 600。
  • CLI 自動化僅從環境變數或被忽略的 .env 檔案讀取金鑰。
  • 切勿將擁擠分數描述為價格預測或投資建議。

命令

從倉庫根目錄執行:

python3 -m us_crowding_radar doctor
python3 -m us_crowding_radar watchlist list
python3 -m us_crowding_radar watchlist add TICKER --label "Company"
python3 -m us_crowding_radar watchlist remove TICKER
python3 -m us_crowding_radar scan
python3 -m us_crowding_radar scan --refresh
python3 -m us_crowding_radar scan --notify
python3 -m us_crowding_radar serve --port 8786

工作流程

  1. 對於儀表板,要求使用者在本地 UI 中輸入他們自己的金鑰;絕不要重複或記錄它。成功的驗證結果可從受保護的本機憑證檔案中還原。
  2. 對於 CLI 自動化,執行 doctor 並僅回報環境金鑰是否已設定。
  3. 在進行即時掃描前確認 watchlist。
  4. 使用 scan 進行快取的授權唯讀執行,或使用 scan --refresh 取得最新的遠端資料。
  5. 一併回報分數、方向、覆蓋率、元件證據、來源時間戳記以及失敗的維度。
  6. 僅在使用者已設定並授權通知目標時才使用 --notify。

驗證

python3 -m unittest discover -s tests -v
node --check us_crowding_radar/web/app.js
python3 -m compileall -q us_crowding_radar

相關技能