fund-keeper

# Fund Keeper - Intelligent Fund Advisor A comprehensive tool for Chinese mutual fund management with real-time valuation, buy/sell suggestions, and portfolio tracking. ## Quick Start ### 1. Install Dependencies ```bash pip install akshare pandas requests ``` ### 2. Create Fund List Create your portfolio in `workspace/funds/my-funds.md`: ```markdown # My Fund Portfolio ## Holdings | Fund Code | Fund Name | Shares | Cost NAV | Notes | |---------|---------|---------|---------|------| | 000001 | HuaXia Growth | 10000 | 1.500 | SIP | | 110011 | YiFangDa SME | 5000 | 2.300 | Long-term | ``` ### 3. Commands ```bash # View portfolio P&L fund-keeper portfolio # Get buy/sell suggestions fund-keeper advice # View config fund-keeper config # Modify config fund-keeper config --set alert_threshold=2.0 # Reset config fund-keeper config --reset # Add fund from screenshot fund-keeper add-from-image screenshot.png # View market overview fund-keeper market # Set alert fund-keeper alert --fund 000001 --price 1.800 ``` ## Core Features ### 1. Real-time Valuation - Fetch real-time NAV estimates from public sources - Compare with historical NAV, calculate daily change - Support QDII funds (HK/US markets) ### 2. Buy/Sell Suggestions Based on comprehensive analysis: - **Valuation**: PE/PB historical percentile - **Technical**: Moving averages, MACD, RSI - **Market Sentiment**: Capital flow, news - **Cost Basis**: Compare with your holding cost Suggestion Levels: - **Strong Sell**: Overvalued + technical top divergence - **Consider Selling**: Overvalued or profit target reached - **Hold**: Normal range - **Consider Buying**: Undervalued or SIP opportunity - **Strong Buy**: Significantly undervalued + technical bottom divergence ### 3. OCR Fund Recognition Support screenshot recognition from: - Alipay fund holdings - Fund platform screenshots - Bank app fund pages Auto-extract: - Fund code - Fund name - Shares held - Amount ### 4. Smart Alerts - NAV reaches target price - Daily change exceeds threshold - Market volatility - SIP date reminders ## Fund Search ```bash py fund_keeper.py search --name gold # Search by name py fund_keeper.py search --fund 000218 # View fund details ``` ## Portfolio Management ```bash # Edit fund py fund_keeper.py edit --fund 000218 # Interactive edit py fund_keeper.py edit --fund 000218 --field amount --value 10000 # Remove fund py fund_keeper.py remove --fund 000218 ``` ### Editable Fields - `name` - Fund name - `amount` - Amount held - `profit` - Take profit % - `stop` - Stop loss % - `day` - SIP day - `note` - Notes ## Gold Investment Report ```bash py fund_keeper.py gold ``` Includes: - International gold price (AUTD) - Gold fund (000218) real-time NAV - Investment suggestions (buy/hold/sell) ## Profit Visualization ```bash py fund_keeper.py stats # Basic stats py fund_keeper.py stats --chart # With charts py fund_keeper.py trend # 7-day trend ``` ## Data Sources & Caching **Multi-source Support**: - TTJJ (default, fastest) - EastMoney - Sina Finance (backup) **Caching**: - Auto-cache results (30 min valid) - Offline mode: `--offline` ## Important Notes **Investment Risk** - This tool is for reference only, not investment advice - Market risks exist, invest carefully - Diversification recommended **Data Delay** - Mutual fund NAV updates once daily (evening) - Real-time estimates are approximations - QDII funds have T+2 delay ## Stock-Fund Linkage (v2.2) Link with stock-analysis skill: ```bash # Recommend funds by sector python stock_fund_linkage.py --sector semiconductor # Analyze fund holdings python stock_fund_linkage.py --fund 000218 ``` ## Scheduled Tasks ```bash # Daily 15:00 after market close openclaw cron add --name "fund-check" --cron "0 15 * * 1-5" \ --session isolated --message "Check fund valuation and generate report" # Weekly report on Monday 8:00 openclaw cron add --name "fund-weekly" --cron "0 8 * * 1" \ --session isolated --message "Generate weekly fund portfolio report" ``` ## Related Files - `funds/my-funds.md` - Portfolio list - `funds/config.json` - Configuration - `funds/history.md` - Transaction history - `memory/fund-learnings.md` - Investment insights --- *Long-term investing, rational decisions.* 🐔