CN Security Code Resolver

Overview

Resolve Chinese security names into exchange-tradable codes with a deterministic first pass and a verifiable fallback. Use the bundled script to query Eastmoney's public suggest API, then return the best match with enough metadata for confirmation.

When to use

Use this skill when the task involves any of the following:

• Find the code for a Chinese stock, ETF, LOF, REIT, or fund from its Chinese name
• Convert a portfolio/watchlist from names into tradable codes
• Confirm whether an instrument is A-share, ETF/fund, or another mainland market type
• Add exchange-aware identifiers such as 600938.SH, 510880.SH, or Eastmoney QuoteID

Do not use this skill for:

• Real-time pricing or chart analysis
• Hong Kong, US, futures, or crypto symbols unless the user explicitly wants cross-market results
• Fundamental analysis beyond basic instrument identification

Workflow

1) Prefer the script first

Run the bundled resolver script:

python3 skills/cn-security-code-resolver/scripts/resolve_cn_security.py "中国海油"

Batch mode:

python3 skills/cn-security-code-resolver/scripts/resolve_cn_security.py "红利ETF华泰柏瑞" "苏美达" "中国海油" "海油发展" "中海油服"

2) Read the best match carefully

Prefer rows where:

• Name exactly matches the queried Chinese name
• SecurityTypeName matches user intent (沪A, 深A, 基金, etc.)
• MarketType / QuoteID indicate mainland trading venue

For mainland cash equities and ETFs, map exchange suffixes as:

• codes starting with 6, 5, or 9 → usually SH
• codes starting with 0, 1, 2, or 3 → usually SZ

If the returned result is ambiguous, show the top 3 candidates and ask for confirmation instead of guessing.

3) Return a concise confirmation

Use this output shape when replying:

标的：中海油服
A股代码：601808
交易所：上交所
类型：沪A
标准代码：601808.SH
QuoteID：1.601808

4) When updating files

When writing portfolio JSON or other structured files, prefer storing both:

• code: raw numeric code, e.g. 601808
• exchangeSuffix: SH or SZ when it can be derived confidently

Optional enriched fields:

• quoteId
• securityTypeName
• marketType
• source: "eastmoney_suggest"

Verification guidance

If the first result looks suspicious:

• Re-run with the exact full Chinese name from the broker/app
• Inspect the top candidate list from the script
• Cross-check with a browser search only when necessary

Good verification signals:

• Exact Chinese name match
• Expected category (for example ETF vs stock)
• Price range and portfolio context are consistent with the instrument type

Bundled resources

Script

• scripts/resolve_cn_security.py
  • Queries Eastmoney suggest API
  • Supports one or many names
  • Returns ranked JSON results with exchange hints

Reference

• references/eastmoney-api.md
  • Documents the API endpoint, returned fields, and matching heuristics

Examples

python3 skills/cn-security-code-resolver/scripts/resolve_cn_security.py "苏美达"

Expected top result:

• 600710 / 苏美达 / 沪A

python3 skills/cn-security-code-resolver/scripts/resolve_cn_security.py "红利ETF华泰柏瑞"

Expected top result:

• 510880 / 红利ETF华泰柏瑞 / 基金

python3 skills/cn-security-code-resolver/scripts/resolve_cn_security.py "中海油服"

Expected top result:

• 601808 / 中海油服 / 沪A
• If other markets also appear elsewhere, prefer A-share unless the user asks otherwise