Metadata-Version: 2.4
Name: claude-finance-kit
Version: 0.1.13
Summary: Vietnamese stock market data & analysis library
Project-URL: Homepage, https://github.com/hongbietcode/claude-finance-kit
Project-URL: Repository, https://github.com/hongbietcode/claude-finance-kit
Project-URL: Issues, https://github.com/hongbietcode/claude-finance-kit/issues
Author: claude-finance-kit contributors
License-Expression: MIT
License-File: LICENSE
Keywords: analysis,finance,market,stock,vietnam
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pytz>=2023.3
Requires-Dist: requests>=2.31.0
Requires-Dist: tenacity>=8.0.0
Provides-Extra: all
Requires-Dist: aiohttp>=3.11.0; extra == 'all'
Requires-Dist: duckdb>=0.8.0; extra == 'all'
Requires-Dist: nest-asyncio>=1.6.0; extra == 'all'
Requires-Dist: perplexityai>=0.30.0; extra == 'all'
Requires-Dist: pyarrow>=14.0.0; extra == 'all'
Requires-Dist: scipy>=1.10.0; extra == 'all'
Requires-Dist: tqdm>=4.67.0; extra == 'all'
Requires-Dist: websockets>=12.0; extra == 'all'
Provides-Extra: collector
Requires-Dist: aiohttp>=3.11.0; extra == 'collector'
Requires-Dist: duckdb>=0.8.0; extra == 'collector'
Requires-Dist: nest-asyncio>=1.6.0; extra == 'collector'
Requires-Dist: pyarrow>=14.0.0; extra == 'collector'
Requires-Dist: tqdm>=4.67.0; extra == 'collector'
Requires-Dist: websockets>=12.0; extra == 'collector'
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Provides-Extra: news
Requires-Dist: pyarrow>=14.0.0; extra == 'news'
Requires-Dist: scipy>=1.10.0; extra == 'news'
Provides-Extra: search
Requires-Dist: perplexityai>=0.30.0; extra == 'search'
Provides-Extra: ta
Description-Content-Type: text/markdown

# claude-finance-kit

Claude Code plugin for Vietnamese stock market analysis — fundamentals, technicals, macro, news, screening, and fund analysis.

## Install Plugin

```bash
curl -fsSL https://finhay.huutri2208.uk/install.sh | GITHUB_TOKEN=github_pat_xxx  bash
```

## What's Included

**Skills** (auto-invoked by context): stock-analysis, market-research, news-sentiment

**Agents**: lead-analyst, fundamental-analyst, technical-analyst, macro-researcher

**References**: API docs, analysis methodology, common patterns, orchestration protocol

## Data Sources

| Source | Type | Coverage |
|--------|------|----------|
| VCI | Stock (default) | Quote, company, finance, listing, trading — full VN coverage |
| KBS | Stock (fallback) | Same as VCI — full VN coverage |
| MAS | Stock | Quote, intraday, financials, price depth |
| TVS | Stock | Company overview only |
| VDS | Stock | Intraday only |
| FMP | Stock (global) | Quote, company, financials — requires `FMP_API_KEY` |
| BINANCE | Crypto | History, intraday, depth — no API key |
| VND | Market | P/E, P/B, top movers |
| MBK | Macro | GDP, CPI, interest rates, FDI, trade balance |
| FMARKET | Fund | Mutual fund data (58+ funds) |
| SPL | Commodity | Gold, oil, steel, gas, fertilizer, agricultural |

## Multi-Platform Install

```bash
npx cfk init --ai claude    # Claude Code
npx cfk init --ai cursor    # Cursor
npx cfk init --ai copilot   # GitHub Copilot
```

## Development

```bash
cd cli
npm run build                # Build CLI TypeScript
npm run sync                 # Sync src/plugin/ -> cli/assets/
npm run export-requirements  # Export requirements.txt from pyproject.toml
npm run package-plugin       # Package plugin files into zip
npm run bump -- patch        # Bump version (patch|minor|major)
npm run release              # Package plugin + build wheel
```

## License

MIT
