Un analizzatore di azioni da 71.000 stelle che gira sul cron gratuito di GitHub

La maggior parte dei progetti di "agenti IA" sono demo che richiedono che qualcuno prema esegui. Cloni il repository, installi quaranta dipendenze e poi scopri che l'intelligenza è reale e l'operatività è immaginaria. Nessuno vuole essere quello che si ricorda di lanciarlo ogni mattina.
ZhuLinsen/daily_stock_analysis, con circa 71.600 stelle e una delle voci più sorprendenti della classifica settimanale delle tendenze di GitHub questo mese, appartiene alla specie opposta. È progettato per essere dimenticato. Fai il fork, riempi qualche secret, attivi un workflow, e un dashboard arriva nella tua app di messaggistica alle 18:00 ora di Pechino di ogni giorno di borsa, che tu ci abbia pensato o no.
Il sistema copre i mercati di azioni A, Hong Kong, Stati Uniti, Giappone, Corea e Taiwan per una watchlist che decidi tu. Recupera dati di mercato e notizie, fa passare l'insieme da un LLM e spinge un dashboard decisionale su WeCom, Feishu, Telegram, Discord, Slack o email. Licenza MIT, Python 3.10 e successivi, con un paper su arXiv dietro.
La configurazione è il prodotto
La strada di GitHub Actions richiede circa cinque minuti e non ha bisogno di alcun ambiente locale.
Fai il fork del repository. Aggiungi i secret del repository. `STOCK_LIST` è l'unico obbligatorio, nel formato di codici separati da virgole su più mercati: `600519,hk00700,AAPL,7203.T,005930.KS,2330.TW`. Scegli almeno un canale di notifica: `WECHAT_WEBHOOK_URL`, `FEISHU_WEBHOOK_URL`, `TELEGRAM_BOT_TOKEN` più `TELEGRAM_CHAT_ID`, `DISCORD_WEBHOOK_URL`, `SLACK_BOT_TOKEN` più `SLACK_CHANNEL_ID`, oppure `EMAIL_SENDER` più `EMAIL_PASSWORD`. Facoltativamente aggiungi una chiave di ricerca per la qualità delle notizie: SerpAPI è quella consigliata, con Tavily, Bocha, Brave, MiniMax e un'istanza SearXNG auto-ospitata come alternative.
Poi vai nella scheda Actions, accetta l'avviso sull'attivazione dei workflow ed esegui "每日股票分析" una volta a mano per verificare che funzioni. Da lì in poi parte da solo alle 18:00 ora di Pechino nei giorni feriali, salta i giorni senza contrattazioni comprese le festività di azioni A, Hong Kong e Stati Uniti, e supporta esecuzioni forzate e checkpoint ripristinabili per i casi limite.
La strada locale, per chi preferisce tenersi il processo:
git clone https://github.com/ZhuLinsen/daily_stock_analysis.git && cd daily_stock_analysis
pip install -r requirements.txt
cp .env.example .env
python main.py
La CLI ha un insieme ragionevole di opzioni. `--debug` per l'output dettagliato, `--dry-run` per generare senza inviare, `--stocks` per sostituire la watchlist in una singola esecuzione, `--market-review` per il riepilogo a livello di mercato invece che per titolo, `--schedule` per uno scheduler locale di lunga durata e `--serve-only` per la parte web senza analisi. C'è un'immagine Docker su `zhulinsen/daily_stock_analysis` per la via di mezzo.
Perché le fonti gratuite contano più del modello
L'economia di questo progetto è la parte interessante.
I dati di mercato predefiniti arrivano da AkShare, Baostock e YFinance, tutti gratuiti. Il README è esplicito: le righe di log che segnalano una fonte non configurata non influiscono sull'esecuzione. Esistono alternative a pagamento, TickPlus per azioni A ed ETF, Tushare per la stabilità storica, Longbridge per campi di Hong Kong e Stati Uniti come il controvalore e il P/E, ma il sistema è pensato per produrre un dashboard utilizzabile senza spendere nulla.
Il calcolo sono minuti di GitHub Actions, che per un fork pubblico con un'esecuzione al giorno nei feriali è di fatto gratuito. La ricerca di notizie è l'unico punto in cui compare un costo, e anche lì i livelli gratuiti di diversi fornitori coprono una watchlist di una dozzina di ticker.
Quella combinazione (dati gratuiti, calcolo gratuito, consegna gratuita) spiega la salita delle stelle. L'analisi non è migliore di un terminale a pagamento. Il costo marginale di un'esecuzione è zero, quindi puoi lasciarlo acceso per sempre e vedere cosa succede.
Cosa produce davvero
Il dashboard è un blocco per titolo con la lettura dell'LLM su andamento del prezzo, sentiment delle notizie, comunicazioni e catalizzatori, più una revisione a livello di mercato. Il README è franco sulle regole di degrado: il sentiment social e alcune fonti di notizie ripiegano o spariscono quando le loro API limitano la frequenza, e il sistema registra il ripiego invece di fingere che i dati fossero completi.
Quell'onestà è più rara di quanto dovrebbe essere. La maggior parte dei dashboard IA presenta un riepilogo sicuro, che gli input siano arrivati o no. Questo tratta una fonte mancante come uno stato da segnalare.
Dove sbaglia
La copertura è ampia sulla carta e disomogenea in pratica, e la documentazione del repository è la guida migliore per capire dove.
La qualità dei dati dipende da quale fonte risponde. AkShare e Baostock sono mantenuti dalla comunità e ogni tanto restano indietro o cambiano schema; YFinance copre bene i titoli statunitensi e meno i mercati più sottili. I campi di Hong Kong e Stati Uniti come il tasso di rotazione, il rapporto di volume e il P/E richiedono credenziali Longbridge per essere completi, il che significa che un'installazione non configurata produrrà un dashboard con vuoti visibili su quei mercati.
Lo step dell'LLM eredita quello che ha trovato il livello delle notizie. Se mancano le chiavi di ricerca, la sezione sentiment degrada ad andamento del prezzo e comunicazioni, e un titolo molto discusso sui social si legge come silenzioso. Il README chiarisce che le fonti mancanti vengono segnalate invece di essere appianate in silenzio, il che è la scelta giusta, ma significa anche che due utenti dello stesso repository possono ottenere dashboard molto diversi per lo stesso ticker nello stesso giorno.
E l'analisi in sé è un modello linguistico che riassume informazioni pubbliche. Non esegue un modello di valutazione, non ha stime di consensus e non può dirti se un movimento di prezzo è stato una reazione eccessiva. Quello che può fare è comprimere quaranta titoli di notizie, tre comunicazioni e una settimana di prezzi in una pagina che leggerai davvero prima dell'apertura.
La parte che vale la pena copiare
Togli le azioni e resta un modello per un'intera categoria di prodotti oggi poco servita: agenti programmati, privati, con un solo scopo, che spingono un risultato invece di aspettare che qualcuno li interroghi.
I componenti sono banali da descrivere. Un cron. Qualche fonte gratuita con degrado elegante. Uno step LLM che trasforma dati strutturati in prosa che una persona leggerà davvero. Un canale di consegna che l'utente già controlla. Un file di configurazione senza server da mantenere.
Quasi tutti gli "assistenti IA" usciti quest'anno sono l'opposto: una finestra di chat che pretende che tu sappia cosa chiedere. La forma cron e push la rovescia. Presuppone che l'utente abbia di meglio da fare che interrogare un modello, e si guadagna il suo posto presentandosi a un'ora fissa con qualcosa di specifico.
L'avvertenza che va detta
È uno strumento di analisi di livello hobbistico, non un consiglio di investimento, e il repository lo dice. Un LLM che riassume notizie pubbliche su un titolo non è un analista di ricerca, e un dashboard che arriva ogni sera può creare un falso senso di rigore proprio perché è così regolare.
Usalo come un filtro che ti dice cosa è cambiato. Chi lo tratta come un oracolo che dice cosa fare lo sta usando male, e vale lo stesso per la maggior parte dei prodotti IA lanciati questo mese: il valore sta nella riduzione della lettura, mai nella conclusione.
Articoli correlati
Nvidia finanzia i suoi clienti, e lo chiama ecosistema
Nvidia ha messo oltre 99 miliardi nelle aziende che le comprano l'hardware. L'anello funziona finché qualcuno non chiede cosa succede al bordo.
Il 74% di margine ha una data di scadenza
Un punto di margine vale 3 miliardi l'anno. Nvidia ne sta perdendo tre, e la spiegazione dice più sulla sua strategia di quanto dica il beat sui ricavi.
175.000 firme non lo riportano indietro
Migliaia di dipendenti e due fondi chiedono il ritorno di Huang. Il consiglio ha un'indagine aperta e un calendario: ogni mese che passa toglie forza alla richiesta.
La regola sull'export controlla il cliente, non il chip
Cinque paesi, una licenza e una clausola che vale ovunque: la nuova regola americana sposta il controllo dal chip al cliente che lo usa.