gangtise-mcp 0.1.21 → 0.1.22

package/README.md

@@ -4,6 +4,16 @@
 
 ## Changelog
 
+### 0.1.22 (2026-06-12)
+- 同步 CLI reference 常量/题材/板块 API（CLI v0.15.1 之后的 f2d2a00）：
+  - 新增 `gangtise_constant_category`：常量分类清单及各分类适用的接口参数（usageScopes）
+  - 新增 `gangtise_constant_list`：按分类查全部常量值（中信/申万/Gangtise 行业、国内城市、A股/港股公告分类、区域），树形分类含 `children` 嵌套；`constants` 响应自动归一化为 `list`
+  - 新增 `gangtise_concept_search`：按关键词（中文名/拼音/分组名）搜索题材 ID，供 `gangtise_concept_info` / `gangtise_concept_securities` / `gangtise_theme_tracking` 使用
+  - 新增 `gangtise_sector_search` / `gangtise_sector_constituents`：板块 ID 搜索与全量成分股名单
+  - `gangtise_lookup` 收窄为常量 API 未覆盖的 3 类本地表（券商机构 / 会议机构 / 申万行业代码），移除研究方向/行业/地区/公告类别/主题 ID 本地数据（约 -2700 行静态表，改由上述 API 实时提供）
+  - 日程类工具（路演/调研/策略会/论坛）新增 `locationList` 筛选（domesticCity 常量 ID）
+- 同步 CLI v0.15.1 错误码提示：补充 410110（异步生成中）/ 410111（生成失败终态）/ 410004（数据未找到）/ 430004（下载失败）/ 430007（行情超限）/ 433007（数据源不匹配）/ 10011401（白名单未开通）
+
 ### 0.1.21 (2026-06-10)
 - 全部 69 个工具声明 MCP `annotations: { readOnlyHint: true }`：本服务只做数据查询，支持该注解的客户端（如 VS Code Copilot）可跳过确认弹窗；并加集成测试防止后续新工具漏标
 - 补齐核心模块单测：`pollAsyncContent` 轮询（退避序列 / 410110 / 410111 / 超时）、`normalizeRows` 矩阵转换、异步工具对 submit→poll 流程，测试 85 → 98
@@ -112,7 +122,7 @@
 | 类别 | 工具 |
 |---|---|
 | 上下文 | `gangtise_current_date` — 查询运行时当前日期、年份、时间和时区 |
-| 参考数据 | `gangtise_lookup` — 研究方向、券商、行业、地区、公告类别、申万行业代码、主题 ID |
+| 参考数据 | `gangtise_constant_category` / `gangtise_constant_list` — 行业、城市、公告分类、区域等常量；`gangtise_concept_search` — 题材 ID 搜索；`gangtise_sector_search` / `gangtise_sector_constituents` — 板块及成分股；`gangtise_lookup` — 券商机构、会议机构、申万行业代码（本地表） |
 | 证券检索 | `gangtise_securities_search` |
 | 观点/研报 | 国内首席观点、纪要、券商研报、外资研报、外资独立观点、公告（A股/港股） |
 | 路演/调研 | 路演、调研、策略会、论坛 |

package/dist/core/client.js

@@ -100,14 +100,9 @@ export class GangtiseClient {
     }
     async readLocalLookup(endpoint) {
         const keyMapping = {
-            "lookup.research-areas.list": "research-areas",
             "lookup.broker-orgs.list": "broker-orgs",
             "lookup.meeting-orgs.list": "meeting-orgs",
-            "lookup.industries.list": "industries",
-            "lookup.regions.list": "regions",
-            "lookup.announcement-categories.list": "announcement-categories",
             "lookup.industry-codes.list": "industry-codes",
-            "lookup.theme-ids.list": "theme-ids",
         };
         const lookupKey = keyMapping[endpoint.key];
         if (lookupKey) {

package/dist/core/endpoints.js

@@ -8,13 +8,6 @@ export const ENDPOINTS = {
         description: "Get access token",
     },
     // ─── lookup (served from local data, not HTTP) ───
-    "lookup.research-areas.list": {
-        key: "lookup.research-areas.list",
-        method: "GET",
-        path: "/guide/research-area-local",
-        kind: "json",
-        description: "List research areas from local docs",
-    },
     "lookup.broker-orgs.list": {
         key: "lookup.broker-orgs.list",
         method: "GET",
@@ -29,27 +22,6 @@ export const ENDPOINTS = {
         kind: "json",
         description: "List meeting orgs from local docs",
     },
-    "lookup.industries.list": {
-        key: "lookup.industries.list",
-        method: "GET",
-        path: "/guide/industries-local",
-        kind: "json",
-        description: "List industries from local docs",
-    },
-    "lookup.regions.list": {
-        key: "lookup.regions.list",
-        method: "GET",
-        path: "/guide/regions-local",
-        kind: "json",
-        description: "List regions from local docs",
-    },
-    "lookup.announcement-categories.list": {
-        key: "lookup.announcement-categories.list",
-        method: "GET",
-        path: "/guide/announcement-categories-local",
-        kind: "json",
-        description: "List announcement categories from local docs",
-    },
     "lookup.industry-codes.list": {
         key: "lookup.industry-codes.list",
         method: "GET",
@@ -57,13 +29,6 @@ export const ENDPOINTS = {
         kind: "json",
         description: "List Shenwan industry codes from local docs",
     },
-    "lookup.theme-ids.list": {
-        key: "lookup.theme-ids.list",
-        method: "GET",
-        path: "/guide/theme-ids-local",
-        kind: "json",
-        description: "List theme IDs from local docs",
-    },
     // ─── insight ───
     "insight.opinion.list": {
         key: "insight.opinion.list",
@@ -211,6 +176,41 @@ export const ENDPOINTS = {
         kind: "json",
         description: "Search GTS codes (securities)",
     },
+    "reference.constant-category": {
+        key: "reference.constant-category",
+        method: "GET",
+        path: "/application/open-reference/constants/category",
+        kind: "json",
+        description: "List constant categories and their API usage scopes",
+    },
+    "reference.constant-list": {
+        key: "reference.constant-list",
+        method: "POST",
+        path: "/application/open-reference/constants/getList",
+        kind: "json",
+        description: "List all constant values of a category",
+    },
+    "reference.concept-search": {
+        key: "reference.concept-search",
+        method: "POST",
+        path: "/application/open-reference/concepts/search",
+        kind: "json",
+        description: "Search concept (theme) IDs by keyword",
+    },
+    "reference.sector-search": {
+        key: "reference.sector-search",
+        method: "POST",
+        path: "/application/open-reference/sectors/search",
+        kind: "json",
+        description: "Search sector IDs by keyword",
+    },
+    "reference.sector-constituents": {
+        key: "reference.sector-constituents",
+        method: "POST",
+        path: "/application/open-reference/sectors/constituents",
+        kind: "json",
+        description: "List constituent securities of a sector",
+    },
     // ─── quote ───
     "quote.day-kline": {
         key: "quote.day-kline",

package/dist/core/errors.js

@@ -29,6 +29,13 @@ const ERROR_HINTS = {
     "8000016": "开发账号状态异常。",
     "8000018": "开发账号已到期。",
     "903301": "今日调用次数已达上限。",
+    "410110": "异步内容生成中，稍后用对应 *_check 工具查询。",
+    "410111": "异步内容生成失败（终态），请更换参数后重新提交。",
+    "410004": "数据未找到，请检查查询条件。",
+    "430004": "下载失败（官方未文档化错误码），请确认 reportId 有效或更换 fileType 重试。",
+    "430007": "行情查询超出限制，请缩短日期范围。",
+    "433007": "数据源不匹配，请检查 resourceType 与 sourceId 组合。",
+    "10011401": "白名单未开通，请联系管理员。",
 };
 export class ApiError extends CliError {
     code;

package/dist/core/lookupData/index.js

@@ -1,13 +1,8 @@
 const cache = new Map();
 const loaders = {
-    "research-areas": () => import("./research-areas.js"),
     "broker-orgs": () => import("./broker-orgs.js"),
     "meeting-orgs": () => import("./meeting-orgs.js"),
-    "industries": () => import("./industries.js"),
-    "regions": () => import("./regions.js"),
-    "announcement-categories": () => import("./announcement-categories.js"),
     "industry-codes": () => import("./industry-codes.js"),
-    "theme-ids": () => import("./theme-ids.js"),
 };
 export async function getLookupData(key) {
     if (cache.has(key))

package/dist/core/normalize.js

@@ -29,5 +29,10 @@ export function normalizeRows(value) {
         const hasMeta = Object.keys(meta).length > 0;
         return hasMeta ? { ...meta, list: chatRoomList } : chatRoomList;
     }
+    if (Array.isArray(record.constants)) {
+        const { constants, ...meta } = record;
+        const hasMeta = Object.keys(meta).length > 0;
+        return hasMeta ? { ...meta, list: constants } : constants;
+    }
     return value;
 }

package/dist/tools/ai.js

@@ -145,7 +145,7 @@ export function registerAiTools(server, client, opts) {
     server.registerTool("gangtise_theme_tracking", {
         description: "获取指定主题的每日跟踪报告（早报或晚报版），需传入主题 ID 和日期。",
         inputSchema: {
-            themeId: z.string().describe("主题 ID，来自 gangtise_lookup type=theme-ids（必填）"),
+            themeId: z.string().describe("主题 ID，来自 gangtise_concept_search（必填）"),
             date: z.string().describe("YYYY-MM-DD，仅支持最近 30 天（必填）"),
             type: z.union([z.string(), z.array(z.string())]).optional().describe("morning=早报 | night=晚报；可传单个值或数组"),
         },

package/dist/tools/alternative.js

@@ -16,20 +16,20 @@ const specs = [
     },
     {
         name: "gangtise_concept_info",
-        description: "查询题材指数（概念/主题）基本信息：返回题材整体画像（定义 / 投资逻辑 / 行业空间 / 竞争格局 / 催化事件）。仅返回最新截面数据，不支持历史回溯。conceptId 与主题跟踪 gangtise_theme_tracking 的 themeId 为同一套 ID 体系，可用 gangtise_lookup(type=theme-ids) 按名称查询（如 机器人 → 121000130）。",
+        description: "查询题材指数（概念/主题）基本信息：返回题材整体画像（定义 / 投资逻辑 / 行业空间 / 竞争格局 / 催化事件）。仅返回最新截面数据，不支持历史回溯。conceptId 与主题跟踪 gangtise_theme_tracking 的 themeId 为同一套 ID 体系，可用 gangtise_concept_search 按名称查询（如 机器人 → 121000130）。",
         endpointKey: "alternative.concept-info",
         paginated: false,
         inputSchema: {
-            conceptId: z.string().describe("题材指数 ID，如 '121000130'（机器人）。来自 gangtise_lookup(type=theme-ids)（必填）"),
+            conceptId: z.string().describe("题材指数 ID，如 '121000130'（机器人）。来自 gangtise_concept_search（必填）"),
         },
     },
     {
         name: "gangtise_concept_securities",
-        description: "查询题材指数（概念/主题）成分股（题材深度 F8）：按分组结构返回当前成分股，每只含是否重点个股 isKey 与纳入理由 inclusionReason。conceptId 与主题跟踪 gangtise_theme_tracking 的 themeId 为同一套 ID 体系，可用 gangtise_lookup(type=theme-ids) 按名称查询（如 机器人 → 121000130）。",
+        description: "查询题材指数（概念/主题）成分股（题材深度 F8）：按分组结构返回当前成分股，每只含是否重点个股 isKey 与纳入理由 inclusionReason。conceptId 与主题跟踪 gangtise_theme_tracking 的 themeId 为同一套 ID 体系，可用 gangtise_concept_search 按名称查询（如 机器人 → 121000130）。",
         endpointKey: "alternative.concept-securities",
         paginated: false,
         inputSchema: {
-            conceptId: z.string().describe("题材指数 ID，如 '121000130'（机器人）。来自 gangtise_lookup(type=theme-ids)（必填）"),
+            conceptId: z.string().describe("题材指数 ID，如 '121000130'（机器人）。来自 gangtise_concept_search（必填）"),
         },
     },
 ];

package/dist/tools/insight.js

@@ -17,11 +17,12 @@ const scheduleListSchema = {
     brokerTypeList: z.array(z.string()).optional(),
     objectList: z.array(z.string()).optional().describe("company=公司 | industry=行业"),
     permission: z.array(z.number().int()).optional(),
+    locationList: z.array(z.string()).optional().describe("地点 ID（domesticCity 常量），来自 gangtise_constant_list category=domesticCity"),
 };
 function scheduleSpec(name, label, endpointKey) {
     return {
         name,
-        description: `查询${label}日程列表，支持按研究方向、机构、证券、类别、市场、参会角色等筛选。`,
+        description: `查询${label}日程列表，支持按研究方向、机构、证券、类别、市场、参会角色、地点等筛选。`,
         endpointKey,
         paginated: true,
         inputSchema: scheduleListSchema,
@@ -39,7 +40,7 @@ const listSpecs = [
             endTime: z.string().optional().describe(dateTimeDesc()),
             keyword: z.string().optional(),
             rankType: z.number().int().optional().describe("1=综合排序（默认）| 2=时间倒序"),
-            researchAreaList: z.array(z.string()).optional().describe("研究方向 ID，来自 gangtise_lookup type=research-areas"),
+            researchAreaList: z.array(z.string()).optional().describe("研究方向 ID，来自 gangtise_constant_list（citicIndustry / gangtiseIndustry 分类）"),
             chiefList: z.array(z.string()).optional().describe("首席分析师 ID 列表"),
             securityList: z.array(z.string()).optional().describe("证券代码列表，如 ['600519.SH']"),
             brokerList: z.array(z.string()).optional().describe("券商机构 ID，来自 gangtise_lookup type=broker-orgs"),
@@ -111,7 +112,7 @@ const listSpecs = [
             searchType: z.number().int().optional().describe("1=标题搜索 | 2=全文搜索"),
             rankType: z.number().int().optional().describe("1=综合排序 | 2=时间倒序"),
             securityList: z.array(z.string()).optional(),
-            regionList: z.array(z.string()).optional().describe("地区 ID，来自 gangtise_lookup type=regions"),
+            regionList: z.array(z.string()).optional().describe("地区 ID，来自 gangtise_constant_list category=regionCategory"),
             categoryList: z.array(z.string()).optional(),
             industryList: z.array(z.string()).optional(),
             brokerList: z.array(z.string()).optional(),
@@ -136,7 +137,7 @@ const listSpecs = [
             rankType: z.number().int().optional().describe("1=综合排序 | 2=时间倒序"),
             securityList: z.array(z.string()).optional(),
             announcementTypeList: z.array(z.string()).optional(),
-            categoryList: z.array(z.string()).optional().describe("公告类别 ID，来自 gangtise_lookup type=announcement-categories"),
+            categoryList: z.array(z.string()).optional().describe("公告类别 ID，来自 gangtise_constant_list category=aShareAnnouncementCategory"),
         },
     },
     {
@@ -152,7 +153,7 @@ const listSpecs = [
             searchType: z.number().int().optional().describe("1=标题搜索 | 2=全文搜索"),
             rankType: z.number().int().optional().describe("1=综合排序 | 2=时间倒序"),
             securityList: z.array(z.string()).optional(),
-            categoryList: z.array(z.string()).optional(),
+            categoryList: z.array(z.string()).optional().describe("公告类别 ID，来自 gangtise_constant_list category=hkShareAnnouncementCategory"),
         },
     },
     {
@@ -166,7 +167,7 @@ const listSpecs = [
             endTime: z.string().optional().describe(dateTimeDesc()),
             keyword: z.string().optional(),
             rankType: z.number().int().optional().describe("1=综合排序 | 2=时间倒序"),
-            regionList: z.array(z.string()).optional().describe("地区 ID，来自 gangtise_lookup type=regions"),
+            regionList: z.array(z.string()).optional().describe("地区 ID，来自 gangtise_constant_list category=regionCategory"),
             industryList: z.array(z.string()).optional(),
             securityList: z.array(z.string()).optional(),
             brokerList: z.array(z.string()).optional(),

package/dist/tools/lookup.js

@@ -2,20 +2,15 @@ import { z } from "zod";
 import { getLookupData } from "../core/lookupData/index.js";
 import { errorMessage } from "../core/errors.js";
 const LOOKUP_TYPES = [
-    "research-areas",
     "broker-orgs",
     "meeting-orgs",
-    "industries",
-    "regions",
-    "announcement-categories",
     "industry-codes",
-    "theme-ids",
 ];
 export function registerLookupTools(server, _client) {
     server.registerTool("gangtise_lookup", {
-        description: "查询本地静态参考数据：研究方向、券商机构、会议机构、行业、地区、公告类别、申万行业代码、主题 ID。无需调用 API，直接返回本地数据。",
+        description: "查询本地静态参考数据（常量 API 未覆盖的 ID）：券商机构、会议机构、申万行业代码。无需调用 API，直接返回本地数据。行业/地区/公告类别 ID 用 gangtise_constant_list，主题 ID 用 gangtise_concept_search。",
         inputSchema: {
-            type: z.enum(LOOKUP_TYPES).describe("research-areas=研究方向 | broker-orgs=券商机构 | meeting-orgs=会议机构 | industries=行业 | regions=地区 | announcement-categories=公告类别 | industry-codes=申万行业代码 | theme-ids=主题ID"),
+            type: z.enum(LOOKUP_TYPES).describe("broker-orgs=券商机构 | meeting-orgs=会议机构 | industry-codes=申万行业代码"),
         },
         annotations: { readOnlyHint: true },
     }, async ({ type }) => {

package/dist/tools/reference.js

@@ -1,7 +1,51 @@
 import { z } from "zod";
 import { normalizeRows } from "../core/normalize.js";
-import { buildToolContent } from "./registry.js";
+import { buildToolContent, registerJsonTool } from "./registry.js";
 import { toolHandler, contentResult } from "./helpers.js";
+const referenceSpecs = [
+    {
+        name: "gangtise_constant_category",
+        description: "查询常量分类列表：返回所有常量分类及每个分类适用于哪些接口的哪些参数（usageScopes）。当前分类：citicIndustry=中信一级行业 | swIndustry=申万一级行业 | gangtiseIndustry=Gangtise行业 | domesticCity=国内城市 | aShareAnnouncementCategory=A股公告分类 | hkShareAnnouncementCategory=港股公告分类 | regionCategory=区域分类。",
+        endpointKey: "reference.constant-category",
+        inputSchema: {},
+    },
+    {
+        name: "gangtise_constant_list",
+        description: "查询某个常量分类下的全部常量值（constantId / constantName / level），树形分类（公告分类）的父节点含 children 嵌套。行业、城市、公告类别、区域等筛选参数的 ID 都从这里查。",
+        endpointKey: "reference.constant-list",
+        inputSchema: {
+            category: z
+                .string()
+                .describe("分类代码（必填）：citicIndustry | swIndustry | gangtiseIndustry | domesticCity | aShareAnnouncementCategory | hkShareAnnouncementCategory | regionCategory，完整清单见 gangtise_constant_category"),
+        },
+    },
+    {
+        name: "gangtise_concept_search",
+        description: "按关键词搜索题材（概念/主题）ID，支持中文名、简称、拼音首字母（如 jqr）、分组名。返回 conceptId / conceptName / matchScore。该 ID 供 gangtise_concept_info / gangtise_concept_securities 的 conceptId 和 gangtise_theme_tracking 的 themeId 使用（同一套 ID）。",
+        endpointKey: "reference.concept-search",
+        inputSchema: {
+            keyword: z.string().describe("搜索词：题材中文名/简称、拼音首字母（如 jqr）、分组名（如 灵巧手）"),
+            top: z.number().int().min(1).max(10).optional().describe("最大返回条数（默认 10，上限 10）"),
+        },
+    },
+    {
+        name: "gangtise_sector_search",
+        description: "按关键词搜索板块 ID（行业/概念/指数成份等分类树节点），返回 sectorId / sectorName / hierarchy（层级路径）/ matchScore。同名板块可能出现在多个层级，用 hierarchy 区分。sectorId 供 gangtise_sector_constituents 使用，与题材 conceptId 是两套 ID，不通用。",
+        endpointKey: "reference.sector-search",
+        inputSchema: {
+            keyword: z.string().optional().describe("搜索词：板块中文名/简称、拼音首字母"),
+            top: z.number().int().min(1).max(10).optional().describe("最大返回条数（默认 10，上限 10）"),
+        },
+    },
+    {
+        name: "gangtise_sector_constituents",
+        description: "查询板块的全量成分股名单（gtsCode / gtsName）。sectorId 必须来自 gangtise_sector_search；返回 0 条通常是误用了题材 conceptId。题材成分股（含分组/重点标记）用 gangtise_concept_securities。",
+        endpointKey: "reference.sector-constituents",
+        inputSchema: {
+            sectorId: z.string().describe("板块 ID，来自 gangtise_sector_search（必填）"),
+        },
+    },
+];
 export function registerReferenceTools(server, client) {
     server.registerTool("gangtise_securities_search", {
         description: "按关键词搜索证券，支持股票名称、代码（如 600519）、拼音或英文名。返回匹配证券及其 GTS 代码。",
@@ -15,4 +59,7 @@ export function registerReferenceTools(server, client) {
         const result = await client.call("reference.securities-search", args);
         return contentResult(await buildToolContent(normalizeRows(result)));
     }));
+    for (const spec of referenceSpecs) {
+        registerJsonTool(server, client, spec);
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gangtise-mcp",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "MCP server for Gangtise OpenAPI",
   "license": "MIT",
   "author": "gangtiser",