US Crowding Radar

Monitor de riesgo de crowding en acciones estadounidenses, local primero y explicable.

¿Qué es US Crowding Radar?

US Crowding Radar es una herramienta de inteligencia de mercado de solo lectura que monitorea el riesgo de 'crowding' (sobreconcentración) en acciones estadounidenses. Está diseñada para ser ejecutada localmente, priorizando la privacidad de la clave API del usuario y la transparencia de los resultados. La herramienta ofrece una interfaz de línea de comandos (CLI) en Python con comandos para verificar la configuración (`doctor`), gestionar una lista de seguimiento (`watchlist`), realizar escaneos de crowding (`scan`) con opciones de caché y notificación, y ejecutar un panel web local (`serve`). El panel web pide la clave API al usuario a través de su interfaz y la valida contra el endpoint oficial de Clawby, pudiendo guardarla de forma segura en un archivo local ignorado por Git. Los resultados del escaneo incluyen puntuaciones, direcciones, cobertura, evidencia de componentes, marcas de tiempo de las fuentes y dimensiones fallidas, todo presentado de manera conjunta y sin interpretarse como consejo de inversión.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add lionman888/us-crowding-radar

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace US Crowding Radar?

Usa la CLI de Python probada en este repositorio. No reimplementes la puntuación ni llames a interfaces no documentadas directamente.

Seguridad

  • Esta es inteligencia de mercado de solo lectura, no ejecución de operaciones.
  • Nunca solicites, imprimas, registres ni coloques CLAWBY_API_KEY en argumentos de comandos.
  • El panel acepta la clave a través de su interfaz local, la valida contra el endpoint oficial /api/account de Clawby y puede guardarla en el archivo de credenciales local ignorado por Git con modo 600.
  • La automatización CLI lee la clave solo del entorno o del archivo ignorado .env.
  • Nunca describas la puntuación de crowding como un pronóstico de precio o consejo de inversión.

Comandos

Desde la raíz del repositorio:

python3 -m us_crowding_radar doctor
python3 -m us_crowding_radar watchlist list
python3 -m us_crowding_radar watchlist add TICKER --label "Compañía"
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

Flujo de trabajo

  1. Para el panel, pide al usuario que ingrese su propia clave en la interfaz local; nunca la repitas ni la registres. Una validación exitosa se puede restaurar desde el archivo de credenciales local protegido.
  2. Para la automatización CLI, ejecuta doctor e informa solo si la clave del entorno está configurada.
  3. Confirma la lista de seguimiento antes de un escaneo en vivo.
  4. Usa scan para una ejecución autorizada de solo lectura en caché o scan --refresh para datos remotos nuevos.
  5. Informa juntos la puntuación, dirección, cobertura, evidencia de componentes, marcas de tiempo de las fuentes y dimensiones fallidas.
  6. Usa --notify solo cuando el usuario haya configurado y autorizado el destino de notificación.

Validación

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

Skills relacionados