@investoday/investoday-api 1.8.26 → 1.9.0

package/README.md

@@ -33,6 +33,27 @@ Get an API key from:
 
 - https://data-api.investoday.net/user/api-key
 
+## API base URL
+
+The default API base URL is:
+
+```text
+https://data-api.investoday.net/data
+```
+
+Temporarily override it with an environment variable:
+
+```bash
+INVESTODAY_API_BASE_URL="https://data-api.investoday.net/data" investoday-api list
+```
+
+Persist a custom value in the local config:
+
+```bash
+investoday-api config set-base-url "https://data-api.investoday.net/data"
+investoday-api config reset-base-url
+```
+
 ## Usage
 
 ```bash
@@ -41,6 +62,8 @@ investoday-api init
 investoday-api config status
 investoday-api config path
 investoday-api config remove
+investoday-api config set-base-url "https://data-api.investoday.net/data"
+investoday-api config reset-base-url
 investoday-api update status
 investoday-api update run
 investoday-api update enable

package/data/openapi.json

@@ -2029,7 +2029,7 @@
           "行业及关联成分股的最新实时日行情"
         ],
         "summary": "行业及关联成分股的最新实时日行情",
-        "description": "输入行业代码，获取该行业的最新整体行情（包括指数、涨跌幅、成交量、总市值、成分股数量、涨跌幅排名、领涨股等）以及所有关联成分股的实时行情明细（包括股票代码、名称、开盘价、当前价、涨跌幅、最高/最低价等），用于全面分析行业及其成分股的最新市场表现。",
+        "description": "通过行业代码（必填）查询对应行业及相关成分股的最新实时日行情数据，支持按响应字段指定排序规则、分页查询，返回行业整体行情信息（含价格、涨跌幅、成交量、近一周涨跌幅、总市值、行业内涨跌排名、涨跌家数统计、领涨股信息等）、成分股实时行情详情（含股票代码、名称、最新价、涨跌幅、开盘价、最高价、最低价等）及分页相关数据，可用于行业行情监测、成分股分析、市场热点追踪等场景。",
         "operationId": "get_industry_stock_realtime_quote",
         "parameters": [
           {
@@ -2039,7 +2039,59 @@
             "required": true,
             "schema": {
               "type": "string",
-              "example": "330000"
+              "example": "740000"
+            }
+          },
+          {
+            "name": "sortColumn",
+            "in": "query",
+            "description": "排序字段（响应字段）",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "example": "changeRatio"
+            }
+          },
+          {
+            "name": "order",
+            "in": "query",
+            "description": "排序方向",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "allOf": [
+                {
+                  "type": "string",
+                  "description": "asc代表正序;\ndesc 代表倒序",
+                  "enum": [
+                    "asc",
+                    "desc"
+                  ]
+                }
+              ],
+              "example": "desc"
+            }
+          },
+          {
+            "name": "page",
+            "in": "query",
+            "description": "页码",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "example": 1
+            }
+          },
+          {
+            "name": "pageSize",
+            "in": "query",
+            "description": "页长",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "example": 10
             }
           }
         ],
@@ -2072,9 +2124,10 @@
                       "example": -0.0121602
                     },
                     "volume": {
-                      "type": "string",
+                      "type": "integer",
+                      "format": "int32",
                       "description": "行业成交量",
-                      "example": "9547379"
+                      "example": 9547379
                     },
                     "changeRatio1W": {
                       "type": "number",
@@ -2381,10 +2434,20 @@
           {
             "name": "conceptType",
             "in": "query",
-            "description": "概念类型(jy-聚源、cls-财联社)\"",
+            "description": "概念类型",
             "required": true,
             "schema": {
               "type": "string",
+              "allOf": [
+                {
+                  "type": "string",
+                  "description": "jy代表聚源;\ncls代表财联社",
+                  "enum": [
+                    "jy",
+                    "cls"
+                  ]
+                }
+              ],
               "example": "jy"
             }
           },
@@ -2397,6 +2460,58 @@
               "type": "string",
               "example": "14060061"
             }
+          },
+          {
+            "name": "sortColumn",
+            "in": "query",
+            "description": "排序字段（响应字段）",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "example": "changeRatio"
+            }
+          },
+          {
+            "name": "order",
+            "in": "query",
+            "description": "排序方向",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "allOf": [
+                {
+                  "type": "string",
+                  "description": "asc代表正序;\ndesc 代表倒序",
+                  "enum": [
+                    "asc",
+                    "desc"
+                  ]
+                }
+              ],
+              "example": "desc"
+            }
+          },
+          {
+            "name": "page",
+            "in": "query",
+            "description": "页码",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "example": 1
+            }
+          },
+          {
+            "name": "pageSize",
+            "in": "query",
+            "description": "页长",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "example": 10
+            }
           }
         ],
         "responses": {

package/data/tree.json

@@ -3409,7 +3409,7 @@
                   "apiStatus": "release",
                   "groupId": 1031,
                   "remarks": null,
-                  "toolName": "get_industry_stock_realtime_quote",
+                  "toolName": "get_ind_stk_realtime_qt",
                   "toolId": "get_industry_stock_realtime_quote",
                   "apiPath": "industry-quote/stock-realtime",
                   "enabled": 1,

package/lib/call-api.js

@@ -6,11 +6,17 @@ const {
 } = require("./skill-installer");
 const {
   CONFIG_DIR_ENV,
+  API_BASE_URL_ENV,
+  DEFAULT_API_BASE_URL,
   getConfigDir,
   getCredentialsPath,
+  readConfig,
   readCredentials,
+  removeApiBaseUrl,
   removeCredentials,
+  resolveApiBaseUrl,
   resolveApiKey,
+  saveApiBaseUrl,
   saveCredentials,
 } = require("./config");
 const { version: PACKAGE_VERSION } = require("../package.json");
@@ -23,7 +29,7 @@ const {
   runUpdateCommand,
 } = require("./update");
 
-const BASE_URL = "https://data-api.investoday.net/data";
+const BASE_URL = DEFAULT_API_BASE_URL;
 const REQUEST_TIMEOUT = 30_000;
 const API_KEY_MANAGE_URL = "https://data-api.investoday.net/user/api-key";
 
@@ -68,7 +74,7 @@ function printHelp() {
     "investoday-api\n\n" +
     "用法:\n" +
     "  investoday-api init\n" +
-    "  investoday-api config status|path|remove\n" +
+    "  investoday-api config status|path|remove|set-base-url|reset-base-url\n" +
     "  investoday-api update run|status|enable|disable|register|unregister\n" +
     "  investoday-api skill list [--page <n>] [--page-size <n>] [--json]\n" +
     "  investoday-api skill search <keyword> [--page <n>] [--page-size <n>] [--json]\n" +
@@ -368,7 +374,11 @@ function runConfigCommand(args) {
       "用法:\n" +
       "  investoday-api config status\n" +
       "  investoday-api config path\n" +
-      "  investoday-api config remove\n\n" +
+      "  investoday-api config remove\n" +
+      "  investoday-api config set-base-url <url>\n" +
+      "  investoday-api config reset-base-url\n\n" +
+      `Base URL environment override: ${API_BASE_URL_ENV}\n` +
+      `Default Base URL: ${BASE_URL}\n\n` +
       `配置目录环境变量覆盖: \n`
     );
     return;
@@ -385,9 +395,34 @@ function runConfigCommand(args) {
     return;
   }
 
+  if (action === "set-base-url") {
+    const baseUrl = String(args[1] || "").trim();
+    if (!baseUrl) {
+      exitWithError("Error: config set-base-url requires a URL.");
+    }
+    if (args.length > 2) {
+      exitWithError("Error: config set-base-url accepts exactly one URL.");
+    }
+    try {
+      saveApiBaseUrl(baseUrl);
+    } catch (error) {
+      exitWithError(`Error: ${error.message}`);
+    }
+    process.stdout.write(`${resolveApiBaseUrl().baseUrl}\n`);
+    return;
+  }
+
+  if (action === "reset-base-url") {
+    removeApiBaseUrl();
+    process.stdout.write(`${resolveApiBaseUrl().baseUrl}\n`);
+    return;
+  }
+
   if (action === "status") {
     const localCredentials = readCredentials();
     const resourceApiKey = resolveApiKey();
+    const localConfig = readConfig() || {};
+    const apiBaseUrl = resolveApiBaseUrl();
     const localConfigured = Boolean(localCredentials);
     process.stdout.write(
       JSON.stringify({
@@ -399,6 +434,12 @@ function runConfigCommand(args) {
           source: resourceApiKey.source,
           localConfig: localCredentials && localCredentials.apiKey ? "configured" : "missing",
         },
+        baseUrl: {
+          value: apiBaseUrl.baseUrl,
+          source: apiBaseUrl.source,
+          env: API_BASE_URL_ENV,
+          localConfig: localConfig[API_BASE_URL_ENV] ? "configured" : "missing",
+        },
         configDir: getConfigDir(),
         configFile: getCredentialsPath(),
       }, null, 2) + "\n"
@@ -925,8 +966,9 @@ function resolveRequestEndpoint(apiPath, method = "") {
   return null;
 }
 
-function buildUrl(apiPath, params) {
-  let url = `${BASE_URL}/${apiPath}`;
+function buildUrl(apiPath, params, options = {}) {
+  const baseUrl = String(options.baseUrl || resolveApiBaseUrl().baseUrl).replace(/\/+$/g, "");
+  let url = `${baseUrl}/${apiPath}`;
   if (!Object.keys(params).length) {
     return url;
   }
@@ -1547,7 +1589,7 @@ async function callApi(apiPath, method, params, apiKey, options = {}) {
     signal: AbortSignal.timeout(REQUEST_TIMEOUT),
   };
 
-  let url = `${BASE_URL}/${apiPath}`;
+  let url = buildUrl(apiPath, {});
   if (method === "POST") {
     const { queryParams, bodyParams } = splitPostParams(params, options.endpoint, options.bodyJson);
     url = buildUrl(apiPath, queryParams);

package/lib/config.js

@@ -4,6 +4,8 @@ const path = require("node:path");
 
 const CONFIG_DIR_ENV = "INVESTODAY_API_CONFIG_DIR";
 const API_KEY_ENV = "INVESTODAY_API_KEY";
+const API_BASE_URL_ENV = "INVESTODAY_API_BASE_URL";
+const DEFAULT_API_BASE_URL = "https://data-api.investoday.net/data";
 const LEGACY_SUB_API_KEY_ENV = "SUB_INVESTODAY_API_KEY";
 const CONFIG_FILE = "investoday-api.config.json";
 const LEGACY_CREDENTIALS_FILE = "credentials.enc";
@@ -52,6 +54,31 @@ function saveConfig(config, env = process.env) {
   atomicWriteFile(getCredentialsPath(env), `${JSON.stringify(config || {}, null, 2)}\n`);
 }
 
+function normalizeApiBaseUrl(value) {
+  const trimmed = String(value || "").trim();
+  if (!trimmed) {
+    throw new Error(`${API_BASE_URL_ENV} cannot be empty`);
+  }
+
+  let parsed;
+  const normalized = trimmed.replace(/\/+$/g, "");
+  try {
+    parsed = new URL(normalized);
+  } catch {
+    throw new Error(`${API_BASE_URL_ENV} must be a valid URL`);
+  }
+
+  if (!["http:", "https:"].includes(parsed.protocol)) {
+    throw new Error(`${API_BASE_URL_ENV} must use http or https`);
+  }
+
+  if (parsed.search || parsed.hash) {
+    throw new Error(`${API_BASE_URL_ENV} must not include query or hash`);
+  }
+
+  return normalized;
+}
+
 function removeLegacyCredentials(env = process.env) {
   for (const filePath of [getLegacyCredentialsPath(env), getLegacyKeyPath(env)]) {
     if (fs.existsSync(filePath)) {
@@ -76,6 +103,14 @@ function saveCredentials(apiKey, env = process.env) {
   removeLegacyCredentials(env);
 }
 
+function saveApiBaseUrl(baseUrl, env = process.env) {
+  const existing = readConfig(env) || {};
+  saveConfig({
+    ...existing,
+    [API_BASE_URL_ENV]: normalizeApiBaseUrl(baseUrl),
+  }, env);
+}
+
 function readConfig(env = process.env) {
   const configPath = getCredentialsPath(env);
   if (!fs.existsSync(configPath)) {
@@ -111,6 +146,15 @@ function removeCredentials(env = process.env) {
   removeLegacyCredentials(env);
 }
 
+function removeApiBaseUrl(env = process.env) {
+  const existing = readConfig(env);
+  if (!existing || !Object.prototype.hasOwnProperty.call(existing, API_BASE_URL_ENV)) {
+    return;
+  }
+  delete existing[API_BASE_URL_ENV];
+  saveConfig(existing, env);
+}
+
 function resolveApiKey(env = process.env) {
   const envKey = String(env[API_KEY_ENV] || "").trim();
   if (envKey) {
@@ -125,11 +169,28 @@ function resolveApiKey(env = process.env) {
   return { apiKey: "", source: "missing" };
 }
 
+function resolveApiBaseUrl(env = process.env) {
+  const envBaseUrl = String(env[API_BASE_URL_ENV] || "").trim();
+  if (envBaseUrl) {
+    return { baseUrl: normalizeApiBaseUrl(envBaseUrl), source: "env" };
+  }
+
+  const config = readConfig(env);
+  const configBaseUrl = String(config && config[API_BASE_URL_ENV] || "").trim();
+  if (configBaseUrl) {
+    return { baseUrl: normalizeApiBaseUrl(configBaseUrl), source: "config" };
+  }
+
+  return { baseUrl: DEFAULT_API_BASE_URL, source: "default" };
+}
+
 module.exports = {
   API_KEY_ENV,
+  API_BASE_URL_ENV,
   CONFIG_FILE,
   CONFIG_DIR_ENV,
   CREDENTIALS_FILE: CONFIG_FILE,
+  DEFAULT_API_BASE_URL,
   LEGACY_CREDENTIALS_FILE,
   LEGACY_KEY_FILE,
   getConfigDir,
@@ -139,8 +200,12 @@ module.exports = {
   removeLegacyCredentials,
   readConfig,
   readCredentials,
+  normalizeApiBaseUrl,
+  removeApiBaseUrl,
   removeCredentials,
   resolveApiKey,
+  resolveApiBaseUrl,
+  saveApiBaseUrl,
   saveConfig,
   saveCredentials,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@investoday/investoday-api",
-  "version": "1.8.26",
+  "version": "1.9.0",
   "description": "CLI for accessing InvestToday China market financial data via investoday-api.",
   "license": "MIT",
   "homepage": "https://github.com/investoday-data/investoday-finance-data",