@investoday/investoday-api 1.0.0

package/README.md

@@ -0,0 +1,42 @@
+# @investoday/investoday-api
+
+Official CLI for accessing InvestToday China market financial data.
+
+## Install
+
+```bash
+npm install -g @investoday/investoday-api
+```
+
+## API key
+
+Set your API key with the `INVESTODAY_API_KEY` environment variable:
+
+```bash
+export INVESTODAY_API_KEY="<your_key>"
+```
+
+Get an API key from:
+
+- https://data-api.investoday.net/login
+
+## Usage
+
+```bash
+investoday-api <endpoint> [key=value ...]
+investoday-api <endpoint> --method POST [key=value ...]
+```
+
+Examples:
+
+```bash
+investoday-api stock/basic-info stockCode=600519
+investoday-api search key=贵州茅台 type=11
+investoday-api fund/daily-quotes --method POST fundCode=000001 beginDate=2024-01-01 endDate=2024-12-31
+```
+
+## Notes
+
+- Only reads credentials from `INVESTODAY_API_KEY`
+- Only calls `https://data-api.investoday.net/data`
+- Prints the API response `data` field as formatted JSON

package/bin/investoday-api.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+const { main } = require("../lib/call-api");
+
+main(process.argv.slice(2));

package/lib/call-api.js

@@ -0,0 +1,162 @@
+const BASE_URL = "https://data-api.investoday.net/data";
+const REQUEST_TIMEOUT = 30_000;
+
+function exitWithError(message) {
+  process.stderr.write(`${message}\n`);
+  process.exit(1);
+}
+
+function loadApiKey() {
+  const envKey = (process.env.INVESTODAY_API_KEY || "").trim();
+  if (envKey) {
+    return envKey;
+  }
+
+  exitWithError("ERROR: Please set the INVESTODAY_API_KEY environment variable first.");
+}
+
+function parseArgs(argv) {
+  if (!argv.length) {
+    exitWithError(
+      "Usage: investoday-api <endpoint> [key=value ...] [--method GET|POST]\n" +
+      "Example: investoday-api stock/basic-info stockCode=600519"
+    );
+  }
+
+  const apiPath = argv[0].replace(/^\/+/, "");
+  let method = "GET";
+  const params = {};
+
+  let index = 1;
+  while (index < argv.length) {
+    const arg = argv[index];
+    if (arg === "--method") {
+      index += 1;
+      if (index >= argv.length) {
+        exitWithError("ERROR: --method requires GET or POST");
+      }
+
+      method = argv[index].toUpperCase();
+      if (method !== "GET" && method !== "POST") {
+        exitWithError(`ERROR: Unsupported HTTP method '${method}', only GET and POST are supported`);
+      }
+    } else if (!arg.includes("=")) {
+      exitWithError(`ERROR: Invalid argument '${arg}', expected key=value`);
+    } else {
+      const equalIndex = arg.indexOf("=");
+      const key = arg.slice(0, equalIndex);
+      const value = arg.slice(equalIndex + 1);
+
+      if (!key) {
+        exitWithError(`ERROR: Invalid argument '${arg}', key cannot be empty`);
+      }
+
+      if (Object.prototype.hasOwnProperty.call(params, key)) {
+        const existing = params[key];
+        params[key] = Array.isArray(existing) ? [...existing, value] : [existing, value];
+      } else {
+        params[key] = value;
+      }
+    }
+
+    index += 1;
+  }
+
+  return { apiPath, method, params };
+}
+
+function buildUrl(apiPath, params) {
+  let url = `${BASE_URL}/${apiPath}`;
+  if (!Object.keys(params).length) {
+    return url;
+  }
+
+  const searchParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    if (Array.isArray(value)) {
+      value.forEach((item) => searchParams.append(key, item));
+    } else {
+      searchParams.append(key, value);
+    }
+  }
+
+  return `${url}?${searchParams.toString()}`;
+}
+
+async function callApi(apiPath, method, params, apiKey) {
+  const headers = { apiKey };
+  const requestOptions = {
+    method,
+    headers,
+    signal: AbortSignal.timeout(REQUEST_TIMEOUT),
+  };
+
+  let url = `${BASE_URL}/${apiPath}`;
+  if (method === "POST") {
+    headers["Content-Type"] = "application/json";
+    requestOptions.body = JSON.stringify(params);
+  } else {
+    url = buildUrl(apiPath, params);
+  }
+
+  let response;
+  try {
+    response = await fetch(url, requestOptions);
+  } catch (error) {
+    if (error.name === "TimeoutError" || error.name === "AbortError") {
+      exitWithError(`ERROR: Request timed out after ${REQUEST_TIMEOUT / 1000}s: ${url}`);
+    }
+
+    let message = String(error.message || error);
+    if (apiKey && message.includes(apiKey)) {
+      message = message.replaceAll(apiKey, "***");
+    }
+    exitWithError(`ERROR: Request failed: ${message}`);
+  }
+
+  if (!response.ok) {
+    const body = await response.text().catch(() => "");
+    exitWithError(`ERROR: HTTP ${response.status}: ${url}\n${body.slice(0, 500)}`);
+  }
+
+  let result;
+  try {
+    result = await response.json();
+  } catch {
+    const body = await response.text().catch(() => "");
+    exitWithError(`ERROR: Response is not valid JSON\n${body.slice(0, 500)}`);
+  }
+
+  if (result.code !== 0) {
+    exitWithError(`ERROR: API returned error [${result.code}]: ${result.message || "Unknown error"}`);
+  }
+
+  if (result.data === undefined || result.data === null) {
+    exitWithError("ERROR: API response does not contain a data field");
+  }
+
+  process.stdout.write(`${JSON.stringify(result.data, null, 2)}\n`);
+}
+
+async function main(argv = process.argv.slice(2)) {
+  const { apiPath, method, params } = parseArgs(argv);
+  const apiKey = loadApiKey();
+  await callApi(apiPath, method, params, apiKey);
+}
+
+module.exports = {
+  BASE_URL,
+  REQUEST_TIMEOUT,
+  buildUrl,
+  callApi,
+  loadApiKey,
+  main,
+  parseArgs,
+};
+
+if (require.main === module) {
+  main().catch((error) => {
+    const message = error && error.message ? error.message : String(error);
+    exitWithError(`ERROR: ${message}`);
+  });
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@investoday/investoday-api",
+  "version": "1.0.0",
+  "description": "CLI for accessing InvestToday China market financial data via investoday-api.",
+  "license": "MIT",
+  "homepage": "https://github.com/investoday-data/investoday-api-skills",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/investoday-data/investoday-api-skills.git",
+    "directory": "package/investoday-api"
+  },
+  "bugs": {
+    "url": "https://github.com/investoday-data/investoday-api-skills/issues"
+  },
+  "type": "commonjs",
+  "main": "lib/call-api.js",
+  "bin": {
+    "investoday-api": "bin/investoday-api.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "README.md"
+  ],
+  "keywords": [
+    "investoday",
+    "finance",
+    "financial-data",
+    "china-market",
+    "a-share",
+    "hk-stock",
+    "fund",
+    "index",
+    "macro-economics",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}