Skip to main content
Glama

A股数据 API (A-Share Data API)

ashare_hot

关注度排名(谁在被关注,⛔ 不是'谁在涨')。用户问'什么股票热门/大家在看什么/热度榜/热门板块/热文'用这个。⚠️⚠️ 5 类字段结构完全不同,⛔ 别按同一套字段读:stock 热搜股票(code/name/zdf/zxj) · wx 全市场热度(多 pv 热度值) · news 热门文章(⚠️ news_id/news_title/source,⛔ 无 code) · sector 热门板块(⚠️ symbol,⛔ 无 code) · etf 热搜 ETF(含 title/tag)。⚠️ 当前快照(无历史)· 免费工具(无需 Key)

Input Schema

NameRequiredDescriptionDefault
typeNostock/wx/news/sector/etf(默认 stock)—— ⚠️ 5 类字段各不相同stock
limitNo条数(默认 30,上限 50)

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / type / description
      Previous value: -"榜单类型:stock/wx/news/sector/etf(默认 stock)"New value: +"stock/wx/news/sector/etf(默认 stock)—— ⚠️ 5 类字段各不相同"
  2. Changed1 schema field changed
    • addedInput schema / properties / type
      Added value: +{
      +  "default": "stock",
      +  "description": "榜单类型:stock/wx/news/sector/etf(默认 stock)",
      +  "title": "Type",
      +  "type": "string"
      +}
  3. Changed2 schema fields changed
    • changedInput schema / properties / limit / default
      Previous value: -30New value: +20
    • addedInput schema / properties / limit / description
      Added value: +"条数(默认 30,上限 50)"
  4. First observed

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full behavioral burden. It discloses two operationally relevant traits: the data is a current snapshot with no history (当前快照(无历史)) and the tool is free with no API key required. It does not mention rate limits or result-size caps, leaving some gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Dense but front-loaded: the core purpose and the negative case come first, then the per-type field caveats, then the snapshot/licensing notes. The warning emoji pile-up makes it visually noisy, but every clause conveys a distinct constraint rather than restating the name.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be described, and the description instead covers the things the schema cannot: the snapshot-only limitation, the no-key access, and the field heterogeneity across the five types. Complete enough to call correctly; only rate limits and a clearer `limit` bound reference are absent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline would be 3, but the description goes further by explaining what each `type` value actually returns (code/name/zdf/zxj for stock, multi-pv heat values for wx, news_id/news_title/source for news, symbol for sector, title/tag for etf) and warns that the five field structures are incompatible. That is genuine semantic value beyond the enum list in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource (关注度排名 / attention ranking) and immediately disambiguates it from the superficially similar 'who is rising' tools with ⛔ 不是'谁在涨'. It also enumerates the five mutually exclusive result classes (stock/wx/news/sector/etf), so an agent can tell this apart from ashare_limit_up or ashare_abnormal without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete user-intent triggers ('什么股票热门/大家在看什么/热度榜/热门板块/热文'), which is strong when-to-use guidance, plus the negative case of price movers. It stops short of naming a sibling tool as the alternative or stating exclusions beyond the 'not who is rising' line, so it is clear context without full routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources