# A-Share Data Access

Reads A-share stock, financial, and valuation data through local runtime interfaces.

- Repository: https://github.com/hsliuping/TradingAgents-CN (32756 stars)
- Category: Data and ML
- License: see repository
- Last updated: 2026-09-22
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add hsliuping/TradingAgents-CN --skill a-share-runtime-data-access -g -a claude-code -y`
Codex: `npx skills add hsliuping/TradingAgents-CN --skill a-share-runtime-data-access -g -a codex -y`
Cursor: `npx skills add hsliuping/TradingAgents-CN --skill a-share-runtime-data-access -g -a cursor -y`
Gemini CLI: `npx skills add hsliuping/TradingAgents-CN --skill a-share-runtime-data-access -g -a gemini-cli -y`

## Description

Use when the task requires reading A-share stock data, financial data, valuation context, or querying local stock collections through core.skill_runtime runtime interfaces.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# A-share Runtime Data Access

Use this skill when the user asks for A-share local data retrieval, quote lookup, financial period lookup, valuation context building, technical indicator lookup, or schema inspection through the project's public runtime interfaces and local tools.

## Scope

- Only handle A-share data in this workflow.
- Do not switch to multi-market logic unless the user explicitly changes scope.
- Prefer the project's public runtime interfaces over direct database access.

## First Read

Before fetching data, read these documents in order:

1. `docs/design/runtime-interfaces/skill-runtime-overview.md`
2. `docs/design/runtime-interfaces/local-data-access-design.md`
3. `docs/design/runtime-interfaces/project-access-and-governance.md`

If you need concrete function signatures or allowed collections, then read:

1. `core/skill_runtime/data_access.py`
2. `core/skill_runtime/project_access.py`
3. `core/skill_runtime/catalog.py`

## Runtime Rules

- Prefer `core.skill_runtime.data_access` for business-semantic data access.
- Use `core.skill_runtime.project_access` only when helper functions are insufficient or when inspecting schema / field coverage.
- Do not create `MongoClient` or import `pymongo` directly.
- Do not bypass `core.skill_runtime` by reading lower-level provider or database modules unless the user explicitly asks for code archaeology.
- For technical analysis, prefer the project's local technical tools and materialized snapshots over ad hoc indicator calculation.

## Preferred Helpers

For common A-share tasks, prefer these helpers first:

1. `get_stock_basic_info(symbol)`
2. `get_market_quotes(symbol)`
3. `get_latest_stock_price(symbol)`
4. `get_stock_daily_quotes(symbol, start_date, end_date)`
5. `get_stock_financial_periods(symbol)`
6. `get_stock_financial_data(symbol)`
7. `get_stock_valuation_context(symbol)`
8. `get_stock_news(symbol)`
9. `query_stock_collection(collection, ...)`
10. `inspect_stock_collection_schema(collection, ...)`

The rest: https://github.com/hsliuping/TradingAgents-CN/blob/HEAD/skills/a-share-runtime-data-access/SKILL.md