What makes Vnstock Free Expert notable?

1.8K downloads. Trust evidence available

How should Vnstock Free Expert be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Vnstock Free Expert

Runs an end-to-end vnstock workflow for free-tier-safe Vietnam stock valuation, ranking, and API operations with strict rate-limit control; used when users r... Skill: Vnstock Free Expert Owner: teahann Summary: Runs an end-to-end vnstock workflow for free-tier-safe Vietnam stock valuation, ranking, and API operations with strict rate-limit control; used when users r... Tags: latest:1.0.3 Version history: v1.0.3 | 2026-05-22T00:22:16.119Z | user Update Vietnam institutional stock skill system with D1 governance, trade decision policy, and harness agent guide. v1.0.2 | 2026-0

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.8k

Updated

Oct 10, 2026

Version

1.0.3

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.8K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.8K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.3release · observed May 22, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s172d4r9d0h6bvvd3mpq517yrn861np5:vnstock-free-expert

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-teahann-vnstock-free-expert/snapshot"

Documentation

CLAWHUB

147,100 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: vnstock-free-expert
description: Runs an end-to-end vnstock workflow for free-tier-safe Vietnam stock valuation, ranking, and API operations with strict rate-limit control; used when users request Vietnamese stock analysis under free-tier constraints.
compatibility: Requires Python 3.x, vnstock package, pandas, internet access, and optional VNSTOCK_API_KEY in .env.
---

# VNStock Free Expert

Use this skill when the user needs advanced Vietnam stock analysis with `vnstock`, while staying safe on free-tier limits.

## Important packaging note
This skill is self-contained and does not require shipping a separate `vnstock/` docs folder.
All operational knowledge needed by the agent is stored under:
- `references/`

## Read order
1. Read `references/capabilities.md`.
2. Read `references/method_matrix.md` for exact class/method mapping.
3. Read `references/free_tier_playbook.md` before large runs.

## Scope and constraints
- Library: `vnstock` only.
- Preferred sources: `kbs` first, `vci` fallback.
- Never use `tcbs`.
- Treat `Screener API` as unavailable unless user confirms it is restored in their installed version.

## Free-tier operating rules
- No API key: target <= 20 requests/minute.
- Free API key: target <= 60 requests/minute.
- Safe default pacing in scripts: 3.2s/request.
- Reuse cached artifacts between steps.

## Shared confidence rubric (required)
Report confidence as `High` / `Medium` / `Low` using this standard:
- `High`: universe coverage >= 95%, critical metrics coverage >= 80%, and hard errors <= 5% of symbols.
- `Medium`: universe coverage >= 80%, critical metrics coverage >= 60%, and hard errors <= 15%.
- `Low`: below `Medium` thresholds or material missing fields that can flip ranking results.

Always output:
1. Confidence level.
2. Coverage stats (`symbols_requested`, `symbols_scored`, `% missing by key metric`).
3. Top missing fields that may change conclusions.

## API key configuration (implemented)
- Skill-local key file: `.env`
- Variable: `VNSTOCK_API_KEY`
- All API-calling scripts auto-load this key and call vnstock auth setup before requests.
- You can override per run with `--api-key "..."`.

## Execution workflow (ordered)
1. Validate environment (`python`, `vnstock`, `pandas`) and load optional API key from `.env`.
2. Build a universe using `scripts/build_universe.py` (`group`, `exchange`, or `symbols` mode).
3. Collect market data with `scripts/collect_market_data.py` using safe pacing.
4. Collect fundamentals with `scripts/collect_fundamentals.py`.
5. Score and rank using `scripts/score_stocks.py`.
6. Generate analyst-style memo with `scripts/generate_report.py`.
7. Apply confidence rubric, disclose missing fields, and summarize risks.

## Downstream handoff bundle (required when doing single-ticker deep dive)
When the user request is about valuing or building a memo for a **specific ticker** (or a small list), output a compact JSON bundle that downstream skills can reuse:
- `ticker`, `as_of_date`, `curren

references/vnstock/README.md

# VNStock 3.4.0 - Tài Liệu Hướng Dẫn

## 🎯 Giới Thiệu

**VNStock** là thư viện Python để lấy dữ liệu chứng khoán Việt Nam từ nhiều nguồn uy tín. Thiết kế với kiến trúc provider-based, cho phép chuyển đổi linh hoạt giữa các nguồn dữ liệu khác nhau.

### ✨ Tính Năng Chính

- ✅ **Nhiều nguồn dữ liệu**: VCI, KBS, MSN (API công khai); FMP, DNSE (API chính thức)
- ⚠️ **TCBS**: Ngưng cập nhật thêm từ v3.4.0, sẽ loại bỏ trong v3.5.0 (tháng 3/2026)
- ✅ **API thống nhất**: Cùng interface cho tất cả nguồn
- ✅ **Dữ liệu lịch sử & Real-time**: Giá, công ty, tài chính
- ✅ **Dữ liệu công ty**: Hồ sơ, cổ đông, nhân viên quản lý
- ✅ **Dữ liệu tài chính**: Báo cáo, chỉ số, lưu chuyển tiền tệ
- ✅ **Lọc & Phân loại**: Theo ngành, sàn giao dịch, chỉ số

## 📚 Hướng Dẫn Sử Dụng

| Tài Liệu | Nội Dung | Mức Độ |
|---------|---------|--------|
| **[01-Overview](01-overview.md)** | Tổng quan kiến trúc, các loại dữ liệu | Cơ bản |
| **[02-Installation](02-installation.md)** | Cài đặt, thiết lập, kiểm tra | Cơ bản |
| **[03-Listing API](03-listing-api.md)** | API tìm kiếm và lọc chứng khoán | Cơ bản |
| **[04-Company API](04-company-api.md)** | Thông tin công ty, cổ đông, nhân viên quản lý | Cơ bản |
| **[05-Trading API](05-trading-api.md)** | Dữ liệu giao dịch, bid/ask, thống kê | Cơ bản |
| **[06-Quote & Price](06-quote-price-api.md)** | API lấy giá lịch sử và real-time | Cơ bản |
| **[07-Financial API](07-financial-api.md)** | API dữ liệu tài chính và báo cáo | Trung cấp |
| **[08-Fund API](08-fund-api.md)** | Dữ liệu quỹ đầu tư mở (Fmarket) | Trung cấp |
| **[09-Screener API](09-screener-api.md)** | Công cụ lọc chứng khoán nâng cao | Nâng cao |
| **[10-Connector Guide](10-connector-guide.md)** | Hướng dẫn API bên ngoài (FMP, XNO, DNSE) | Nâng cao |
| **[11-Best Practices](11-best-practices.md)** | Mẹo tối ưu hóa, xử lý lỗi, security | Nâng cao |

## 🚀 Bắt Đầu Nhanh

### Cài Đặt

```bash
pip install vnstock
```

Xem chi tiết tại **[02-Installation](02-installation.md)**

## 📖 Cấu Trúc Tài Liệu

Tài liệu được chia thành 11 phần theo thứ tự từ cơ bản đến nâng cao:

1. **[01-Overview](01-overview.md)** - Hiểu kiến trúc và các loại dữ liệu
2. **[02-Installation](02-installation.md)** - Cài đặt và kiểm tra môi trường
3. **[03-Listing API](03-listing-api.md)** - Tìm kiếm danh sách chứng khoán
4. **[04-Company API](04-company-api.md)** - Lấy thông tin công ty chi tiết
5. **[05-Trading API](05-trading-api.md)** - Dữ liệu giao dịch thị trường
6. **[06-Quote & Price](06-quote-price-api.md)** - Lấy dữ liệu giá
7. **[07-Financial API](07-financial-api.md)** - Truy cập dữ liệu tài chính
8. **[08-Fund API](08-fund-api.md)** - Thông tin quỹ đầu tư mở
9. **[09-Screener API](09-screener-api.md)** - Lọc chứng khoán nâng cao
10. **[10-Connector Guide](10-connector-guide.md)** - Sử dụng API bên ngoài
11. **[11-Best Practices](11-best-practices.md)** - Tối ưu hóa và xử lý lỗi

## Kiến Trúc Hệ Thống

VNStock sử dụng kiến trúc provider-based cho phép chuyển đổi linh hoạt giữa các nguồn dữ

_meta.json

{
  "ownerId": "kn7aqz9b9xv2mmyvsg54n5kecn81kkaf",
  "slug": "vnstock-free-expert",
  "version": "1.0.3",
  "publishedAt": 1779409336119
}

references/capabilities.md

# VNStock Capability Reference (Self-Contained)

## Core capabilities
- Symbol universe and classification: exchanges, industries, index groups, derivatives/bonds/warrants listings.
- Company intelligence: overview, shareholders, officers, subsidiaries, affiliates, events, reports (source-dependent).
- Market data: historical OHLCV, intraday prints, board snapshots, market depth (source-dependent).
- Financial statements and ratios: income statement, balance sheet, cash flow, ratio with period modes.
- Fund data: investment fund listings and related metadata.
- External connectors: available depending on environment and API keys.

## Source strategy
- Primary source: `kbs`.
- Secondary fallback: `vci`.
- Do not use `tcbs`.

## Data caveats
- Method availability differs by source.
- Some methods may return empty frames for specific symbols/time windows.
- Realtime/near-realtime outputs depend on market hours and provider freshness.

## Safe analysis pattern
1. Fetch raw data.
2. Validate shape/columns.
3. Handle empty/missing values.
4. Compute derived metrics.
5. Separate factual output from interpretation.

references/free_tier_playbook.md

# Free-Tier Playbook

## Rate limit profile
- Guest/no key: 20 requests/minute.
- Free key: up to 60 requests/minute.

## Execution controls
- Default minimum interval: 3.2 seconds/request.
- For unstable network/provider: increase to 4-5 seconds/request.
- Process symbols in chunks (e.g. 20-50 symbols/batch).

## Resilience checklist
- Retry transient failures with backoff.
- Log per-symbol failures; do not fail the whole run if a single symbol fails.
- Save intermediate artifacts (`universe`, `market_data`, `fundamentals`) for resume.

## Data quality checklist
- Confirm expected columns exist before calculation.
- Track missing metrics ratio.
- Flag stale data windows and low-bar histories.

## Portfolio-analysis checklist
- Use relative ranking, not absolute threshold only.
- Validate top picks against recent macro/news context.
- Apply sector diversification and risk caps.

Github ReposUpdated 12h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.