Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
vnstock-free-expert 1.0.2 - Minor update to agent configuration (agents/openai.yaml) with no changes to skill logic or documentation. - No changes to usage, API, scripts, or user-facing behavior.
What This Skill Does
Runs a structured Vietnam stock analysis pipeline using the vnstock library, with built-in rate-limit controls for free-tier API usage. Covers universe building, market data collection, fundamental scoring, and analyst memo generation. Outputs a confidence-rated ranking with data coverage disclosures.
Handles rate-limit pacing, missing-data disclosure, and confidence scoring automatically, replacing ad-hoc vnstock scripts that commonly hit throttle errors or silently drop null metrics.
When to use it
- Rank VN30 stocks by value and momentum without exceeding free API limits
- Pull fundamentals for a specific Vietnamese ticker and build a valuation memo
- Run an end-to-end screening pipeline on a custom symbol list
- Check which vnstock methods are available in the installed version before running a script
- Generate a downstream data bundle for equity valuation or portfolio risk tools
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Rank VN30 stocks by value and quality using KBS data, free-tier safe
- 1Validate Python environment and load VNSTOCK_API_KEY from .env if present
- 2Run build_universe.py with source=kbs, mode=group, group=VN30
- 3Run collect_market_data.py and collect_fundamentals.py with 3.2s/request pacing
- 4Run score_stocks.py to produce composite ranking
- 5Run generate_report.py and apply confidence rubric, reporting coverage stats and top missing fields
Ranked CSV and markdown investment memo with confidence level, symbols scored vs requested, and key risk disclosures
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.