gangtise-openapi-cli 0.12.0 → 0.13.0

package/README.md

@@ -4,6 +4,20 @@
 
 ## Changelog
 
+### v0.13.0 — 2026-05-15
+
+**新增接口**
+- `fundamental income-statement-hk / balance-sheet-hk / cash-flow-hk` — 港股三大报表（中国会计准则）
+- `alternative edb-search` — 行业指标列表搜索（按关键词匹配指标名称，返回 indicatorId 等元信息）
+- `alternative edb-data` — 行业指标时序数据（批量按 indicatorId 拉取时间序列，最多 10 个指标）
+- `vault stock-pool-list` — 查询用户自选股股票池列表（poolId / poolName）
+- `vault stock-pool-stocks` — 查询股票池证券明细（支持 `--pool-id all` 全量查询）
+
+**接口变更**
+- `fundamental income-statement / balance-sheet / cash-flow / income-statement-quarterly / cash-flow-quarterly` 名称调整为 A股报表（路径不变）
+- `ai management-discuss-announcement` `--dimension` 新增 `all` 选项，返回报告中完整的管理层讨论内容（内容可能较长）
+- `vault wechat-message-list` 新增 `--security <code>` 参数（按证券代码过滤），返回结果增加 `securityList` 字段
+
 ### v0.12.0 — 2026-05-10
 
 **性能 / 架构**
@@ -111,10 +125,19 @@ Skill 目录结构：
 
 ```
 gangtise-openapi/
-├── SKILL.md                    # 主 skill 文件（命令参考、参数枚举、使用规则）
+├── SKILL.md                          # 主 skill 文件（必备规则、速查表、按需引用 references）
 └── references/
-    ├── fields.md               # 字段中英文对照速查表
-    └── lookup-ids.md           # 常用 ID 速查表（行业/券商/机构/公告分类等）
+    ├── commands/                     # 按命令组拆分的详细参数文档（agent 按需 Read）
+    │   ├── ai.md                     #   AI 能力命令（one-pager / earnings-review / viewpoint-debate 等）
+    │   ├── fundamental.md            #   财务数据命令（三大报表 / 估值 / 盈利预测 / 股东）
+    │   ├── insight.md                #   投研内容命令（研报 / 观点 / 纪要 / 公告 / 外资）
+    │   ├── quote.md                  #   行情命令（A股/港股/指数 K 线）
+    │   ├── reference-and-lookup.md   #   GTS Code 搜索与枚举速查
+    │   └── vault.md                  #   云盘/录音/会议/群消息
+    ├── examples.md                   # 典型场景的端到端示例
+    ├── fields.md                     # K线/财务字段中英文对照速查表
+    ├── lookup-ids.md                 # 常用 ID 速查表（行业/券商/机构/公告分类等）
+    └── response-schema.md            # 各接口响应字段说明
 ```
 
 安装：

package/dist/src/cli.js

@@ -303,6 +303,9 @@ addFinancialReport("income-statement-quarterly", "fundamental.income-statement-q
 addFinancialReport("balance-sheet", "fundamental.balance-sheet");
 addFinancialReport("cash-flow", "fundamental.cash-flow");
 addFinancialReport("cash-flow-quarterly", "fundamental.cash-flow-quarterly", "Period: q1/q2/q3/q4/latest");
+addFinancialReport("income-statement-hk", "fundamental.income-statement-hk", "Period: q1/h1/q3/h2/nsd/annual/latest");
+addFinancialReport("balance-sheet-hk", "fundamental.balance-sheet-hk", "Period: q1/h1/q3/h2/nsd/annual/latest");
+addFinancialReport("cash-flow-hk", "fundamental.cash-flow-hk", "Period: q1/h1/q3/h2/nsd/annual/latest");
 fundamental.command("main-business").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").addOption(new Option("--breakdown <type>", "Breakdown: product/industry/region").choices(["product", "industry", "region"]).default("product")).option("--period <type>", "Period: interim/annual", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
     const client = await createClient();
     await printData(await client.call("fundamental.main-business", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, breakdown: options.breakdown, periodList: maybeArray(options.period), fieldList: maybeArray(options.field) }), parseOutputFormat(options.format), options.output);
@@ -412,7 +415,7 @@ ai.command("hot-topic").option("--from <number>", "Starting offset", "0").option
         withCloseReading: options.withCloseReading === false ? undefined : true,
     }), parseOutputFormat(options.format), options.output);
 });
-ai.command("management-discuss-announcement").requiredOption("--report-date <date>", "Report date (yyyy-MM-dd, e.g. 2025-06-30)").requiredOption("--security-code <code>", "Security code (e.g. 000001.SZ)").addOption(new Option("--dimension <name>", "Discussion dimension").choices(["businessOperation", "financialPerformance", "developmentAndRisk"]).makeOptionMandatory()).option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+ai.command("management-discuss-announcement").requiredOption("--report-date <date>", "Report date (yyyy-MM-dd, e.g. 2025-06-30)").requiredOption("--security-code <code>", "Security code (e.g. 000001.SZ)").addOption(new Option("--dimension <name>", "Discussion dimension: businessOperation/financialPerformance/developmentAndRisk/all").choices(["businessOperation", "financialPerformance", "developmentAndRisk", "all"]).makeOptionMandatory()).option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
     const client = await createClient();
     await printData(await client.call("ai.management-discuss-announcement", {
         reportDate: options.reportDate,
@@ -499,7 +502,7 @@ vault.command("my-conference-download").requiredOption("--conference-id <id>").r
         resolveOutputPath: (result) => resolveTitle(client, result, "vault.my-conference.list", "conferenceId", options.conferenceId),
     });
 });
-vault.command("wechat-message-list").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").option("--start-time <datetime>").option("--end-time <datetime>").option("--keyword <text>").option("--wechat-group-id <id>", "WeChat group ID", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--category <name>", "Message type: text/image/documents/url", collectList, []).option("--tag <name>", "Tag: roadShow/research/strategyMeeting/meetingSummary/industryComment/companyComment/earningsReview", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+vault.command("wechat-message-list").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").option("--start-time <datetime>").option("--end-time <datetime>").option("--keyword <text>").option("--security <code>", "Security code (e.g. 000001.SZ)", collectList, []).option("--wechat-group-id <id>", "WeChat group ID", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--category <name>", "Message type: text/image/documents/url", collectList, []).option("--tag <name>", "Tag: roadShow/research/strategyMeeting/meetingSummary/industryComment/companyComment/earningsReview", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
     const client = await createClient();
     await printData(await client.call("vault.wechat-message.list", buildWechatMessageListBody(options)), parseOutputFormat(options.format), options.output);
 });
@@ -507,8 +510,42 @@ vault.command("wechat-chatroom-list").option("--from <number>", "Starting offset
     const client = await createClient();
     await printData(await client.call("vault.wechat-chatroom.list", buildWechatChatroomListBody(options)), parseOutputFormat(options.format), options.output);
 });
+vault.command("stock-pool-list").option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("vault.stock-pool.list", {}), parseOutputFormat(options.format), options.output);
+});
+vault.command("stock-pool-stocks").option("--pool-id <id>", "Pool ID; repeat for multiple; use 'all' for all pools", collectList, ["all"]).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("vault.stock-pool.stocks", { poolIdList: options.poolId }), parseOutputFormat(options.format), options.output);
+});
 program.addCommand(vault);
 program.addCommand(ai);
+const alternative = new Command("alternative").description("Alternative data APIs");
+alternative.command("edb-search").requiredOption("--keyword <text>", "Search keyword (e.g. '空调')").option("--limit <number>", "Max results (default: 100, max: 200)", "100").option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("alternative.edb-search", {
+        keyword: options.keyword,
+        limit: parseNumberOption(options.limit, "--limit", { integer: true, min: 1 }),
+    }), parseOutputFormat(options.format), options.output);
+});
+alternative.command("edb-data").option("--indicator-id <id>", "Indicator ID (repeat, max 10)", collectList, []).requiredOption("--start-date <date>", "Start date (yyyy-MM-dd)").requiredOption("--end-date <date>", "End date (yyyy-MM-dd)").option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    const raw = await client.call("alternative.edb-data", {
+        indicatorIdList: options.indicatorId,
+        startDate: options.startDate,
+        endDate: options.endDate,
+    });
+    let data = raw;
+    if (raw && Array.isArray(raw.fieldList) && Array.isArray(raw.dataList)) {
+        const list = raw.dataList.map((row) => raw.fieldList.reduce((acc, field, i) => {
+            acc[field] = row[i];
+            return acc;
+        }, {}));
+        data = { list, total: list.length };
+    }
+    await printData(data, parseOutputFormat(options.format), options.output);
+});
+program.addCommand(alternative);
 program.command("raw").description("Raw API calls").addCommand(new Command("call").argument("<endpointKey>").option("--body <json>").option("--query <key=value>", "Query string pair", collectKeyValue, {}).option("--format <format>", "Output format", "json").option("--output <path>").action(async (endpointKey, options) => {
     const endpoint = ENDPOINTS[endpointKey];
     if (!endpoint) {

package/dist/src/core/commandBodies.js

@@ -15,6 +15,7 @@ export function buildWechatMessageListBody(options) {
         startTime: options.startTime,
         endTime: options.endTime,
         keyword: options.keyword,
+        securityList: maybeArray(options.security),
         wechatGroupIdList: maybeArray(options.wechatGroupId),
         industryIdList: maybeArray(options.industry),
         categoryList: maybeArray(options.category),

package/dist/src/core/endpoints.js

@@ -246,35 +246,56 @@ export const ENDPOINTS = {
         method: "POST",
         path: "/application/open-fundamental/financial-report/income-statement/accumulated",
         kind: "json",
-        description: "Query income statement (accumulated)",
+        description: "Query A-share income statement (accumulated)",
     },
     "fundamental.income-statement-quarterly": {
         key: "fundamental.income-statement-quarterly",
         method: "POST",
         path: "/application/open-fundamental/financial-report/income-statement/quarterly",
         kind: "json",
-        description: "Query income statement (quarterly)",
+        description: "Query A-share income statement (quarterly)",
     },
     "fundamental.balance-sheet": {
         key: "fundamental.balance-sheet",
         method: "POST",
         path: "/application/open-fundamental/financial-report/balance-sheet/accumulated",
         kind: "json",
-        description: "Query balance sheet (accumulated)",
+        description: "Query A-share balance sheet (accumulated)",
     },
     "fundamental.cash-flow": {
         key: "fundamental.cash-flow",
         method: "POST",
         path: "/application/open-fundamental/financial-report/cash-flow-statement/accumulated",
         kind: "json",
-        description: "Query cash flow statement (accumulated)",
+        description: "Query A-share cash flow statement (accumulated)",
     },
     "fundamental.cash-flow-quarterly": {
         key: "fundamental.cash-flow-quarterly",
         method: "POST",
         path: "/application/open-fundamental/financial-report/cash-flow-statement/quarterly",
         kind: "json",
-        description: "Query cash flow statement (quarterly)",
+        description: "Query A-share cash flow statement (quarterly)",
+    },
+    "fundamental.income-statement-hk": {
+        key: "fundamental.income-statement-hk",
+        method: "POST",
+        path: "/application/open-fundamental/financial-report/income-statement/hk",
+        kind: "json",
+        description: "Query HK income statement (China GAAP)",
+    },
+    "fundamental.balance-sheet-hk": {
+        key: "fundamental.balance-sheet-hk",
+        method: "POST",
+        path: "/application/open-fundamental/financial-report/balance-sheet/hk",
+        kind: "json",
+        description: "Query HK balance sheet (China GAAP)",
+    },
+    "fundamental.cash-flow-hk": {
+        key: "fundamental.cash-flow-hk",
+        method: "POST",
+        path: "/application/open-fundamental/financial-report/cash-flow-statement/hk",
+        kind: "json",
+        description: "Query HK cash flow statement (China GAAP)",
     },
     "fundamental.main-business": {
         key: "fundamental.main-business",
@@ -473,4 +494,33 @@ export const ENDPOINTS = {
         kind: "json",
         description: "List WeChat group chatroom IDs",
     },
+    "vault.stock-pool.list": {
+        key: "vault.stock-pool.list",
+        method: "POST",
+        path: "/application/open-vault/stock-pool/getPoolList",
+        kind: "json",
+        description: "List user stock pool IDs and names",
+    },
+    "vault.stock-pool.stocks": {
+        key: "vault.stock-pool.stocks",
+        method: "POST",
+        path: "/application/open-vault/stock-pool/getStockList",
+        kind: "json",
+        description: "List securities in stock pool(s)",
+    },
+    // ─── alternative ───
+    "alternative.edb-search": {
+        key: "alternative.edb-search",
+        method: "POST",
+        path: "/application/open-alternative/EDB/search",
+        kind: "json",
+        description: "Search industry indicator list by keyword",
+    },
+    "alternative.edb-data": {
+        key: "alternative.edb-data",
+        method: "POST",
+        path: "/application/open-alternative/EDB/getData",
+        kind: "json",
+        description: "Get industry indicator time-series data by indicator ID list",
+    },
 };

package/dist/src/version.js

@@ -1,2 +1,2 @@
 // Auto-generated — DO NOT EDIT
-export const CLI_VERSION = "0.12.0";
+export const CLI_VERSION = "0.13.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gangtise-openapi-cli",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "CLI for Gangtise OpenAPI",
   "license": "MIT",
   "repository": {