longbridge-constituent
List the constituent stocks of an index or ETF, ranked by a chosen indicator.
Response language: match the user's input language — Simplified Chinese / Traditional Chinese / English.
When to use
Trigger when the user wants the members of an index or ETF (not the index quote itself):
- "标普 500 有哪些股票", "S&P 500 constituents" →
SPX.US - "恒生指数成分股", "Hang Seng constituents" →
HSI.HK - "纳斯达克 100 涨幅榜", "IXIC components by gain" →
IXIC.US - "沪深 300 成分股", "CSI 300 members" →
000300.SH - "QQQ 持仓", "SPY holdings" → ETF symbol like
QQQ.US,SPY.US
For the index quote (level, change, volume), use longbridge-quote instead. For 2–5 explicit-symbol comparison, use longbridge-peer-comparison.
Symbol format
<CODE>.<MARKET>. Common indices:
| Index | Symbol |
|---|---|
| 恒生指数 / Hang Seng | HSI.HK |
| 国企指数 / HSCEI | HSCEI.HK |
| 标普 500 / S&P 500 | SPX.US |
| 道琼斯 / Dow Jones | DJI.US |
| 纳斯达克综合 / Nasdaq | IXIC.US |
| 纳指 100 / Nasdaq 100 | NDX.US |
| 沪深 300 / CSI 300 | 000300.SH |
| 上证指数 / SSE Composite | 000001.SH |
ETFs use their own ticker (e.g. SPY.US, QQQ.US, 2800.HK).
CLI
Run longbridge --help to see all available subcommands, then longbridge <subcommand> --help before calling.
longbridge <subcommand> HSI.HK --format json # run --help for available flags and subcommand names
Types of data needed:
- Constituent list for an index or ETF symbol
- Sort/filter options: by change, price, turnover, capital inflow, turnover rate, or market cap (run
--helpfor available sort flags) - Limit on number of members to return (run
--helpfor the flag name)
Workflow
- Resolve the user's index/ETF name to
<CODE>.<MARKET>(use the table above; if ambiguous between markets, ask). - Pick sort order from intent (run
--helpto confirm flag names):- "涨幅榜 / gainers" → sort by change, descending
- "跌幅榜 / losers" → sort by change, ascending
- "成交活跃 / most traded" → sort by turnover
- "主力净流入 / net inflow" → sort by inflow
- "权重股 / largest weight" → sort by market cap
- Pick result count: default 50 unless user specifies (e.g. "前 10" → limit 10).
- Run the CLI command with
--format json, render the rows in a table.
Output
JSON array, one row per constituent — fields typically include symbol, name, last, change_rate, volume, turnover, market_cap, plus the indicator used for sorting. Render as a 5–8 column table; preserve symbol verbatim.
Error handling
| Situation | LLM response |
|---|---|
Shell command not found: longbridge | Fall back to MCP if configured; otherwise tell the user to install longbridge-terminal. |
stderr param_error / "invalid symbol" | Confirm the index symbol — e.g. SPX.US not S&P500. |
| Empty array | "No constituents returned — confirm the symbol is an index or ETF, not a single stock." |
| Other stderr | Surface verbatim. |
MCP fallback
When the CLI is unavailable, fall back to the MCP server. Discover available tools from the MCP server's tool list at runtime.
If unsure of the exact MCP tool name, run the CLI; the binary is the canonical path.
Related skills
| User asks | Route to |
|---|---|
| Index level / change / volume | longbridge-quote |
| 2–5 explicit-symbol comparison | longbridge-peer-comparison |
| Single-stock fundamentals after picking from the list | longbridge-fundamental |
| Single-stock valuation snapshot | longbridge-valuation |
File layout
longbridge-constituent/
└── SKILL.md # prompt-only, no scripts/