How noczero/idx-fundamental-analysis works
IDX Fundamental Analysis is a stock-data retrieval and analysis application. Its principal workflow is a CLI run: obtain listed stocks from IDX, enrich them with Stockbit statistics, prices and stream sentiment, generate spreadsheet or Excel output, and persist the results in SQLite. The repository also contains API and Svelte UI subsystems; their detailed request flow is not established by the sampled source. Google Sheets and Stockbit token refresh are separate integrations. Dashed, uncited links mark relationships not verified in the excerpts.
Main entry points: __init__.py Analysis coordinator · main.py Analysis runner · database_builder.py Database writer · stockbit_api_client.py Stockbit API client
Components 27
Retrieval and analysis
- Analysis runner
main.py - Analysis coordinator
builders/analysers/__init__.py - Fundamental analysis
builders/analysers/fundamental_analyser.py - Key analysis
builders/analysers/key_analysis_analyser.py - Price analysis
builders/analysers/stock_price_analyser.py - Sentiment analysis
builders/analysers/sentiment_analyser.py
Reporting and storage
- Google Sheets output
builders/spreadsheet.py - Excel output
builders/excel.py - Database writer
builders/database_builder.py - SQLite sessions
db/session.py - Data repositories
repositories
External integrations
- IDX stock retrieval
providers/idx.py - Stockbit enrichment
providers/stockbit.py - Stockbit API client
services/stockbit_api_client.py - Browser token capture
services/stockbit_token_fetcher.py - YFinance provider
providers/yfinance.py - IDX web crawler
providers/webcrawler.py - Google Drive service
services/google_drive_service.py - Google Sheets
- Stockbit service
API and UI
- HTTP API
app/api - API registration
core/registrar.py - Svelte interface
app/ui/src/routes/+page.svelte
Data model
- Stock data schemas
schemas/stock.py - Fundamental schema
schemas/fundamental.py - Fundamental records
db/models/fundamental.py
Other components
- CLI operator
Connections 23
- CLI operator → Analysis runner: starts run
main.py - Analysis runner → IDX stock retrieval: retrieves stocks
main.py - Analysis runner → Stockbit enrichment: enriches stocks
main.py - Analysis runner → Analysis coordinator: builds output
main.py - Analysis runner → Database writer: persists results
main.py - Stockbit enrichment → Stockbit API client: sends requests
providers/stockbit.py - Stockbit API client → Browser token capture: captures tokens
services/stockbit_api_client.py - Stockbit API client → Stockbit service: calls API
- Analysis coordinator → Fundamental analysis: uses analyser
builders/analysers/__init__.py - Analysis coordinator → Key analysis: uses analyser
builders/analysers/__init__.py - Analysis coordinator → Price analysis: uses analyser
builders/analysers/__init__.py - Analysis coordinator → Sentiment analysis: uses analyser
builders/analysers/__init__.py - Analysis coordinator → Google Sheets output: selects output
builders/analysers/__init__.py - Analysis coordinator → Excel output: selects output
builders/analysers/__init__.py - Google Sheets output → Google Drive service: writes sheets
builders/spreadsheet.py - Google Drive service → Google Sheets: updates spreadsheets
services/google_drive_service.py - Database writer → SQLite sessions: opens sessions
builders/database_builder.py - Database writer → Fundamental records: creates records
builders/database_builder.py - Database writer → Stock data schemas: reads stock data
builders/database_builder.py - Data repositories → SQLite sessions: uses database
- Stock data schemas → Fundamental schema: embeds schema
schemas/stock.py - API registration → HTTP API: registers routers
core/registrar.py - Svelte interface → HTTP API: requests data